Cloudflare Infrastructure Naming & Orchestration Proposal

Neutrino (meta-platform)
└── Platform          ← Client's top-level environment
    └── Tenant        ← Business unit, team, or customer
        └── Sub-Tenant (optional)  ← Nested isolation within a tenant
            └── Service           ← Cloudflare resource (Worker, Pages, D1, R2, KV, Queue)
                └── Environment   ← dev / stg / prod

import { customAlphabet } from 'nanoid';

// Cloudflare-safe NanoID: lowercase alphanumeric only
const nanoid = customAlphabet('abcdefghijklmnopqrstuvwxyz0123456789', 10);

// Usage
const platformId = nanoid(); // e.g. "k3m9p2xw7q"
const tenantId   = nanoid(); // e.g. "r8n4t6y1z5"

{platform-id}-{stack-id}-{service}[-resourceType][-stg]

nno-{nno-platform-id}-{service}[-stg]

nno-k3m9p2xw7q-registry
nno-k3m9p2xw7q-registry-stg
nno-k3m9p2xw7q-iam
nno-k3m9p2xw7q-billing

nno-{platformId}-{service}-db[-stg]

nno-k3m9p2xw7q-billing-db
nno-k3m9p2xw7q-billing-db-stg

nno-k3m9p2xw7q-registry-db
nno-k3m9p2xw7q-registry-db-stg

{platformId}-{stackId}-{service}-db[-stg]

k3m9p2xw7q-default-auth-db
k3m9p2xw7q-default-auth-db-stg

Format:  {10}-{10}-{8}-{4}
Chars:    10 + 1 + 10 + 1 + 8 + 1 + 4 = 35 chars

Format (short service + env):  {10}-{10}-{3}-{3}
Chars:    10 + 1 + 10 + 1 + 3 + 1 + 3 = 29 chars

Platform:    nno (Neutrino meta-platform)
Platform ID: nno-k3m9p2xw7q

Resources (production — no suffix):
  nno-k3m9p2xw7q-registry        ← Core registry Worker
  nno-k3m9p2xw7q-registry-db     ← Core registry D1 database
  nno-k3m9p2xw7q-iam             ← IAM service Worker
  nno-k3m9p2xw7q-iam-db          ← IAM D1 database
  nno-k3m9p2xw7q-billing         ← Billing service Worker
  nno-k3m9p2xw7q-billing-db      ← Billing D1 database
  nno-k3m9p2xw7q-console         ← Neutrino console (Pages)

Resources (staging — -stg suffix):
  nno-k3m9p2xw7q-registry-stg
  nno-k3m9p2xw7q-registry-db-stg

Platform ID: k3m9p2xw7q  (AcmeCorp)

Default stack (auto-created, auth always lives here):
  k3m9p2xw7q-default-auth           ← Auth Worker (prod)
  k3m9p2xw7q-default-auth-db        ← Auth D1 (prod)
  k3m9p2xw7q-default-auth-stg       ← Auth Worker (staging)
  k3m9p2xw7q-default-auth-db-stg    ← Auth D1 (staging)

Stack x7y8z9w0q1 (e.g. "Marketing"):
  k3m9p2xw7q-x7y8z9w0q1-dashboard           ← Pages project (prod)
  k3m9p2xw7q-x7y8z9w0q1-dashboard-api       ← API Worker (prod)
  k3m9p2xw7q-x7y8z9w0q1-db                  ← Shared D1 (prod)
  k3m9p2xw7q-x7y8z9w0q1-storage             ← Shared R2 (prod)
  k3m9p2xw7q-x7y8z9w0q1-dashboard-stg       ← Pages project (staging)

{platformId}-{stackId}-{service}[-resourceType][-stg]

import {
  generateId,
  buildResourceName,
  buildNnoResourceName,
  buildLegacyResourceName,
  parseResourceName,
  parseNnoResourceName,
  validateResourceName,
  validateId,
} from '@neutrino-io/core/naming'

import type { Environment, ValidationResult } from '@neutrino-io/core';

