@wtfalch/foundry 0.17.0 → 0.17.1

package/dist/plan/step-system.js

@@ -4,6 +4,7 @@ const PLATFORM_APP_SYSTEMS = {
     'platform:mail': 'stalwart',
     'platform:files': 'files',
     'platform:ai': 'ai',
+    'platform:names': 'names',
 };
 /** The system `action` touches. The one place that decides it, so no planner sets it by hand. */
 export function stepSystemOf(action) {

package/dist/platform.d.ts

@@ -12,8 +12,25 @@ export interface PlatformService {
     hostname: string;
     gitRef: string;
 }
-/** The eight shared services a declared platform names, decided in #165. */
-export type PlatformServiceKey = 'auth' | 'mail' | 'sfu' | 'files' | 'ai' | 'jobs' | 'integrations' | 'archon';
+/**
+ * #491: `mail`'s own extra field, on top of every other service's shape.
+ * Company Included (or whichever org's mail domain is the platform's own
+ * apex) sends through the platform's existing Lettermint project rather than
+ * a second `<slug>-app` one of its own -- `undefined`/`null` until an
+ * operator declares which project that is. A ref only, never a value: the
+ * project's own sending token stays where it already lived, held under
+ * `PLATFORM_AUTH_BROKER_MAIL_KEY_REF` (`plan/platform-providers.ts`).
+ */
+export interface PlatformMailService extends PlatformService {
+    lettermintProjectId?: string | null;
+}
+/**
+ * The shared services a declared platform names, decided in #165, plus
+ * `names` (#317, F7): the service that mints an entry's own names key and
+ * holds the Cloudflare token `<username>.<org domain>` claims use, so no
+ * hosting entry ever holds that credential itself.
+ */
+export type PlatformServiceKey = 'auth' | 'mail' | 'sfu' | 'files' | 'ai' | 'jobs' | 'integrations' | 'archon' | 'names';
 export declare const PLATFORM_SERVICE_KEYS: readonly PlatformServiceKey[];
 /**
  * The one shared platform every org's services run on -- decided in #165 as
@@ -42,13 +59,15 @@ export interface DeclaredPlatform {
      */
     serverIpv4?: string | null;
     auth: PlatformService;
-    mail: PlatformService;
+    mail: PlatformMailService;
     sfu: PlatformService;
     files: PlatformService;
     ai: PlatformService;
     jobs: PlatformService;
     integrations: PlatformService;
     archon: PlatformService;
+    /** #317 (F7). No deploy step reads this service's own `gitRef` yet -- `N1` is deployed by hand until it exists. */
+    names: PlatformService;
 }
 /** `<service>.<apex>` -- the default `hostname` for a platform service, before an operator overrides it. */
 export declare function defaultPlatformHostname(service: PlatformServiceKey, apex: string): string;

package/dist/platform.js

@@ -9,6 +9,7 @@ export const PLATFORM_SERVICE_KEYS = [
     'jobs',
     'integrations',
     'archon',
+    'names',
 ];
 /** `<service>.<apex>` -- the default `hostname` for a platform service, before an operator overrides it. */
 export function defaultPlatformHostname(service, apex) {
@@ -47,5 +48,10 @@ export function validatePlatform(platform) {
             return `${key}.gitRef must not be empty once ${key}.enabled is true`;
         }
     }
+    // #491: declared, never discovered -- a present-but-blank id is refused the
+    // same way `serverIpv4`'s blank string is, rather than being read as unset.
+    if (platform.mail.lettermintProjectId != null && !platform.mail.lettermintProjectId.trim()) {
+        return 'mail.lettermintProjectId must not be empty when set';
+    }
     return null;
 }

package/dist/store/postgres.js

