@superzerodev/core 0.1.0

package/dist/source-archive.js

@@ -0,0 +1,398 @@
+/**
+ * デプロイするソースの受け渡し（CLI → Control Plane）
+ *
+ * ★ ここが無いと、遠隔の顧客は誰もアプリを載せられない。
+ *
+ *   以前は CLI が「宣言ファイルのあるディレクトリの絶対パス」を文字列で送り、
+ *   Control Plane がそれを *自分の* ファイルシステムのパスとして開いていた。
+ *   CLI とサーバーが同じホストに居るときだけ通る作りで、顧客の Mac から
+ *   api.superzero.dev を叩くと `ENOENT ... scandir '/Users/...'` で落ちていた。
+ *   受け入れ確認が通っていたのは、CLI をサーバー上で走らせていたため。
+ *
+ *   加えて、そのパスは無検証でサーバーの fs に渡っていた。認証済みの顧客が
+ *   `/etc/superzero` を指定すれば、基盤の秘密が自分のコンテナイメージに入った。
+ *   ソースを送る形にすると、この穴は構造的に消える（パスを受け取らなくなる）。
+ *
+ * ★ 外部依存を足さない。tar は自分で書く。
+ *   顧客の手元で走るコードなので、依存が増えるほど「入らない」が増える。
+ *   形式は ustar（長い名前は GNU の 'L' エントリ）なので、
+ *   `tar -tzf` でそのまま中身を確認できる。デバッグ手段を捨てない。
+ *
+ * ★ macOS の tar を呼ばない。
+ *   呼ぶと拡張属性が `._<name>` という別ファイルとして混ざり、Linux 側の
+ *   Nixpacks が "stream did not contain valid UTF-8" で落ちる
+ *   （docs/05-development.md の「macOS の tar が AppleDouble を混ぜる」）。
+ *   自分で書けば構造的に混ざらない。既にディスク上にある `._*` は明示的に外す。
+ */
+import { spawn } from 'node:child_process';
+import { mkdir, readFile, readdir, stat, writeFile } from 'node:fs/promises';
+import { dirname, join, relative, resolve, sep } from 'node:path';
+import { gunzipSync, gzipSync } from 'node:zlib';
+import { sourceInvalidArchive, sourceTooLarge } from './errors.js';
+/**
+ * ビルドに関係しないので送らない。ソースの指紋（fingerprintOf）の
+ * 除外リストと同じ集合であること。ここがずれると、送っていないファイルを
+ * サーバーが数えようとして指紋が食い違う。
+ */
+export const DEFAULT_IGNORED_ENTRIES = new Set([
+    '.git',
+    'node_modules',
+    'dist',
+    'build',
+    '.next',
+    '.turbo',
+    'target',
+    '__pycache__',
+    '.venv',
+    '.DS_Store',
+]);
+/**
+ * 名前だけで落とせるものを落とす。
+ *
+ * ★ `._*`（AppleDouble）は集合ではなく前置きで判定する。
+ *   名前が実行時に決まるので Set には入れられない。
+ */
+export function isIgnoredEntryName(name) {
+    return DEFAULT_IGNORED_ENTRIES.has(name) || name.startsWith('._');
+}
+/**
+ * 上限。node_modules を外したアプリのソースとしては十分に広い。
+ * 超えるのはたいてい「送るべきでないもの」が混ざっている合図なので、
+ * 黙って通さずエラーにして気づかせる。
+ */
+export const DEFAULT_SOURCE_LIMITS = {
+    maxFiles: 20_000,
+    maxBytes: 100 * 1024 * 1024,
+};
+// --- 収集 --------------------------------------------------------------------
+/**
+ * 送るファイルを選ぶ。
+ *
+ * ★ .gitignore の解釈は git 自身にやらせる。
+ *   自前のマッチャを書くと、git と挙動がずれたときに
+ *   「なぜかファイルが上がらない／上がる」という原因の分かりにくい事故になる。
+ *   git が無い・リポジトリでない場合だけ、既定の除外リストで歩く。
+ *
+ * ★ どちらの経路でも DEFAULT_IGNORED_ENTRIES は最後に必ず適用する。
+ *   node_modules を commit している相手でも送らないため。
+ */
+async function collectFiles(root, options) {
+    if (options.useGit !== false) {
+        const tracked = await gitListFiles(root, options.gitTimeoutMs ?? 10_000);
+        if (tracked)
+            return { files: tracked.filter(notIgnored), selection: 'git' };
+    }
+    const walked = await walk(root, root);
+    return { files: walked.filter(notIgnored), selection: 'walk' };
+}
+function notIgnored(relPath) {
+    return !relPath.split('/').some(isIgnoredEntryName);
+}
+/**
+ * `git ls-files -co --exclude-standard` の結果を返す。
+ * リポジトリでない・git が無い・失敗した場合は null（呼び出し側が歩く）。
+ */
+async function gitListFiles(root, timeoutMs) {
+    const out = await runGit(['-c', 'core.quotepath=off', 'ls-files', '--cached', '--others', '--exclude-standard', '-z'], root, timeoutMs);
+    if (out === null)
+        return null;
+    const names = out.split('\0').filter((n) => n.length > 0);
+    const files = [];
+    for (const name of names) {
+        // ★ --cached には「削除済みだがまだ commit していない」ファイルも出る。
+        //   stat して実体のあるものだけにする。無いものを送ろうとすると落ちる。
+        try {
+            const s = await stat(join(root, name));
+            if (s.isFile())
+                files.push(name);
+        }
+        catch {
+            // 消えているファイルは送らない
+        }
+    }
+    return files;
+}
+function runGit(args, cwd, timeoutMs) {
+    return new Promise((resolvePromise) => {
+        let child;
+        try {
+            child = spawn('git', args, { cwd, stdio: ['ignore', 'pipe', 'ignore'] });
+        }
+        catch {
+            resolvePromise(null);
+            return;
+        }
+        let stdout = '';
+        let settled = false;
+        const finish = (value) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            resolvePromise(value);
+        };
+        const timer = setTimeout(() => {
+            child.kill('SIGKILL');
+            finish(null);
+        }, timeoutMs);
+        child.stdout.on('data', (c) => {
+            stdout += c.toString('utf8');
+        });
+        // git が入っていない環境ではここに来る。歩く経路へ落とす
+        child.on('error', () => finish(null));
+        child.on('close', (code) => finish(code === 0 ? stdout : null));
+    });
+}
+/** 既定の除外リストで歩く。fingerprintOf と同じ規則にすること */
+async function walk(root, dir) {
+    const entries = await readdir(dir, { withFileTypes: true });
+    const out = [];
+    for (const entry of entries) {
+        if (isIgnoredEntryName(entry.name))
+            continue;
+        const full = join(dir, entry.name);
+        if (entry.isDirectory()) {
+            out.push(...(await walk(root, full)));
+        }
+        else if (entry.isFile()) {
+            out.push(toPosix(relative(root, full)));
+        }
+        else if (entry.isSymbolicLink()) {
+            // 実体が通常ファイルなら中身を送る（ディレクトリは辿らない。循環を避ける）
+            try {
+                const s = await stat(full);
+                if (s.isFile())
+                    out.push(toPosix(relative(root, full)));
+            }
+            catch {
+                // 壊れたリンクは無視する
+            }
+        }
+    }
+    return out;
+}
+function toPosix(p) {
+    return p.split(sep).join('/');
+}
+// --- 詰める ------------------------------------------------------------------
+export async function packSource(rootDir, options = {}) {
+    const limits = options.limits ?? DEFAULT_SOURCE_LIMITS;
+    const root = resolve(rootDir);
+    const { files, selection } = await collectFiles(root, options);
+    files.sort();
+    if (files.length > limits.maxFiles) {
+        throw sourceTooLarge(`${files.length} files`, `${limits.maxFiles} files`);
+    }
+    const chunks = [];
+    let bytes = 0;
+    for (const relPath of files) {
+        const full = join(root, relPath);
+        // ★ シンボリックリンクは実体を送る。リンクのまま送ると、
+        //   展開先に無い場所を指す壊れたリンクになる（fingerprintOf も実体を見ている）
+        const info = await stat(full);
+        bytes += info.size;
+        if (bytes > limits.maxBytes) {
+            throw sourceTooLarge(formatBytes(bytes), formatBytes(limits.maxBytes));
+        }
+        const content = await readFile(full);
+        const mode = (info.mode & 0o111) !== 0 ? 0o755 : 0o644;
+        chunks.push(...entryBlocks(relPath, content, mode, Math.floor(info.mtimeMs / 1000)));
+    }
+    // 終端は 512 バイトのゼロブロック2つ
+    chunks.push(Buffer.alloc(BLOCK * 2));
+    return {
+        archive: gzipSync(Buffer.concat(chunks)),
+        fileCount: files.length,
+        bytes,
+        selection,
+    };
+}
+const BLOCK = 512;
+function entryBlocks(name, content, mode, mtime) {
+    const blocks = [];
+    /**
+     * ★ 100 バイトを超える名前は GNU の長ファイル名エントリで先に送る。
+     *   ustar の prefix 分割だけだと 255 バイトで詰まり、
+     *   深いモノレポで「なぜか特定のファイルだけ送れない」が起きる。
+     */
+    const nameBytes = Buffer.from(name, 'utf8');
+    if (nameBytes.length > 100) {
+        const payload = Buffer.concat([nameBytes, Buffer.from([0])]);
+        blocks.push(header('././@LongLink', payload.length, 0o644, 0, 'L'));
+        blocks.push(pad(payload));
+    }
+    blocks.push(header(name, content.length, mode, mtime, '0'));
+    blocks.push(pad(content));
+    return blocks;
+}
+function pad(data) {
+    const remainder = data.length % BLOCK;
+    if (remainder === 0)
+        return data;
+    return Buffer.concat([data, Buffer.alloc(BLOCK - remainder)]);
+}
+function header(name, size, mode, mtime, typeflag) {
+    const buf = Buffer.alloc(BLOCK);
+    // 100 バイトに収まらない分は切り詰める。実際の名前は 'L' エントリが持っている
+    buf.write(name.slice(0, 100), 0, 100, 'utf8');
+    buf.write(octal(mode, 8), 100, 8, 'ascii');
+    buf.write(octal(0, 8), 108, 8, 'ascii'); // uid
+    buf.write(octal(0, 8), 116, 8, 'ascii'); // gid
+    buf.write(octal(size, 12), 124, 12, 'ascii');
+    buf.write(octal(mtime, 12), 136, 12, 'ascii');
+    buf.write('        ', 148, 8, 'ascii'); // chksum は空白で埋めてから計算する
+    buf.write(typeflag, 156, 1, 'ascii');
+    buf.write('ustar\0', 257, 6, 'ascii');
+    buf.write('00', 263, 2, 'ascii');
+    let sum = 0;
+    for (const byte of buf)
+        sum += byte;
+    buf.write(`${sum.toString(8).padStart(6, '0')}\0 `, 148, 8, 'ascii');
+    return buf;
+}
+function octal(value, width) {
+    return `${value.toString(8).padStart(width - 1, '0')}\0`;
+}
+/**
+ * アーカイブを destDir に展開する。
+ *
+ * ★ 中身は顧客が作ったもの。信用しない。
+ *   絶対パス・`..`・シンボリックリンク・デバイスファイルは全て拒否する。
+ *   通したら、顧客が Control Plane のホストの任意の場所に書けることになる。
+ *
+ * ★ 上限は「宣言されたサイズ」ではなく「実際に展開したバイト数」で数える。
+ *   ヘッダの数字を信じると、小さいと宣言した巨大なアーカイブを通してしまう。
+ */
+export async function unpackSource(archive, destDir, limits = DEFAULT_SOURCE_LIMITS) {
+    const root = resolve(destDir);
+    let raw;
+    try {
+        // ★ gzip の展開そのものにも上限をかける。ここが無いと、
+        //   数十 KB の圧縮データで数 GB のメモリを掴まされる
+        raw = gunzipSync(archive, { maxOutputLength: limits.maxBytes + BLOCK * 4 });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        if (message.includes('maxOutputLength') || message.includes('Buffer')) {
+            throw sourceTooLarge('more than the limit', formatBytes(limits.maxBytes));
+        }
+        throw sourceInvalidArchive(`the upload is not a valid gzip stream (${message})`);
+    }
+    await mkdir(root, { recursive: true, mode: 0o700 });
+    let offset = 0;
+    let longName;
+    let fileCount = 0;
+    let bytes = 0;
+    while (offset + BLOCK <= raw.length) {
+        const head = raw.subarray(offset, offset + BLOCK);
+        offset += BLOCK;
+        if (isZeroBlock(head))
+            break;
+        verifyChecksum(head);
+        const typeflag = String.fromCharCode(head[156] ?? 0);
+        const size = parseOctal(head, 124, 12);
+        const end = offset + Math.ceil(size / BLOCK) * BLOCK;
+        if (end > raw.length)
+            throw sourceInvalidArchive('the archive ends in the middle of an entry');
+        const data = raw.subarray(offset, offset + size);
+        offset = end;
+        if (typeflag === 'L') {
+            // GNU の長ファイル名。次のエントリの名前になる
+            longName = data.toString('utf8').replace(/\0+$/, '');
+            continue;
+        }
+        const name = longName ?? readName(head);
+        longName = undefined;
+        // ディレクトリは中のファイルを書くときに作る。空ディレクトリは送っていない
+        if (typeflag === '5')
+            continue;
+        if (typeflag !== '0' && typeflag !== '\0') {
+            throw sourceInvalidArchive(`the archive contains an entry of type "${typeflag}" (${name}); ` +
+                'only regular files are accepted');
+        }
+        fileCount += 1;
+        bytes += size;
+        if (fileCount > limits.maxFiles) {
+            throw sourceTooLarge(`${fileCount} files`, `${limits.maxFiles} files`);
+        }
+        if (bytes > limits.maxBytes) {
+            throw sourceTooLarge(formatBytes(bytes), formatBytes(limits.maxBytes));
+        }
+        const full = safeJoin(root, name);
+        await mkdir(dirname(full), { recursive: true });
+        const mode = (parseOctal(head, 100, 8) & 0o111) !== 0 ? 0o755 : 0o644;
+        await writeFile(full, data, { mode });
+    }
+    return { fileCount, bytes };
+}
+function readName(head) {
+    const name = cstring(head, 0, 100);
+    const prefix = cstring(head, 345, 155);
+    return prefix ? `${prefix}/${name}` : name;
+}
+function cstring(buf, offset, length) {
+    const slice = buf.subarray(offset, offset + length);
+    const nul = slice.indexOf(0);
+    return slice.subarray(0, nul === -1 ? slice.length : nul).toString('utf8');
+}
+function isZeroBlock(block) {
+    for (const byte of block)
+        if (byte !== 0)
+            return false;
+    return true;
+}
+function verifyChecksum(head) {
+    const declared = parseOctal(head, 148, 8);
+    let sum = 0;
+    for (let i = 0; i < BLOCK; i += 1) {
+        // chksum の 8 バイトは空白として数える約束
+        sum += i >= 148 && i < 156 ? 0x20 : (head[i] ?? 0);
+    }
+    if (sum !== declared) {
+        throw sourceInvalidArchive('a tar header failed its checksum; the upload is corrupt');
+    }
+}
+function parseOctal(buf, offset, length) {
+    const text = cstring(buf, offset, length).trim();
+    if (text === '')
+        return 0;
+    const value = Number.parseInt(text, 8);
+    if (!Number.isFinite(value) || value < 0) {
+        throw sourceInvalidArchive('a tar header contains a malformed numeric field');
+    }
+    return value;
+}
+/**
+ * アーカイブ内のパスを展開先へ落とす。
+ * 少しでも根の外を指しうるものは、直せる形のエラーにして拒否する。
+ */
+function safeJoin(root, name) {
+    const cleaned = name.replace(/\\/g, '/');
+    if (cleaned === '' || cleaned.startsWith('/') || /^[a-zA-Z]:/.test(cleaned)) {
+        throw sourceInvalidArchive(`the archive contains an absolute path (${name})`);
+    }
+    const segments = cleaned.split('/').filter((s) => s !== '' && s !== '.');
+    if (segments.some((s) => s === '..')) {
+        throw sourceInvalidArchive(`the archive contains a path that escapes the root (${name})`);
+    }
+    if (segments.some((s) => s.includes('\0'))) {
+        throw sourceInvalidArchive(`the archive contains a path with a NUL byte (${name})`);
+    }
+    if (segments.length === 0) {
+        throw sourceInvalidArchive(`the archive contains an entry with no usable name (${name})`);
+    }
+    const full = resolve(root, ...segments);
+    // ここまでで弾けているはずだが、最後にもう一度確かめる。安いので確かめる
+    if (full !== root && !full.startsWith(root + sep)) {
+        throw sourceInvalidArchive(`the archive contains a path that escapes the root (${name})`);
+    }
+    return full;
+}
+export function formatBytes(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+//# sourceMappingURL=source-archive.js.map

package/dist/source-archive.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,95 @@
+/**
+ * リソースモデルと Change 型（P0設計 §5.2 / §5.3）
+ */
+/**
+ * P0 で扱うリソース種別。
+ * Storage は P0 スコープ外（D9）。Realtime / Queue は P2。
+ */
+export declare const RESOURCE_KINDS: readonly ["compute", "database", "auth", "push", "email", "sms"];
+export type ResourceKind = (typeof RESOURCE_KINDS)[number];
+export type ResourceStatus = 'creating' | 'ready' | 'failed' | 'deleting';
+/**
+ * リソースの自然キー。
+ * Control Plane DB の UNIQUE (environment_id, kind, logical_name) と対応し、
+ * これが冪等性（PE-1）の実装上の担保になる。
+ */
+export declare function resourceKey(kind: ResourceKind, logicalName: string): string;
+/** 単一リソースしか持たない種別で使う既定の論理名 */
+export declare const DEFAULT_LOGICAL_NAME = "default";
+/**
+ * actual state — Control Plane DB の resources テーブル1行に対応する。
+ * TState はアダプタが自由に定義する（プロバイダ側のIDや設定を入れる）。
+ */
+export interface ResourceRecord<TState = unknown> {
+    id: string;
+    environmentId: string;
+    kind: ResourceKind;
+    logicalName: string;
+    /** 'docker' | 'neon' | 'twilio' | 'ses' ... */
+    provider: string;
+    /** プロバイダ側のID。作成前は null */
+    externalId: string | null;
+    state: TState;
+    status: ResourceStatus;
+}
+export type ChangeAction = 'create' | 'update' | 'destroy' | 'noop';
+/** plan の差分表示用。人間にもエージェントにも読ませる */
+export interface FieldDiff {
+    path: string;
+    before: unknown;
+    after: unknown;
+}
+/**
+ * 1リソースに対する1操作。
+ * Executor はこれを依存順に実行し、1件ごとに DB へコミットする（PE-3）。
+ */
+export interface Change<TSpec = unknown> {
+    /** resourceKey(kind, logicalName) と一致する自然キー */
+    key: string;
+    action: ChangeAction;
+    kind: ResourceKind;
+    logicalName: string;
+    provider: string;
+    /** desired spec。destroy の場合は null */
+    spec: TSpec | null;
+    /** 依存する他 Change の key。トポロジカルソートに使う（PE-2） */
+    dependsOn: string[];
+    /**
+     * データ喪失を伴うか。
+     * true の場合 --allow-destructive なしでは Planner が拒否する（PE-4）
+     */
+    destructive: boolean;
+    /** plan 出力に出す1行説明 */
+    summary: string;
+    diff?: FieldDiff[];
+}
+/** plan の結果全体 */
+export interface Plan {
+    changes: Change[];
+    /** 依存順に並べ替え済みか */
+    ordered: boolean;
+    /** destructive な Change の key 一覧 */
+    destructiveKeys: string[];
+}
+export declare function isNoop(plan: Plan): boolean;
+/** 自己検証API（§5.10）の1項目 */
+export interface VerifyCheck {
+    name: string;
+    ok: boolean;
+    durationMs?: number;
+    /** 失敗時のみ。SuperzeroError.toJSON() の形 */
+    error?: unknown;
+    /**
+     * 実施しなかった理由。設定上そもそも確認できない場合に入る。
+     *
+     * ★ 実施できないチェックを黙って一覧から消してはいけない。
+     *   消すと「全部緑だった」に見え、確認していない範囲が
+     *   確認済みとして扱われる。ok は true にせず、理由を書いて残す。
+     */
+    skipped?: string;
+}
+export interface VerifyResult {
+    ok: boolean;
+    checks: VerifyCheck[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,eAAO,MAAM,cAAc,kEAAmE,CAAA;AAC9F,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAA;AAE1D,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,CAAA;AAEzE;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAE3E;AAED,8BAA8B;AAC9B,eAAO,MAAM,oBAAoB,YAAY,CAAA;AAE7C;;;GAGG;AACH,MAAM,WAAW,cAAc,CAAC,MAAM,GAAG,OAAO;IAC9C,EAAE,EAAE,MAAM,CAAA;IACV,aAAa,EAAE,MAAM,CAAA;IACrB,IAAI,EAAE,YAAY,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;IACnB,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAA;IAChB,0BAA0B;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,cAAc,CAAA;CACvB;AAED,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAA;AAEnE,mCAAmC;AACnC,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,OAAO,CAAA;IACf,KAAK,EAAE,OAAO,CAAA;CACf;AAED;;;GAGG;AACH,MAAM,WAAW,MAAM,CAAC,KAAK,GAAG,OAAO;IACrC,+CAA+C;IAC/C,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,YAAY,CAAA;IACpB,IAAI,EAAE,YAAY,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,qCAAqC;IACrC,IAAI,EAAE,KAAK,GAAG,IAAI,CAAA;IAClB,4CAA4C;IAC5C,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB;;;OAGG;IACH,WAAW,EAAE,OAAO,CAAA;IACpB,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,SAAS,EAAE,CAAA;CACnB;AAED,iBAAiB;AACjB,MAAM,WAAW,IAAI;IACnB,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,kBAAkB;IAClB,OAAO,EAAE,OAAO,CAAA;IAChB,oCAAoC;IACpC,eAAe,EAAE,MAAM,EAAE,CAAA;CAC1B;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAE1C;AAED,yBAAyB;AACzB,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,OAAO,CAAA;IACX,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,uCAAuC;IACvC,KAAK,CAAC,EAAE,OAAO,CAAA;IACf;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,OAAO,CAAA;IACX,MAAM,EAAE,WAAW,EAAE,CAAA;CACtB"}

package/dist/types.js

@@ -0,0 +1,22 @@
+/**
+ * リソースモデルと Change 型（P0設計 §5.2 / §5.3）
+ */
+/**
+ * P0 で扱うリソース種別。
+ * Storage は P0 スコープ外（D9）。Realtime / Queue は P2。
+ */
+export const RESOURCE_KINDS = ['compute', 'database', 'auth', 'push', 'email', 'sms'];
+/**
+ * リソースの自然キー。
+ * Control Plane DB の UNIQUE (environment_id, kind, logical_name) と対応し、
+ * これが冪等性（PE-1）の実装上の担保になる。
+ */
+export function resourceKey(kind, logicalName) {
+    return `${kind}:${logicalName}`;
+}
+/** 単一リソースしか持たない種別で使う既定の論理名 */
+export const DEFAULT_LOGICAL_NAME = 'default';
+export function isNoop(plan) {
+    return plan.changes.every((c) => c.action === 'noop');
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAU,CAAA;AAK9F;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,IAAkB,EAAE,WAAmB;IACjE,OAAO,GAAG,IAAI,IAAI,WAAW,EAAE,CAAA;AACjC,CAAC;AAED,8BAA8B;AAC9B,MAAM,CAAC,MAAM,oBAAoB,GAAG,SAAS,CAAA;AA8D7C,MAAM,UAAU,MAAM,CAAC,IAAU;IAC/B,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAA;AACvD,CAAC"}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@superzerodev/core",
+  "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__"
+  ],
+  "description": "Core model for Superzero: normalized errors, resources, planner and executor.",
+  "license": "UNLICENSED",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mashihara/superzero.git",
+    "directory": "packages/core"
+  },
+  "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\""
+  }
+}