// Environment union (from packages/core/src/types/index.ts)
export type Environment = 'dev' | 'stg' | 'prod';

// Parts for a client platform resource name
export interface ResourceNameParts {
  platformId: string;
  stackId: string;           // was entityId in legacy format
  service: string;
  staging?: boolean;         // true = -stg suffix; omit or false = production (no suffix)
  resourceType?: 'db' | 'storage' | 'kv' | 'queue';
}

// Parts for a Neutrino NNO-level resource name
export interface NnoResourceNameParts {
  platformId: string;
  service: string;
  staging?: boolean;         // true = -stg suffix; omit or false = production (no suffix)
  resourceType?: 'db' | 'storage' | 'kv' | 'queue';
}

// Returned by parseResourceName (distinct from ResourceNameParts)
export interface ParsedResourceName {
  platformId: string;
  stackId: string;
  service: string;
  resourceType?: string;
  isStaging: boolean;
}

// Returned by parseNnoResourceName (distinct from NnoResourceNameParts)
export interface ParsedNnoResourceName {
  platformId: string;
  service: string;
  resourceType?: string;
  isStaging: boolean;
}

/** @deprecated Use ResourceNameParts with stackId instead */
export interface LegacyResourceNameParts {
  platformId: string;
  entityId: string;
  service: string;
  environment: Environment;
}

import { generateId, buildResourceName, buildNnoResourceName } from '@neutrino-io/core/naming';

// Generate a new platform ID
const platformId = generateId(); // e.g. 'k3m9p2xw7q'

// Build a client resource name (production — no suffix)
const dbName = buildResourceName({
  platformId: 'k3m9p2xw7q',
  stackId:    'default',
  service:    'auth',
  resourceType: 'db',
});
// => 'k3m9p2xw7q-default-auth-db'

// Build a client resource name (staging — -stg suffix)
const dbNameStg = buildResourceName({
  platformId: 'k3m9p2xw7q',
  stackId:    'default',
  service:    'auth',
  resourceType: 'db',
  staging:    true,
});
// => 'k3m9p2xw7q-default-auth-db-stg'

// Build an NNO-level resource name (production)
const registryDb = buildNnoResourceName({
  platformId:   'k3m9p2xw7q',
  service:      'registry',
  resourceType: 'db',
});
// => 'nno-k3m9p2xw7q-registry-db'

// Build an NNO-level resource name (staging)
const registryDbStg = buildNnoResourceName({
  platformId:   'k3m9p2xw7q',
  service:      'registry',
  resourceType: 'db',
  staging:      true,
});
// => 'nno-k3m9p2xw7q-registry-db-stg'

# ============================================================================
# Neutrino Registry Service
# Platform: Neutrino Meta-Platform (nno)
# Platform ID: k3m9p2xw7q  (generated once, stored permanently)
# Format: nno-{platformId}-{service}-{env}
# ============================================================================

name = "nno-k3m9p2xw7q-registry"
main = "src/index.ts"
compatibility_date = "2024-09-13"
compatibility_flags = ["nodejs_compat"]

[[d1_databases]]
binding = "DB"
database_name = "nno-k3m9p2xw7q-registry-db"
database_id = "local-dev-db"
migrations_dir = "migrations"

[vars]
PLATFORM_ID = "k3m9p2xw7q"
SERVICE_NAME = "registry"
ENVIRONMENT = "prod"

[env.stg]
name = "nno-k3m9p2xw7q-registry-stg"

[[env.stg.d1_databases]]
binding = "DB"
database_name = "nno-k3m9p2xw7q-registry-db-stg"
database_id = "REPLACE_WITH_REAL_ID"

[env.stg.vars]
PLATFORM_ID = "k3m9p2xw7q"
SERVICE_NAME = "registry"
ENVIRONMENT = "stg"

# Generated by Neutrino Orchestration Service
# Platform: k3m9p2xw7q | Stack: default | Service: auth

name = "k3m9p2xw7q-default-auth"
main = "src/index.ts"
compatibility_date = "2024-09-13"

[env.stg]
name = "k3m9p2xw7q-default-auth-stg"