typekro 0.5.0 → 0.8.0

package/dist/factories/webapp/compositions/web-app-with-processing.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Full-Stack Web Application with Background Processing
+ *
+ * Deploys a complete application stack:
+ * 1. **PostgreSQL** (via CNPG) — cluster + PgBouncer pooler
+ * 2. **Valkey** cache cluster
+ * 3. **Inngest** workflow engine (with external DB/cache, not bundled)
+ * 4. **Application** Deployment + Service
+ *
+ * All connection strings are automatically wired into the app's environment:
+ * - `DATABASE_URL` — points to the PgBouncer pooler
+ * - `VALKEY_URL` / `REDIS_URL` — points to the Valkey service
+ * - `INNGEST_BASE_URL` — points to the Inngest server
+ * - `INNGEST_EVENT_KEY` / `INNGEST_SIGNING_KEY` — from config
+ *
+ * Resource dependencies are expressed through proxy references:
+ * - Inngest references `cache.metadata.name` for the redis URI → deploys after Valkey
+ * - Inngest references `database.status.writeService` for the postgres URI → deploys after CNPG
+ * - App references service names derived from resource names → deploys after all infra
+ *
+ * @example
+ * ```typescript
+ * import { webAppWithProcessing } from 'typekro/webapp';
+ *
+ * const factory = webAppWithProcessing.factory('kro', {
+ *   namespace: 'production',
+ *   waitForReady: true,
+ * });
+ *
+ * await factory.deploy({
+ *   name: 'my-app',
+ *   namespace: 'production',
+ *   app: {
+ *     image: 'my-app:latest',
+ *     port: 3000,
+ *     replicas: 2,
+ *     env: {
+ *       NODE_ENV: 'production',
+ *     },
+ *   },
+ *   database: {
+ *     instances: 3,
+ *     storageSize: '50Gi',
+ *     storageClass: 'gp3',
+ *     database: 'myapp',
+ *   },
+ *   cache: { shards: 3, replicas: 1 },
+ *   processing: {
+ *     eventKey: 'deadbeef0123456789abcdef01234567',
+ *     signingKey: 'deadbeef0123456789abcdef0123456789abcdef0123456789abcdef01234567',
+ *     sdkUrl: ['http://my-app:3000/api/inngest'],
+ *   },
+ * });
+ * ```
+ */
+export declare const webAppWithProcessing: import("../../../index.js").CallableComposition<{
+    name: string;
+    app: {
+        image: string;
+        port?: number;
+        replicas?: number;
+        env?: Record<string, string>;
+    };
+    database: {
+        storageSize: string;
+        instances?: number;
+        storageClass?: string;
+        database?: string;
+        owner?: string;
+    };
+    processing: {
+        eventKey: string;
+        signingKey: string;
+        sdkUrl?: string[];
+        replicas?: number;
+    };
+    namespace?: string;
+    cache?: {
+        shards?: number;
+        replicas?: number;
+        volumePermissions?: boolean;
+        storageSize?: string;
+    };
+}, {
+    ready: boolean;
+    databaseUrl: string;
+    cacheUrl: string;
+    inngestUrl: string;
+    appUrl: string;
+    components: {
+        app: boolean;
+        database: boolean;
+        cache: boolean;
+        inngest: boolean;
+    };
+}>;
+//# sourceMappingURL=web-app-with-processing.d.ts.map

package/dist/factories/webapp/compositions/web-app-with-processing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-app-with-processing.d.ts","sourceRoot":"","sources":["../../../../src/factories/webapp/compositions/web-app-with-processing.ts"],"names":[],"mappings":"AAYA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgLhC,CAAC"}

package/dist/factories/webapp/compositions/web-app-with-processing.js

