@superzerodev/config 0.1.0

package/dist/define.d.ts

@@ -0,0 +1,25 @@
+/**
+ * defineApp と、宣言ファイル → DesiredResource[] への変換
+ *
+ * Provisioning Engine は宣言ファイルの形を知らない。ここで平らなリソース列に落とす。
+ */
+import { type DesiredResource } from '@superzerodev/core';
+import { type AppConfig, type AppConfigInput } from './schema.js';
+/**
+ * superzero.config.ts が default export する関数。
+ * 型補完のためだけの薄いラッパで、検証は loadConfig 側で行う
+ * （設定ファイルの読み込み時に一度だけ検証したいため）。
+ */
+export declare function defineApp(config: AppConfigInput): AppConfigInput;
+/** Zod のエラーを、エージェントが直せる形へ正規化する（§5.9） */
+export declare function parseConfig(raw: unknown): AppConfig;
+/**
+ * 宣言ファイルを Provisioning Engine が扱える DesiredResource[] へ落とす。
+ *
+ * ここが「宣言ファイルの形」と「リソースモデル」の唯一の接続点。
+ * 宣言ファイルの構造を変えても、影響はこの関数に閉じる。
+ */
+export declare function toDesiredResources(config: AppConfig): DesiredResource[];
+/** JSON Schema を吐く。MCP のツール定義とエディタ補完に流用する */
+export declare function toJsonSchema(): unknown;
+//# sourceMappingURL=define.d.ts.map

package/dist/define.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../src/define.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAA6B,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACpF,OAAO,EAAmB,KAAK,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAA;AAElF;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,CAEhE;AAED,wCAAwC;AACxC,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,SAAS,CAoBnD;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,eAAe,EAAE,CAavE;AAED,6CAA6C;AAC7C,wBAAgB,YAAY,IAAI,OAAO,CAEtC"}

package/dist/define.js

@@ -0,0 +1,62 @@
+/**
+ * defineApp と、宣言ファイル → DesiredResource[] への変換
+ *
+ * Provisioning Engine は宣言ファイルの形を知らない。ここで平らなリソース列に落とす。
+ */
+import { z } from 'zod';
+import { SuperzeroError, ErrorCode } from '@superzerodev/core';
+import { AppConfigSchema } from './schema.js';
+/**
+ * superzero.config.ts が default export する関数。
+ * 型補完のためだけの薄いラッパで、検証は loadConfig 側で行う
+ * （設定ファイルの読み込み時に一度だけ検証したいため）。
+ */
+export function defineApp(config) {
+    return config;
+}
+/** Zod のエラーを、エージェントが直せる形へ正規化する（§5.9） */
+export function parseConfig(raw) {
+    const result = AppConfigSchema.safeParse(raw);
+    if (result.success)
+        return result.data;
+    const issues = result.error.issues;
+    const first = issues[0];
+    const path = first ? first.path.join('.') : '(root)';
+    throw new SuperzeroError({
+        code: ErrorCode.CONFIG_INVALID,
+        message: `superzero.config.ts is invalid: ${issues.length} problem(s). ` +
+            issues.map((i) => `${i.path.join('.') || '(root)'}: ${i.message}`).join(' / '),
+        suggestedFix: {
+            description: `Fix "${path}" in superzero.config.ts. ` +
+                `Each message above states exactly what the field expects.`,
+            command: 'superzero plan',
+        },
+    });
+}
+/**
+ * 宣言ファイルを Provisioning Engine が扱える DesiredResource[] へ落とす。
+ *
+ * ここが「宣言ファイルの形」と「リソースモデル」の唯一の接続点。
+ * 宣言ファイルの構造を変えても、影響はこの関数に閉じる。
+ */
+export function toDesiredResources(config) {
+    const resources = [];
+    const add = (kind, spec) => {
+        resources.push({ kind, logicalName: 'default', spec });
+    };
+    if (config.database)
+        add('database', config.database);
+    if (config.auth)
+        add('auth', config.auth);
+    if (config.push)
+        add('push', config.push);
+    // compute は他リソースへ依存するため最後に置く（順序自体は Planner が解決する）
+    if (config.compute)
+        add('compute', config.compute);
+    return resources;
+}
+/** JSON Schema を吐く。MCP のツール定義とエディタ補完に流用する */
+export function toJsonSchema() {
+    return z.toJSONSchema(AppConfigSchema, { io: 'input' });
+}
+//# sourceMappingURL=define.js.map