@@ -578,7 +578,12 @@ function rowToPlatform(row) {
         apex: row.apex,
         ...(row.serverIpv4 ? { serverIpv4: row.serverIpv4 } : {}),
         auth: { enabled: row.authEnabled, hostname: row.authHostname, gitRef: row.authGitRef },
-        mail: { enabled: row.mailEnabled, hostname: row.mailHostname, gitRef: row.mailGitRef },
+        mail: {
+            enabled: row.mailEnabled,
+            hostname: row.mailHostname,
+            gitRef: row.mailGitRef,
+            ...(row.mailLettermintProjectId ? { lettermintProjectId: row.mailLettermintProjectId } : {}),
+        },
         sfu: { enabled: row.sfuEnabled, hostname: row.sfuHostname, gitRef: row.sfuGitRef },
         files: { enabled: row.filesEnabled, hostname: row.filesHostname, gitRef: row.filesGitRef },
         ai: { enabled: row.aiEnabled, hostname: row.aiHostname, gitRef: row.aiGitRef },
@@ -593,6 +598,11 @@ function rowToPlatform(row) {
             hostname: row.archonHostname,
             gitRef: row.archonGitRef,
         },
+        names: {
+            enabled: row.namesEnabled,
+            hostname: row.namesHostname,
+            gitRef: row.namesGitRef,
+        },
     };
 }
 function platformToRow(platform) {
@@ -607,6 +617,7 @@ function platformToRow(platform) {
         mailEnabled: platform.mail.enabled,
         mailHostname: platform.mail.hostname,
         mailGitRef: platform.mail.gitRef,
+        mailLettermintProjectId: platform.mail.lettermintProjectId ?? null,
         sfuEnabled: platform.sfu.enabled,
         sfuHostname: platform.sfu.hostname,
         sfuGitRef: platform.sfu.gitRef,
@@ -625,6 +636,9 @@ function platformToRow(platform) {
         archonEnabled: platform.archon.enabled,
         archonHostname: platform.archon.hostname,
         archonGitRef: platform.archon.gitRef,
+        namesEnabled: platform.names.enabled,
+        namesHostname: platform.names.hostname,
+        namesGitRef: platform.names.gitRef,
     };
 }
 /**

package/dist/store/schema.d.ts

@@ -1236,7 +1236,7 @@ export declare const foundryAuditEvents: import("drizzle-orm/pg-core").PgTableWi
             tableName: "foundry_audit_events";
             dataType: "string";
             columnType: "PgText";
-            data: "plan" | "destroy" | "apply";
+            data: "apply" | "plan" | "destroy";
             driverParam: string;
             notNull: true;
             hasDefault: false;
@@ -1248,7 +1248,7 @@ export declare const foundryAuditEvents: import("drizzle-orm/pg-core").PgTableWi
             identity: undefined;
             generated: undefined;
         }, {}, {
-            $type: "plan" | "destroy" | "apply";
+            $type: "apply" | "plan" | "destroy";
         }>;
         actorId: import("drizzle-orm/pg-core").PgColumn<{
             name: "actor_id";
@@ -1558,6 +1558,23 @@ export declare const foundryDeclaredPlatform: import("drizzle-orm/pg-core").PgTa
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
+        mailLettermintProjectId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "mail_lettermint_project_id";
+            tableName: "foundry_declared_platform";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
         sfuEnabled: import("drizzle-orm/pg-core").PgColumn<{
             name: "sfu_enabled";
             tableName: "foundry_declared_platform";
@@ -1864,6 +1881,57 @@ export declare const foundryDeclaredPlatform: import("drizzle-orm/pg-core").PgTa
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
+        namesEnabled: import("drizzle-orm/pg-core").PgColumn<{
+            name: "names_enabled";
+            tableName: "foundry_declared_platform";
+            dataType: "boolean";
+            columnType: "PgBoolean";
+            data: boolean;
+            driverParam: boolean;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        namesHostname: import("drizzle-orm/pg-core").PgColumn<{
+            name: "names_hostname";
+            tableName: "foundry_declared_platform";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        namesGitRef: import("drizzle-orm/pg-core").PgColumn<{
+            name: "names_git_ref";
+            tableName: "foundry_declared_platform";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
         serviceIds: import("drizzle-orm/pg-core").PgColumn<{
             name: "service_ids";
             tableName: "foundry_declared_platform";

package/dist/store/schema.js

@@ -158,6 +158,8 @@ export const foundryDeclaredPlatform = pgTable('foundry_declared_platform', {
     mailEnabled: boolean('mail_enabled').notNull().default(false),
     mailHostname: text('mail_hostname').notNull(),
     mailGitRef: text('mail_git_ref').notNull().default(''),
+    /** #491, `migrations/0044_platform_mail_lettermint_project.sql`. Declared, never discovered. */
+    mailLettermintProjectId: text('mail_lettermint_project_id'),
     sfuEnabled: boolean('sfu_enabled').notNull().default(false),
     sfuHostname: text('sfu_hostname').notNull(),
     sfuGitRef: text('sfu_git_ref').notNull().default(''),
@@ -176,6 +178,10 @@ export const foundryDeclaredPlatform = pgTable('foundry_declared_platform', {
     archonEnabled: boolean('archon_enabled').notNull().default(false),
     archonHostname: text('archon_hostname').notNull(),
     archonGitRef: text('archon_git_ref').notNull().default(''),
+    /** #317 (F7), `migrations/0038_platform_names.sql`. */
+    namesEnabled: boolean('names_enabled').notNull().default(false),
+    namesHostname: text('names_hostname').notNull(),
+    namesGitRef: text('names_git_ref').notNull().default(''),
     /** `migrations/0018_platform_apply.sql`: the platform's applied state, `system:kind:key` to provider id. */
     serviceIds: jsonb('service_ids').$type().notNull().default({}),
     createdAt: timestamp('created_at', { withTimezone: true }).notNull().defaultNow(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wtfalch/foundry",
-  "version": "0.17.0",
+  "version": "0.17.1",
   "description": "Foundry's SDK: the declared org's types, the plan and apply contracts, and the state store's interface.",
   "repository": {
     "type": "git",