@wtfalch/foundry 0.16.16 → 0.17.1

package/dist/plan/platform-providers.d.ts

@@ -131,6 +131,12 @@ export interface FoundryPlatformStepExecutorOptions {
      * `platform.ai.enabled` without it gets the step reported as blocked.
      */
     ai?: PlatformAiDeps;
+    /**
+     * #478: dependencies for `coolify:app` keyed {@link PLATFORM_NAMES_KEY} --
+     * optional for the same reason as `auth`; a host that declares
+     * `platform.names.enabled` without it gets the step reported as blocked.
+     */
+    names?: PlatformNamesDeps;
     /**
      * #175: dependencies for `coolify:app` keyed {@link PLATFORM_ARCHON_KEY}
      * -- optional for the same reason as {@link auth}.
@@ -197,6 +203,9 @@ export interface FoundryPlatformStepExecutorOptions {
  * #172 adds `coolify:app` keyed {@link PLATFORM_AI_KEY}, the platform's AI
  * host ({@link provisionPlatformAi}), once a host passes {@link PlatformAiDeps}.
  *
+ * #478 adds `coolify:app` keyed {@link PLATFORM_NAMES_KEY}, the names host
+ * ({@link provisionPlatformNames}), once a host passes {@link PlatformNamesDeps}.
+ *
  * #175 adds `coolify:app` keyed {@link PLATFORM_ARCHON_KEY}, Archon itself
  * ({@link provisionPlatformArchon}), once a host passes
  * {@link PlatformArchonDeps}.
@@ -216,6 +225,7 @@ export declare class FoundryPlatformStepExecutor implements PlatformStepExecutor
     private readonly integrations?;
     private readonly files?;
     private readonly ai?;
+    private readonly names?;
     private readonly archon?;
     private readonly backup?;
     constructor(cloudflare: Pick<CloudflarePort, 'findZoneByApex' | 'createZone'>, declaredOrgStore: Pick<DeclaredOrgStore, 'findOrgIdForZone' | 'list' | 'get'>, options?: FoundryPlatformStepExecutorOptions);
@@ -226,6 +236,7 @@ export declare class FoundryPlatformStepExecutor implements PlatformStepExecutor
         files?: string;
         integrations?: string;
         ai?: string;
+        names?: string;
         archon?: string;
         mail?: string;
         backupExecutorMissing?: boolean;
@@ -409,7 +420,7 @@ export interface PlatformMailRuntime {
  * {@link PlatformStepExecutionContext}, bundled like {@link PlatformAuthDeps}.
  */
 export interface PlatformArchonDeps {
-    coolify: Pick<CoolifyPort, 'findProjectByName' | 'createProject' | 'findOrCreateEnvironment' | 'listServers' | 'findApplicationByName' | 'getApplication' | 'requireGithubApp' | 'createGithubAppApplication' | 'createDockerfileApplication' | 'listDatabases' | 'createPostgresDatabase' | 'getDatabase' | 'raw' | 'bulkUpsertEnvs' | 'listEnvs' | 'updateApplication' | 'deploy' | 'deployAndWait'>;
+    coolify: Pick<CoolifyPort, 'findProjectByName' | 'createProject' | 'findOrCreateEnvironment' | 'listServers' | 'findApplicationByName' | 'getApplication' | 'requireGithubApp' | 'createGithubAppApplication' | 'createDockerfileApplication' | 'listDatabases' | 'createPostgresDatabase' | 'getDatabase' | 'raw' | 'bulkUpsertEnvs' | 'listEnvs' | 'deleteEnv' | 'updateApplication' | 'deploy' | 'deployAndWait'>;
     cloudflare: Pick<CloudflarePort, 'findZoneByApex' | 'findTunnelByName' | 'createTunnel' | 'putTunnelConfig' | 'getTunnelToken' | 'findDnsRecord' | 'createDnsRecord' | 'updateDnsRecord' | 'listAccessApps' | 'createAccessApp' | 'listAccessPolicies' | 'createAccessPolicy' | 'deleteAccessApp'>;
     /** Must target the platform's own ZITADEL instance, or `zitadelForInstance` must be set. */
     zitadel: Pick<ZitadelPort, 'findOrCreateOrg' | 'findOrCreateProject' | 'createOidcApp' | 'listApps' | 'deleteApp'>;
@@ -811,6 +822,39 @@ export declare const FILES_MANAGEMENT_KEY_ID = "foundry-1";
 export declare const FILES_MANAGEMENT_KEY_REF = "files:platform:managementKey";
 /** The ref the files host's introspection client secret is delivered under. */
 export declare const FILES_INTROSPECTION_SECRET_REF = "zitadel:platform:files:introspection";
+export interface PlatformNamesRuntime {
+    fetch?: typeof fetch;
+    sleep?: (ms: number) => Promise<void>;
+    now?: () => number;
+    /** Tries at handing the platform key to the host (default 3). */
+    deliverAttempts?: number;
+    readyTimeoutMs?: number;
+    readyIntervalMs?: number;
+}
+export interface PlatformNamesDeps {
+    coolify: Pick<CoolifyPort, 'findProjectByName' | 'createProject' | 'findOrCreateEnvironment' | 'listServers' | 'findApplicationByName' | 'getApplication' | 'requireGithubApp' | 'createGithubAppApplication' | 'createDockerfileApplication' | 'listDatabases' | 'createPostgresDatabase' | 'getDatabase' | 'bulkUpsertEnvs' | 'listEnvs' | 'updateApplication' | 'deploy' | 'deployAndWait' | 'raw'>;
+    cloudflare: Pick<CloudflarePort, 'findZoneByApex' | 'findTunnelByName' | 'createTunnel' | 'putTunnelConfig' | 'getTunnelToken' | 'findDnsRecord' | 'createDnsRecord' | 'updateDnsRecord'>;
+    deliverSecret: FoundryStepExecutorPorts['deliverSecret'];
+    /**
+     * Reads the names service's own Cloudflare API token back, held under
+     * {@link PLATFORM_NAMES_CLOUDFLARE_TOKEN_REF} -- a human step (the issue's
+     * own "Human steps"), never minted here: foundry has no Cloudflare
+     * account of its own to carve that token out of. Absent, or with nothing
+     * held under that ref yet, is reported blocked by `blockedSteps`
+     * ({@link namesBlockedReason}), never planned to throw.
+     */
+    heldKeys?: {
+        resolve(ref: string): Promise<string | null>;
+    };
+    /**
+     * The Cloudflare account id the token above is scoped to. Not a secret --
+     * a plain config value beside the credential it travels with, the same
+     * way {@link PlatformFilesDeps.r2}'s bucket name is.
+     */
+    cloudflareAccountId?: string;
+    /** Clock, sleep and fetch for the readiness wait and delivery retries; real ones by default. */
+    runtime?: PlatformNamesRuntime;
+}
 /**
  * #174: everything {@link provisionPlatformIntegrations} needs beyond
  * {@link PlatformStepExecutionContext} -- a bundle, like