@@ -0,0 +1,220 @@
+import { kubernetesComposition } from '../../../core/composition/imperative.js';
+import { cluster } from '../../cnpg/resources/cluster.js';
+import { pooler } from '../../cnpg/resources/pooler.js';
+import { inngestBootstrap } from '../../inngest/compositions/inngest-bootstrap.js';
+import { simple } from '../../simple/index.js';
+import { valkey } from '../../valkey/resources/valkey.js';
+import { WebAppWithProcessingConfigSchema, WebAppWithProcessingStatusSchema, } from '../types.js';
+/**
+ * Full-Stack Web Application with Background Processing
+ *
+ * Deploys a complete application stack:
+ * 1. **PostgreSQL** (via CNPG) — cluster + PgBouncer pooler
+ * 2. **Valkey** cache cluster
+ * 3. **Inngest** workflow engine (with external DB/cache, not bundled)
+ * 4. **Application** Deployment + Service
+ *
+ * All connection strings are automatically wired into the app's environment:
+ * - `DATABASE_URL` — points to the PgBouncer pooler
+ * - `VALKEY_URL` / `REDIS_URL` — points to the Valkey service
+ * - `INNGEST_BASE_URL` — points to the Inngest server
+ * - `INNGEST_EVENT_KEY` / `INNGEST_SIGNING_KEY` — from config
+ *
+ * Resource dependencies are expressed through proxy references:
+ * - Inngest references `cache.metadata.name` for the redis URI → deploys after Valkey
+ * - Inngest references `database.status.writeService` for the postgres URI → deploys after CNPG
+ * - App references service names derived from resource names → deploys after all infra
+ *
+ * @example
+ * ```typescript
+ * import { webAppWithProcessing } from 'typekro/webapp';
+ *
+ * const factory = webAppWithProcessing.factory('kro', {
+ *   namespace: 'production',
+ *   waitForReady: true,
+ * });
+ *
+ * await factory.deploy({
+ *   name: 'my-app',
+ *   namespace: 'production',
+ *   app: {
+ *     image: 'my-app:latest',
+ *     port: 3000,
+ *     replicas: 2,
+ *     env: {
+ *       NODE_ENV: 'production',
+ *     },
+ *   },
+ *   database: {
+ *     instances: 3,
+ *     storageSize: '50Gi',
+ *     storageClass: 'gp3',
+ *     database: 'myapp',
+ *   },
+ *   cache: { shards: 3, replicas: 1 },
+ *   processing: {
+ *     eventKey: 'deadbeef0123456789abcdef01234567',
+ *     signingKey: 'deadbeef0123456789abcdef0123456789abcdef0123456789abcdef01234567',
+ *     sdkUrl: ['http://my-app:3000/api/inngest'],
+ *   },
+ * });
+ * ```
+ */
+export const webAppWithProcessing = kubernetesComposition({
+    name: 'web-app-with-processing',
+    kind: 'WebAppWithProcessing',
+    spec: WebAppWithProcessingConfigSchema,
+    status: WebAppWithProcessingStatusSchema,
+}, (spec) => {
+    const ns = spec.namespace ?? 'default';
+    const appPort = spec.app.port ?? 3000;
+    const appReplicas = spec.app.replicas ?? 1;
+    const inngestReplicas = spec.processing.replicas ?? 1;
+    const dbName = spec.database.database ?? spec.name;
+    const dbOwner = spec.database.owner ?? 'app';
+    // ── PostgreSQL (CNPG) ──────────────────────────────────────────────
+    const database = cluster({
+        name: `${spec.name}-db`,
+        namespace: ns,
+        spec: {
+            instances: spec.database.instances,
+            storage: {
+                size: spec.database.storageSize,
+                ...(spec.database.storageClass ? { storageClass: spec.database.storageClass } : {}),
+            },
+            bootstrap: {
+                initdb: { database: dbName, owner: dbOwner },
+            },
+        },
+        id: 'database',
+    });
+    const dbPooler = pooler({
+        name: `${spec.name}-db-pooler`,
+        namespace: ns,
+        spec: {
+            cluster: { name: `${spec.name}-db` },
+            type: 'rw',
+            pgbouncer: { poolMode: 'transaction' },
+        },
+        id: 'dbPooler',
+    });
+    // ── Valkey Cache ────────────────────────────────────────────────────
+    const cache = valkey({
+        name: `${spec.name}-cache`,
+        namespace: ns,
+        spec: {
+            volumePermissions: spec.cache?.volumePermissions ?? true,
+            anonymousAuth: true,
+            ...(spec.cache?.shards != null ? { shards: spec.cache.shards } : {}),
+            ...(spec.cache?.replicas != null ? { replicas: spec.cache.replicas } : {}),
+            storage: {
+                spec: {
+                    accessModes: ['ReadWriteOnce'],
+                    resources: { requests: { storage: spec.cache?.storageSize ?? '1Gi' } },
+                },
+            },
+        },
+        id: 'cache',
+    });
+    // The Valkey operator creates a client Service for each Valkey CR, but KRO's
+    // applyset pruning deletes Services it doesn't manage. Declare the cache
+    // Service explicitly so KRO includes it in its applyset and doesn't prune it.
+    simple.Service({
+        name: `${spec.name}-cache`,
+        namespace: ns,
+        selector: {
+            'app.kubernetes.io/name': 'valkey',
+            'app.kubernetes.io/instance': `${spec.name}-cache`,
+        },
+        ports: [{ port: 6379, targetPort: 6379 }],
+        id: 'cacheService',
+    });
+    // ── Database credentials ──────────────────────────────────────────────
+    // CNPG auto-generates a Secret named {cluster}-{owner} during bootstrap.
+    // Validated against CNPG v1.25 (cloudnative-pg chart 0.23.0).
+    // The name is deterministic — no need for an externalRef which would block
+    // KRO reconciliation (KRO waits for external refs to exist before creating
+    // dependent resources, but the Secret only exists after CNPG bootstraps).
+    const dbSecretName = `${spec.name}-db-${dbOwner}`;
+    // ── Inngest (with external DB + cache) ──────────────────────────────
+    // database.status.writeService creates an implicit deployment dependency:
+    // the dependency resolver detects the reference and adds a DAG edge,
+    // ensuring the database is ready BEFORE Inngest deploys. The actual
+    // postgres credentials are injected via the CNPG Secret (secretKeyRef below).
+    const inngest = inngestBootstrap({
+        name: `${spec.name}-inngest`,
+        namespace: ns,
+        inngest: {
+            eventKey: spec.processing.eventKey,
+            signingKey: spec.processing.signingKey,
+            postgres: { uri: `postgresql://${dbOwner}@${database.status.writeService}:5432/${dbName}` },
+            redis: { uri: `redis://${cache.metadata.name}:6379` },
+            sdkUrl: spec.processing.sdkUrl,
+        },
+        postgresql: { enabled: false },
+        redis: { enabled: false },
+        replicaCount: inngestReplicas,
+        // Deploy Inngest pods in the same namespace as CNPG (for Secret access)
+        // and inject the real postgres URI from the CNPG Secret via secretKeyRef.
+        customValues: {
+            namespace: { create: false, name: ns },
+            inngest: {
+                extraEnv: [
+                    {
+                        name: 'INNGEST_POSTGRES_URI',
+                        valueFrom: {
+                            secretKeyRef: {
+                                name: dbSecretName,
+                                key: 'uri',
+                            },
+                        },
+                    },
+                ],
+            },
+        },
+    });
+    // ── Application ─────────────────────────────────────────────────────
+    const appEnv = {
+        DATABASE_URL: `postgresql://${dbOwner}@${dbPooler.metadata.name}:5432/${dbName}`,
+        VALKEY_URL: `redis://${cache.metadata.name}:6379`,
+        REDIS_URL: `redis://${cache.metadata.name}:6379`,
+        INNGEST_BASE_URL: `http://${spec.name}-inngest:8288`,
+        INNGEST_EVENT_KEY: spec.processing.eventKey,
+        INNGEST_SIGNING_KEY: spec.processing.signingKey,
+        ...spec.app.env,
+    };
+    const app = simple.Deployment({
+        name: spec.name,
+        namespace: ns,
+        image: spec.app.image,
+        replicas: appReplicas,
+        ports: [{ containerPort: appPort }],
+        env: appEnv,
+        id: 'app',
+    });
+    simple.Service({
+        name: spec.name,
+        namespace: ns,
+        selector: { app: spec.name },
+        ports: [{ port: appPort, targetPort: appPort }],
+        id: 'appService',
+    });
+    // ── Status ──────────────────────────────────────────────────────────
+    return {
+        ready: app.status.readyReplicas >= appReplicas &&
+            database.status.readyInstances >= (spec.database.instances ?? 1) &&
+            cache.status.ready &&
+            inngest.status.ready,
+        databaseUrl: `postgresql://${dbOwner}@${dbPooler.metadata.name}:5432/${dbName}`,
+        cacheUrl: `redis://${cache.metadata.name}:6379`,
+        inngestUrl: `http://${spec.name}-inngest:8288`,
+        appUrl: `http://${spec.name}:${appPort}`,
+        components: {
+            app: app.status.readyReplicas >= appReplicas,
+            database: database.status.readyInstances >= (spec.database.instances ?? 1),
+            cache: cache.status.ready,
+            inngest: inngest.status.ready,
+        },
+    };
+});
+//# sourceMappingURL=web-app-with-processing.js.map