package/dist/define.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.js","sourceRoot":"","sources":["../src/define.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,cAAc,EAAE,SAAS,EAAwB,MAAM,oBAAoB,CAAA;AACpF,OAAO,EAAE,eAAe,EAAuC,MAAM,aAAa,CAAA;AAElF;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,MAAsB;IAC9C,OAAO,MAAM,CAAA;AACf,CAAC;AAED,wCAAwC;AACxC,MAAM,UAAU,WAAW,CAAC,GAAY;IACtC,MAAM,MAAM,GAAG,eAAe,CAAC,SAAS,CAAC,GAAG,CAAC,CAAA;IAC7C,IAAI,MAAM,CAAC,OAAO;QAAE,OAAO,MAAM,CAAC,IAAI,CAAA;IAEtC,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAA;IAClC,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAA;IACvB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAA;IAEpD,MAAM,IAAI,cAAc,CAAC;QACvB,IAAI,EAAE,SAAS,CAAC,cAAc;QAC9B,OAAO,EACL,mCAAmC,MAAM,CAAC,MAAM,eAAe;YAC/D,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,QAAQ,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;QAChF,YAAY,EAAE;YACZ,WAAW,EACT,QAAQ,IAAI,4BAA4B;gBACxC,2DAA2D;YAC7D,OAAO,EAAE,gBAAgB;SAC1B;KACF,CAAC,CAAA;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAiB;IAClD,MAAM,SAAS,GAAsB,EAAE,CAAA;IACvC,MAAM,GAAG,GAAG,CAAC,IAA6B,EAAE,IAAa,EAAQ,EAAE;QACjE,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACxD,CAAC,CAAA;IAED,IAAI,MAAM,CAAC,QAAQ;QAAE,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAA;IACrD,IAAI,MAAM,CAAC,IAAI;QAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAA;IACzC,IAAI,MAAM,CAAC,IAAI;QAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAA;IACzC,kDAAkD;IAClD,IAAI,MAAM,CAAC,OAAO;QAAE,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,CAAA;IAElD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,6CAA6C;AAC7C,MAAM,UAAU,YAAY;IAC1B,OAAO,CAAC,CAAC,YAAY,CAAC,eAAe,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAA;AACzD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from './schema.js';
+export * from './define.js';
+export * from './reserved.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export * from './schema.js';
+export * from './define.js';
+export * from './reserved.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA"}

package/dist/reserved.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 基盤が自分で使うホスト名。プロジェクト名には使わせない。
+ *
+ * ★ プロジェクト名はそのまま `{name}.{apex}` の公開ホストになる。
+ *   予約していないと、顧客が `api` という名前でプロジェクトを作った時点で
+ *   `api.superzero.dev` のルートが**上書き**され、Control Plane API への
+ *   通信がその顧客のコンテナへ流れる。サインアップもキー発行も奪われる。
+ *   ルート登録は「同じドメインなら PATCH」なので、衝突しても
+ *   エラーにならず静かに乗っ取られる。
+ *
+ * ★ いま使っていない名前も含めて広めに取る。
+ *   あとから予約を増やすと、既に使っている顧客の名前を取り上げることになり、
+ *   移行が要る。最初に広く取るほうが安い。
+ */
+export declare const RESERVED_PROJECT_NAMES: ReadonlySet<string>;
+export declare function isReservedProjectName(name: string): boolean;
+/**
+ * プロジェクト名として使える形。DNS の1ラベルと同じ制約。
+ *
+ * ★ 名前はそのまま公開ホスト名になるので、形も守る必要がある。
+ *   `*` を通すと `*.{apex}` というワイルドカードのルートが生え、
+ *   全顧客のホスト名に一致してしまう。1社が全社の通信を捕まえられる。
+ */
+export declare const PROJECT_NAME_PATTERN: RegExp;
+export declare function isValidProjectName(name: string): boolean;
+//# sourceMappingURL=reserved.d.ts.map