package/dist/factories/webapp/compositions/web-app-with-processing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-app-with-processing.js","sourceRoot":"","sources":["../../../../src/factories/webapp/compositions/web-app-with-processing.ts"],"names":[],"mappings":"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"}

package/dist/factories/webapp/index.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Web Application Compositions for TypeKro
+ *
+ * Higher-level compositions that wire together databases, caches,
+ * workflow engines, and application deployments with automatic
+ * environment variable injection.
+ *
+ * ## Compositions
+ * - `webAppWithProcessing` — Full-stack: App + CNPG PostgreSQL + Valkey + Inngest
+ *
+ * All connection URLs (DATABASE_URL, VALKEY_URL, INNGEST_BASE_URL) are
+ * automatically injected into the application's environment. The status
+ * exposes these URLs for debugging or wiring additional services.
+ *
+ * ## Prerequisites
+ * The following operators must be installed in the cluster:
+ * - CloudNativePG operator (`typekro/cnpg` bootstrap)
+ * - Hyperspike Valkey operator (`typekro/valkey` bootstrap)
+ * - Flux CD (for Inngest HelmRelease)
+ *
+ * @example
+ * ```typescript
+ * import { webAppWithProcessing } from 'typekro/webapp';
+ *
+ * const factory = webAppWithProcessing.factory('kro', {
+ *   namespace: 'production',
+ * });
+ *
+ * const instance = await factory.deploy({
+ *   name: 'my-app',
+ *   namespace: 'production',
+ *   app: { image: 'my-app:latest', port: 3000 },
+ *   database: { storageSize: '50Gi', database: 'mydb' },
+ *   processing: {
+ *     eventKey: 'deadbeef...',
+ *     signingKey: 'deadbeef...',
+ *   },
+ * });
+ *
+ * // Connection details available on status
+ * console.log(instance.status.databaseUrl);
+ * console.log(instance.status.cacheUrl);
+ * console.log(instance.status.inngestUrl);
+ * ```
+ *
+ * @see https://typekro.run/api/cnpg/ — PostgreSQL integration
+ * @see https://typekro.run/api/valkey/ — Valkey integration
+ * @see https://typekro.run/api/inngest/ — Inngest integration
+ * @module
+ */
+export * from './compositions/index.js';
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/factories/webapp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/factories/webapp/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,cAAc,yBAAyB,CAAC;AACxC,cAAc,YAAY,CAAC"}

package/dist/factories/webapp/index.js

@@ -0,0 +1,53 @@
+/**
+ * Web Application Compositions for TypeKro
+ *
+ * Higher-level compositions that wire together databases, caches,
+ * workflow engines, and application deployments with automatic
+ * environment variable injection.
+ *
+ * ## Compositions
+ * - `webAppWithProcessing` — Full-stack: App + CNPG PostgreSQL + Valkey + Inngest
+ *
+ * All connection URLs (DATABASE_URL, VALKEY_URL, INNGEST_BASE_URL) are
+ * automatically injected into the application's environment. The status
+ * exposes these URLs for debugging or wiring additional services.
+ *
+ * ## Prerequisites
+ * The following operators must be installed in the cluster:
+ * - CloudNativePG operator (`typekro/cnpg` bootstrap)
+ * - Hyperspike Valkey operator (`typekro/valkey` bootstrap)
+ * - Flux CD (for Inngest HelmRelease)
+ *
+ * @example
+ * ```typescript
+ * import { webAppWithProcessing } from 'typekro/webapp';
+ *
+ * const factory = webAppWithProcessing.factory('kro', {
+ *   namespace: 'production',
+ * });
+ *
+ * const instance = await factory.deploy({
+ *   name: 'my-app',
+ *   namespace: 'production',
+ *   app: { image: 'my-app:latest', port: 3000 },
+ *   database: { storageSize: '50Gi', database: 'mydb' },
+ *   processing: {
+ *     eventKey: 'deadbeef...',
+ *     signingKey: 'deadbeef...',
+ *   },
+ * });
+ *
+ * // Connection details available on status
+ * console.log(instance.status.databaseUrl);
+ * console.log(instance.status.cacheUrl);
+ * console.log(instance.status.inngestUrl);
+ * ```
+ *
+ * @see https://typekro.run/api/cnpg/ — PostgreSQL integration
+ * @see https://typekro.run/api/valkey/ — Valkey integration
+ * @see https://typekro.run/api/inngest/ — Inngest integration
+ * @module
+ */
+export * from './compositions/index.js';
+export * from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/factories/webapp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/factories/webapp/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,cAAc,yBAAyB,CAAC;AACxC,cAAc,YAAY,CAAC"}