package/dist/reserved.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reserved.d.ts","sourceRoot":"","sources":["../src/reserved.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,sBAAsB,EAAE,WAAW,CAAC,MAAM,CAgDrD,CAAA;AAEF,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,QAAoC,CAAA;AAErE,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExD"}

package/dist/reserved.js

@@ -0,0 +1,78 @@
+/**
+ * 基盤が自分で使うホスト名。プロジェクト名には使わせない。
+ *
+ * ★ プロジェクト名はそのまま `{name}.{apex}` の公開ホストになる。
+ *   予約していないと、顧客が `api` という名前でプロジェクトを作った時点で
+ *   `api.superzero.dev` のルートが**上書き**され、Control Plane API への
+ *   通信がその顧客のコンテナへ流れる。サインアップもキー発行も奪われる。
+ *   ルート登録は「同じドメインなら PATCH」なので、衝突しても
+ *   エラーにならず静かに乗っ取られる。
+ *
+ * ★ いま使っていない名前も含めて広めに取る。
+ *   あとから予約を増やすと、既に使っている顧客の名前を取り上げることになり、
+ *   移行が要る。最初に広く取るほうが安い。
+ */
+export const RESERVED_PROJECT_NAMES = new Set([
+    // Control Plane と社内向け
+    'api',
+    'admin',
+    'app',
+    'console',
+    'dashboard',
+    'control',
+    'internal',
+    'auth',
+    'login',
+    'signup',
+    'billing',
+    'account',
+    'accounts',
+    // 公開サイト
+    'www',
+    'docs',
+    'blog',
+    'status',
+    'support',
+    'help',
+    'about',
+    'legal',
+    'assets',
+    'static',
+    'cdn',
+    // メールと DNS。ここを取られると、なりすましや配送の妨害に使える
+    'mail',
+    'smtp',
+    'imap',
+    'pop',
+    'mx',
+    'ns',
+    'ns1',
+    'ns2',
+    'dns',
+    'autodiscover',
+    'autoconfig',
+    // 証明書の検証や、環境の取り違えを招くもの
+    'acme',
+    'localhost',
+    'test',
+    'staging',
+    'stage',
+    'dev',
+    'prod',
+    'production',
+]);
+export function isReservedProjectName(name) {
+    return RESERVED_PROJECT_NAMES.has(name.toLowerCase());
+}
+/**
+ * プロジェクト名として使える形。DNS の1ラベルと同じ制約。
+ *
+ * ★ 名前はそのまま公開ホスト名になるので、形も守る必要がある。
+ *   `*` を通すと `*.{apex}` というワイルドカードのルートが生え、
+ *   全顧客のホスト名に一致してしまう。1社が全社の通信を捕まえられる。
+ */
+export const PROJECT_NAME_PATTERN = /^[a-z0-9]([a-z0-9-]*[a-z0-9])?$/;
+export function isValidProjectName(name) {
+    return name.length >= 1 && name.length <= 63 && PROJECT_NAME_PATTERN.test(name);
+}
+//# sourceMappingURL=reserved.js.map

package/dist/reserved.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reserved.js","sourceRoot":"","sources":["../src/reserved.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAwB,IAAI,GAAG,CAAC;IACjE,sBAAsB;IACtB,KAAK;IACL,OAAO;IACP,KAAK;IACL,SAAS;IACT,WAAW;IACX,SAAS;IACT,UAAU;IACV,MAAM;IACN,OAAO;IACP,QAAQ;IACR,SAAS;IACT,SAAS;IACT,UAAU;IACV,QAAQ;IACR,KAAK;IACL,MAAM;IACN,MAAM;IACN,QAAQ;IACR,SAAS;IACT,MAAM;IACN,OAAO;IACP,OAAO;IACP,QAAQ;IACR,QAAQ;IACR,KAAK;IACL,oCAAoC;IACpC,MAAM;IACN,MAAM;IACN,MAAM;IACN,KAAK;IACL,IAAI;IACJ,IAAI;IACJ,KAAK;IACL,KAAK;IACL,KAAK;IACL,cAAc;IACd,YAAY;IACZ,uBAAuB;IACvB,MAAM;IACN,WAAW;IACX,MAAM;IACN,SAAS;IACT,OAAO;IACP,KAAK;IACL,MAAM;IACN,YAAY;CACb,CAAC,CAAA;AAEF,MAAM,UAAU,qBAAqB,CAAC,IAAY;IAChD,OAAO,sBAAsB,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAA;AACvD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,iCAAiC,CAAA;AAErE,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,OAAO,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,IAAI,EAAE,IAAI,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACjF,CAAC"}