package/dist/factories/webapp/types.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Web Application Composition Types
+ *
+ * Higher-level compositions that wire together CNPG, Valkey, Inngest,
+ * and application deployments with automatic environment variable injection.
+ *
+ * All config types are inferred from ArkType schemas — the schema is the
+ * single source of truth. Status types remain as interfaces since they
+ * represent k8s API responses, not validated input.
+ *
+ * @module
+ */
+/**
+ * Full-stack web application with background processing.
+ *
+ * Deploys: App + CNPG PostgreSQL + Valkey cache + Inngest workflow engine.
+ * All connection strings are automatically wired into the app's environment.
+ */
+export declare const WebAppWithProcessingConfigSchema: import("arktype/internal/methods/object.ts").ObjectType<{
+    name: string;
+    app: {
+        image: string;
+        port?: number;
+        replicas?: number;
+        env?: Record<string, string>;
+    };
+    database: {
+        storageSize: string;
+        instances?: number;
+        storageClass?: string;
+        database?: string;
+        owner?: string;
+    };
+    processing: {
+        eventKey: string;
+        signingKey: string;
+        sdkUrl?: string[];
+        replicas?: number;
+    };
+    namespace?: string;
+    cache?: {
+        shards?: number;
+        replicas?: number;
+        volumePermissions?: boolean;
+        storageSize?: string;
+    };
+}, {}>;
+/** Inferred config type — no separate interface needed. */
+export type WebAppWithProcessingConfig = typeof WebAppWithProcessingConfigSchema.infer;
+/**
+ * Status schema for the full-stack web application deployment.
+ * Exposes connection URLs and readiness for each component.
+ */
+export declare const WebAppWithProcessingStatusSchema: import("arktype/internal/methods/object.ts").ObjectType<{
+    ready: boolean;
+    databaseUrl: string;
+    cacheUrl: string;
+    inngestUrl: string;
+    appUrl: string;
+    components: {
+        app: boolean;
+        database: boolean;
+        cache: boolean;
+        inngest: boolean;
+    };
+}, {}>;
+/** Inferred status type. */
+export type WebAppWithProcessingStatus = typeof WebAppWithProcessingStatusSchema.infer;
+//# sourceMappingURL=types.d.ts.map

package/dist/factories/webapp/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/factories/webapp/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAQH;;;;;GAKG;AACH,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAmD3C,CAAC;AAEH,2DAA2D;AAC3D,MAAM,MAAM,0BAA0B,GAAG,OAAO,gCAAgC,CAAC,KAAK,CAAC;AAEvF;;;GAGG;AACH,eAAO,MAAM,gCAAgC;;;;;;;;;;;;MAY3C,CAAC;AAEH,4BAA4B;AAC5B,MAAM,MAAM,0BAA0B,GAAG,OAAO,gCAAgC,CAAC,KAAK,CAAC"}

package/dist/factories/webapp/types.js

@@ -0,0 +1,92 @@
+/**
+ * Web Application Composition Types
+ *
+ * Higher-level compositions that wire together CNPG, Valkey, Inngest,
+ * and application deployments with automatic environment variable injection.
+ *
+ * All config types are inferred from ArkType schemas — the schema is the
+ * single source of truth. Status types remain as interfaces since they
+ * represent k8s API responses, not validated input.
+ *
+ * @module
+ */
+import { type } from 'arktype';
+// ============================================================================
+// Config Schemas (source of truth) + Inferred Types
+// ============================================================================
+/**
+ * Full-stack web application with background processing.
+ *
+ * Deploys: App + CNPG PostgreSQL + Valkey cache + Inngest workflow engine.
+ * All connection strings are automatically wired into the app's environment.
+ */
+export const WebAppWithProcessingConfigSchema = type({
+    /** Application name (used as prefix for all resources). */
+    name: 'string',
+    /** Target namespace. */
+    'namespace?': 'string',
+    /** Application deployment settings. */
+    app: {
+        /** Container image (e.g., 'myapp:latest'). */
+        image: 'string',
+        /** Container port (default: 3000). */
+        'port?': 'number',
+        /** Number of replicas (default: 1). */
+        'replicas?': 'number',
+        /** Additional environment variables. */
+        'env?': 'Record<string, string>',
+    },
+    /** PostgreSQL database settings. */
+    database: {
+        /** Number of PostgreSQL instances (default: 1). */
+        'instances?': 'number',
+        /** Storage size (e.g., '10Gi', '50Gi'). */
+        storageSize: 'string',
+        /** Storage class name (e.g. 'gp3', 'local-path'). */
+        'storageClass?': 'string',
+        /** Database name to create (default: derived from app name). */
+        'database?': 'string',
+        /** Database owner (default: 'app'). */
+        'owner?': 'string',
+    },
+    /** Valkey cache settings. Always deployed (omitting uses defaults, does not skip cache). */
+    'cache?': {
+        /** Number of Valkey shards (default: 3). */
+        'shards?': 'number',
+        /** Replicas per shard (default: 0). */
+        'replicas?': 'number',
+        /** Enable volume permissions init container. */
+        'volumePermissions?': 'boolean',
+        /** Storage size per shard (default: '1Gi'). */
+        'storageSize?': 'string',
+    },
+    /** Inngest background processing settings. */
+    processing: {
+        /** Inngest event authentication key (hex string, required). */
+        eventKey: 'string',
+        /** Inngest request signing key (hex string, required). */
+        signingKey: 'string',
+        /** SDK URLs to auto-sync functions from. */
+        'sdkUrl?': 'string[]',
+        /** Number of Inngest server replicas (default: 1). */
+        'replicas?': 'number',
+    },
+});
+/**
+ * Status schema for the full-stack web application deployment.
+ * Exposes connection URLs and readiness for each component.
+ */
+export const WebAppWithProcessingStatusSchema = type({
+    ready: 'boolean',
+    databaseUrl: 'string',
+    cacheUrl: 'string',
+    inngestUrl: 'string',
+    appUrl: 'string',
+    components: {
+        app: 'boolean',
+        database: 'boolean',
+        cache: 'boolean',
+        inngest: 'boolean',
+    },
+});
+//# sourceMappingURL=types.js.map

package/dist/factories/webapp/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/factories/webapp/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE/B,+EAA+E;AAC/E,oDAAoD;AACpD,+EAA+E;AAE/E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG,IAAI,CAAC;IACnD,2DAA2D;IAC3D,IAAI,EAAE,QAAQ;IACd,wBAAwB;IACxB,YAAY,EAAE,QAAQ;IACtB,uCAAuC;IACvC,GAAG,EAAE;QACH,8CAA8C;QAC9C,KAAK,EAAE,QAAQ;QACf,sCAAsC;QACtC,OAAO,EAAE,QAAQ;QACjB,uCAAuC;QACvC,WAAW,EAAE,QAAQ;QACrB,wCAAwC;QACxC,MAAM,EAAE,wBAAwB;KACjC;IACD,oCAAoC;IACpC,QAAQ,EAAE;QACR,mDAAmD;QACnD,YAAY,EAAE,QAAQ;QACtB,2CAA2C;QAC3C,WAAW,EAAE,QAAQ;QACrB,qDAAqD;QACrD,eAAe,EAAE,QAAQ;QACzB,gEAAgE;QAChE,WAAW,EAAE,QAAQ;QACrB,uCAAuC;QACvC,QAAQ,EAAE,QAAQ;KACnB;IACD,4FAA4F;IAC5F,QAAQ,EAAE;QACR,4CAA4C;QAC5C,SAAS,EAAE,QAAQ;QACnB,uCAAuC;QACvC,WAAW,EAAE,QAAQ;QACrB,gDAAgD;QAChD,oBAAoB,EAAE,SAAS;QAC/B,+CAA+C;QAC/C,cAAc,EAAE,QAAQ;KACzB;IACD,8CAA8C;IAC9C,UAAU,EAAE;QACV,+DAA+D;QAC/D,QAAQ,EAAE,QAAQ;QAClB,0DAA0D;QAC1D,UAAU,EAAE,QAAQ;QACpB,4CAA4C;QAC5C,SAAS,EAAE,UAAU;QACrB,sDAAsD;QACtD,WAAW,EAAE,QAAQ;KACtB;CACF,CAAC,CAAC;AAKH;;;GAGG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG,IAAI,CAAC;IACnD,KAAK,EAAE,SAAS;IAChB,WAAW,EAAE,QAAQ;IACrB,QAAQ,EAAE,QAAQ;IAClB,UAAU,EAAE,QAAQ;IACpB,MAAM,EAAE,QAAQ;IAChB,UAAU,EAAE;QACV,GAAG,EAAE,SAAS;QACd,QAAQ,EAAE,SAAS;QACnB,KAAK,EAAE,SAAS;QAChB,OAAO,EAAE,SAAS;KACnB;CACF,CAAC,CAAC"}