package/dist/schema.d.ts

@@ -0,0 +1,151 @@
+/**
+ * 宣言ファイルのスキーマ（P0設計 §5.1）
+ *
+ * Zod を単一ソースとし、ここから
+ *   - TypeScript の型（エディタ補完）
+ *   - JSON Schema（MCP のツール定義、エディタの検証）
+ * を生成する。定義を2箇所に書かない。
+ */
+import { z } from 'zod';
+/** P0 は東京のみ（v0.2 で 2リージョンから削減） */
+export declare const RegionSchema: z.ZodEnum<{
+    "ap-northeast-1": "ap-northeast-1";
+}>;
+export declare const ComputeSchema: z.ZodObject<{
+    framework: z.ZodDefault<z.ZodEnum<{
+        auto: "auto";
+        nextjs: "nextjs";
+        node: "node";
+        python: "python";
+        docker: "docker";
+    }>>;
+    buildCommand: z.ZodOptional<z.ZodString>;
+    startCommand: z.ZodOptional<z.ZodString>;
+    envFrom: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+        auth: "auth";
+        database: "database";
+        push: "push";
+        email: "email";
+    }>>>;
+    idleTimeout: z.ZodDefault<z.ZodString>;
+    memoryMb: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const DatabaseSchema: z.ZodObject<{
+    engine: z.ZodDefault<z.ZodLiteral<"postgres">>;
+    extensions: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+        pgvector: "pgvector";
+        postgis: "postgis";
+        pg_cron: "pg_cron";
+        "uuid-ossp": "uuid-ossp";
+    }>>>;
+}, z.core.$strip>;
+/**
+ * SMS の濫用防止 第1層（§5.7）。
+ * allowedCountries を必須にすることで、設定漏れによる全開放を構造的に起こさない。
+ * ISO 3166-1 alpha-2。
+ */
+export declare const SmsSchema: z.ZodObject<{
+    enabled: z.ZodLiteral<true>;
+    allowedCountries: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export declare const AuthSchema: z.ZodObject<{
+    providers: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+        email: "email";
+        google: "google";
+        apple: "apple";
+    }>>>;
+    sms: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodLiteral<true>;
+        allowedCountries: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+    jwt: z.ZodDefault<z.ZodObject<{
+        expiresIn: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const PushSchema: z.ZodObject<{
+    ios: z.ZodOptional<z.ZodObject<{
+        bundleId: z.ZodString;
+        keyId: z.ZodString;
+        teamId: z.ZodString;
+    }, z.core.$strip>>;
+    android: z.ZodOptional<z.ZodObject<{
+        packageName: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * ★ P0 では email を宣言できない。
+ *
+ *   スキーマが受け付けても、対応するアダプタが無いため plan が
+ *   CONFIG_UNKNOWN_PROVIDER で落ちる。「宣言できるのに動かない」は最悪の体験なので、
+ *   提供できるものだけを受け付ける形にした。
+ *
+ *   メールを実際に使う機能（マジックリンク・メール検証）がまだ無く、
+ *   送信ドメインだけ用意しても使い道が無いことも理由。
+ *   実装する時点でこの定義を復活させ、SES アダプタと同時に入れる。
+ */
+/**
+ * ★ strict にする。未知のキーを黙って捨てると、
+ *   綴り間違いや P0 未対応の機能が「書いたのに無視される」形になる。
+ *   エージェントにとっては最も分かりにくい失敗なので、明示的に弾く。
+ */
+export declare const AppConfigSchema: z.ZodObject<{
+    name: z.ZodString;
+    region: z.ZodDefault<z.ZodEnum<{
+        "ap-northeast-1": "ap-northeast-1";
+    }>>;
+    compute: z.ZodOptional<z.ZodObject<{
+        framework: z.ZodDefault<z.ZodEnum<{
+            auto: "auto";
+            nextjs: "nextjs";
+            node: "node";
+            python: "python";
+            docker: "docker";
+        }>>;
+        buildCommand: z.ZodOptional<z.ZodString>;
+        startCommand: z.ZodOptional<z.ZodString>;
+        envFrom: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+            auth: "auth";
+            database: "database";
+            push: "push";
+            email: "email";
+        }>>>;
+        idleTimeout: z.ZodDefault<z.ZodString>;
+        memoryMb: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+    database: z.ZodOptional<z.ZodObject<{
+        engine: z.ZodDefault<z.ZodLiteral<"postgres">>;
+        extensions: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+            pgvector: "pgvector";
+            postgis: "postgis";
+            pg_cron: "pg_cron";
+            "uuid-ossp": "uuid-ossp";
+        }>>>;
+    }, z.core.$strip>>;
+    auth: z.ZodOptional<z.ZodObject<{
+        providers: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+            email: "email";
+            google: "google";
+            apple: "apple";
+        }>>>;
+        sms: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodLiteral<true>;
+            allowedCountries: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>>;
+        jwt: z.ZodDefault<z.ZodObject<{
+            expiresIn: z.ZodDefault<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    push: z.ZodOptional<z.ZodObject<{
+        ios: z.ZodOptional<z.ZodObject<{
+            bundleId: z.ZodString;
+            keyId: z.ZodString;
+            teamId: z.ZodString;
+        }, z.core.$strip>>;
+        android: z.ZodOptional<z.ZodObject<{
+            packageName: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strict>;
+export type AppConfigInput = z.input<typeof AppConfigSchema>;
+export type AppConfig = z.output<typeof AppConfigSchema>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,kCAAkC;AAClC,eAAO,MAAM,YAAY;;EAA6B,CAAA;AAEtD,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;iBAiBxB,CAAA;AAEF,eAAO,MAAM,cAAc;;;;;;;;iBAGzB,CAAA;AAEF;;;;GAIG;AACH,eAAO,MAAM,SAAS;;;iBAKpB,CAAA;AAEF,eAAO,MAAM,UAAU;;;;;;;;;;;;;iBASrB,CAAA;AAEF,eAAO,MAAM,UAAU;;;;;;;;;iBAkBnB,CAAA;AAEJ;;;;;;;;;;GAUG;AAEH;;;;GAIG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAqB1B,CAAA;AAEF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAA;AAC5D,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,eAAe,CAAC,CAAA"}

package/dist/schema.js

@@ -0,0 +1,112 @@
+/**
+ * 宣言ファイルのスキーマ（P0設計 §5.1）
+ *
+ * Zod を単一ソースとし、ここから
+ *   - TypeScript の型（エディタ補完）
+ *   - JSON Schema（MCP のツール定義、エディタの検証）
+ * を生成する。定義を2箇所に書かない。
+ */
+import { z } from 'zod';
+import { isReservedProjectName } from './reserved.js';
+/** P0 は東京のみ（v0.2 で 2リージョンから削減） */
+export const RegionSchema = z.enum(['ap-northeast-1']);
+export const ComputeSchema = z.object({
+    /** Nixpacks が自動検出する。明示指定も可能 */
+    framework: z.enum(['auto', 'nextjs', 'node', 'python', 'docker']).default('auto'),
+    buildCommand: z.string().optional(),
+    startCommand: z.string().optional(),
+    /**
+     * 接続情報を環境変数として注入する依存リソース。
+     * ここが Provisioning Engine の依存グラフ（PE-2）の入力になる。
+     */
+    envFrom: z.array(z.enum(['database', 'auth', 'push', 'email'])).default([]),
+    /** scale-to-zero までの無通信時間。P0 の既定は 15分 */
+    idleTimeout: z
+        .string()
+        .regex(/^\d+(s|m|h)$/, 'Use a duration like "15m", "30s" or "1h".')
+        .default('15m'),
+    /** 1プロジェクト1コンテナ固定（P0）。水平スケールは P1 */
+    memoryMb: z.number().int().min(256).max(4096).default(512),
+});
+export const DatabaseSchema = z.object({
+    engine: z.literal('postgres').default('postgres'),
+    extensions: z.array(z.enum(['pgvector', 'postgis', 'pg_cron', 'uuid-ossp'])).default([]),
+});
+/**
+ * SMS の濫用防止 第1層（§5.7）。
+ * allowedCountries を必須にすることで、設定漏れによる全開放を構造的に起こさない。
+ * ISO 3166-1 alpha-2。
+ */
+export const SmsSchema = z.object({
+    enabled: z.literal(true),
+    allowedCountries: z
+        .array(z.string().regex(/^[A-Z]{2}$/, 'Use ISO 3166-1 alpha-2 codes, e.g. "JP".'))
+        .min(1, 'auth.sms.allowedCountries must list at least one country. An empty list is never allowed.'),
+});
+export const AuthSchema = z.object({
+    /** P0 は email / google / apple のみ。Passkey は P1（D9） */
+    providers: z.array(z.enum(['email', 'google', 'apple'])).min(1).default(['email']),
+    sms: SmsSchema.optional(),
+    jwt: z
+        .object({
+        expiresIn: z.string().regex(/^\d+(m|h|d)$/).default('1h'),
+    })
+        .default({ expiresIn: '1h' }),
+});
+export const PushSchema = z
+    .object({
+    ios: z
+        .object({
+        bundleId: z.string().min(1),
+        /** $SECRET 参照。.p8 の中身は宣言ファイルに書かない */
+        keyId: z.string().min(1),
+        teamId: z.string().min(1),
+    })
+        .optional(),
+    android: z
+        .object({
+        packageName: z.string().min(1),
+    })
+        .optional(),
+})
+    .refine((v) => v.ios !== undefined || v.android !== undefined, {
+    message: 'push requires at least one of "ios" or "android". Web Push is not supported in P0.',
+});
+/**
+ * ★ P0 では email を宣言できない。
+ *
+ *   スキーマが受け付けても、対応するアダプタが無いため plan が
+ *   CONFIG_UNKNOWN_PROVIDER で落ちる。「宣言できるのに動かない」は最悪の体験なので、
+ *   提供できるものだけを受け付ける形にした。
+ *
+ *   メールを実際に使う機能（マジックリンク・メール検証）がまだ無く、
+ *   送信ドメインだけ用意しても使い道が無いことも理由。
+ *   実装する時点でこの定義を復活させ、SES アダプタと同時に入れる。
+ */
+/**
+ * ★ strict にする。未知のキーを黙って捨てると、
+ *   綴り間違いや P0 未対応の機能が「書いたのに無視される」形になる。
+ *   エージェントにとっては最も分かりにくい失敗なので、明示的に弾く。
+ */
+export const AppConfigSchema = z.strictObject({
+    name: z
+        .string()
+        .min(1)
+        .max(63)
+        .regex(/^[a-z0-9]([a-z0-9-]*[a-z0-9])?$/, 'Use lowercase letters, digits and hyphens only.')
+        /**
+         * ★ 名前はそのまま公開ホスト名になる。基盤が使う名前は取らせない。
+         *   ここで弾くのは早く気づかせるため。実際の防御はサーバー側にある
+         *   （設定ファイルの検証は顧客の手元で走るので、素通しできてしまう）。
+         */
+        .refine((v) => !isReservedProjectName(v), {
+        message: 'This name is reserved by the platform. Choose another name; ' +
+            'project names become public hostnames.',
+    }),
+    region: RegionSchema.default('ap-northeast-1'),
+    compute: ComputeSchema.optional(),
+    database: DatabaseSchema.optional(),
+    auth: AuthSchema.optional(),
+    push: PushSchema.optional(),
+});
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@superzerodev/config",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "!dist/__tests__"
+  ],
+  "dependencies": {
+    "zod": "^4.0.0",
+    "@superzerodev/core": "0.1.0"
+  },
+  "description": "Types and validation for superzero.config.ts. defineApp lives here.",
+  "license": "UNLICENSED",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mashihara/superzero.git",
+    "directory": "packages/config"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "tsc -p tsconfig.json && node --test \"dist/__tests__/*.test.js\""
+  }
+}