package/dist/shared/brands.d.ts

@@ -29,4 +29,20 @@ export declare const NESTED_COMPOSITION_BRAND: unique symbol;
  * Brand symbol for CallableComposition objects
  */
 export declare const CALLABLE_COMPOSITION_BRAND: unique symbol;
+/**
+ * Regex pattern for matching __KUBERNETES_REF__ marker strings in values.
+ *
+ * Format: __KUBERNETES_REF_{resourceId}_{fieldPath}__
+ * - resourceId: camelCase with optional hyphens/digits (e.g., 'database', 'inngestBootstrap1')
+ *   Hyphens are allowed for backward compatibility with older ID formats, though
+ *   current convention enforces camelCase (toCamelCase in executeNestedCompositionWithSpec).
+ * - fieldPath: dot-separated path with optional $ for iteration (e.g., 'status.ready', 'spec.workers.$item.name')
+ * - Excludes __schema__ refs via negative lookahead
+ *
+ * This pattern is the single source of truth — all marker detection/resolution
+ * code must use this constant to stay in sync. Callers must create their own
+ * RegExp via `new RegExp(KUBERNETES_REF_MARKER_PATTERN.source, 'g')` to avoid
+ * stateful lastIndex issues with the global flag.
+ */
+export declare const KUBERNETES_REF_MARKER_PATTERN: RegExp;
 //# sourceMappingURL=brands.d.ts.map

package/dist/shared/brands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"brands.d.ts","sourceRoot":"","sources":["../../src/shared/brands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;GAEG;AACH,eAAO,MAAM,oBAAoB,eAAsC,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,oBAAoB,eAAsC,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,oBAAoB,eAAsC,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,wBAAwB,eAA0C,CAAC;AAEhF;;GAEG;AACH,eAAO,MAAM,0BAA0B,eAA4C,CAAC"}
+{"version":3,"file":"brands.d.ts","sourceRoot":"","sources":["../../src/shared/brands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;GAEG;AACH,eAAO,MAAM,oBAAoB,eAAsC,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,oBAAoB,eAAsC,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,oBAAoB,eAAsC,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,wBAAwB,eAA0C,CAAC;AAEhF;;GAEG;AACH,eAAO,MAAM,0BAA0B,eAA4C,CAAC;AAEpF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,6BAA6B,QAAyE,CAAC"}

package/dist/shared/brands.js

@@ -29,4 +29,20 @@ export const NESTED_COMPOSITION_BRAND = Symbol.for('TypeKro.NestedComposition');
  * Brand symbol for CallableComposition objects
  */
 export const CALLABLE_COMPOSITION_BRAND = Symbol.for('TypeKro.CallableComposition');
+/**
+ * Regex pattern for matching __KUBERNETES_REF__ marker strings in values.
+ *
+ * Format: __KUBERNETES_REF_{resourceId}_{fieldPath}__
+ * - resourceId: camelCase with optional hyphens/digits (e.g., 'database', 'inngestBootstrap1')
+ *   Hyphens are allowed for backward compatibility with older ID formats, though
+ *   current convention enforces camelCase (toCamelCase in executeNestedCompositionWithSpec).
+ * - fieldPath: dot-separated path with optional $ for iteration (e.g., 'status.ready', 'spec.workers.$item.name')
+ * - Excludes __schema__ refs via negative lookahead
+ *
+ * This pattern is the single source of truth — all marker detection/resolution
+ * code must use this constant to stay in sync. Callers must create their own
+ * RegExp via `new RegExp(KUBERNETES_REF_MARKER_PATTERN.source, 'g')` to avoid
+ * stateful lastIndex issues with the global flag.
+ */
+export const KUBERNETES_REF_MARKER_PATTERN = /(?:__KUBERNETES_REF_)(?!_schema__)([a-zA-Z0-9-]+)_([a-zA-Z0-9.$]+)__/;
 //# sourceMappingURL=brands.js.map