@percher/core 0.4.0 → 0.4.1

package/dist/commands/migrate-supabase-schema.js

@@ -0,0 +1,321 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import { isAbsolute, join, relative, resolve } from "node:path";
+import { z } from "zod";
+import { recoveryAsk, recoveryNone, } from "../recovery";
+import { inspectSupabase, } from "./migrate-supabase";
+import { mapSupabaseToPocketBase } from "./migrate-supabase-map";
+import { generateDataImportScripts } from "./migrate-supabase-scripts";
+/**
+ * FUTURE9 Phase B chunk 2 — schema migration write step.
+ *
+ * Wires Phase A (`inspectSupabase`) + Phase B chunk 1
+ * (`mapSupabaseToPocketBase`) together and writes the preview files
+ * to a sibling directory the user can inspect before committing to
+ * the full migration (Phases C–D).
+ *
+ * Dry-run / apply contract (locked in STATUS_FUTURE9_phase-a.md):
+ *   - Phase A (`inspectSupabase`) — strictly read-only, no writes.
+ *   - Phase B (this command) — writes to ./migration-preview/ by
+ *     default. The sibling dir IS the dry-run posture relative to
+ *     a future `--apply` flag (Phase C/D) that will write to
+ *     project root.
+ *   - `outputDir` override exists for CI/tests/users who already
+ *     have a `./migration-preview/` they care about.
+ *
+ * Token stays on the user's machine — same invariant as Phase A.
+ * The Supabase PAT is forwarded straight into `inspectSupabase`,
+ * which calls api.supabase.com directly; we never round-trip it
+ * through Percher's wire.
+ */
+export const migrateSupabaseSchemaInputSchema = z.object({
+    projectRef: z
+        .string()
+        .min(1, "projectRef is required")
+        .describe("Supabase project reference (the 20-char id from the project URL — e.g. `abcdefghijklmnopqrst`)."),
+    token: z
+        .string()
+        .min(1, "token is required")
+        .describe("Supabase personal access token (sbp_...). Never leaves the user's machine — sent directly to api.supabase.com."),
+    outputDir: z
+        .string()
+        .optional()
+        .describe("Directory to write `pb_schema.json` and `MIGRATION_NOTES.md` to. Relative paths resolve against ctx.cwd. Defaults to `./migration-preview/`."),
+});
+export async function migrateSupabaseSchema(ctx, input) {
+    const outputDirAbs = resolveOutputDir(ctx.cwd, input.outputDir);
+    const outputDirRel = relative(ctx.cwd, outputDirAbs) || ".";
+    ctx.status(`Inspecting Supabase project ${input.projectRef}...`);
+    const inspection = await inspectSupabase(ctx, {
+        projectRef: input.projectRef,
+        token: input.token,
+    });
+    if (inspection.status === "failed") {
+        return {
+            status: "failed",
+            projectRef: input.projectRef,
+            outputDir: outputDirAbs,
+            filesWritten: [],
+            preview: null,
+            recovery: inspection.recovery,
+            summary: inspection.summary,
+            error: inspection.error,
+        };
+    }
+    ctx.status("Mapping Supabase schema → PocketBase collections...");
+    const preview = mapSupabaseToPocketBase(inspection);
+    ctx.status(`Writing preview to ${outputDirRel}/...`);
+    let filesWritten;
+    try {
+        filesWritten = await writePreviewFiles(ctx, outputDirAbs, preview);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            status: "failed",
+            projectRef: input.projectRef,
+            outputDir: outputDirAbs,
+            filesWritten: [],
+            preview,
+            recovery: recoveryAsk({
+                prompt: `Couldn't write the migration preview to ${outputDirRel}/: ${message}. Check the directory is writeable and re-run the same command.`,
+                reasonCode: "unknown",
+                retryable: true,
+            }),
+            summary: `Inspection succeeded; preview write to ${outputDirRel}/ failed: ${message}`,
+            error: {
+                code: "write_failed",
+                title: "Couldn't write migration preview",
+                explanation: `Writing the preview files under ${outputDirAbs} failed: ${message}.`,
+                suggestion: `Check the directory is writeable (or pick a different one with --output-dir). Inspection data is intact — re-run after fixing.`,
+            },
+        };
+    }
+    const summary = renderSummary({
+        projectRef: input.projectRef,
+        outputDirRel,
+        inspection,
+        preview,
+    });
+    return {
+        status: "ok",
+        projectRef: input.projectRef,
+        outputDir: outputDirAbs,
+        filesWritten,
+        preview,
+        recovery: recoveryNone(),
+        summary,
+    };
+}
+function resolveOutputDir(cwd, requested) {
+    const raw = requested ?? "./migration-preview";
+    return isAbsolute(raw) ? raw : resolve(cwd, raw);
+}
+async function writePreviewFiles(ctx, outputDir, preview) {
+    await mkdir(outputDir, { recursive: true });
+    // Pre-render every file's content in memory first, THEN write. If
+    // the renderer throws on a malformed input we don't leave a half-
+    // populated preview dir behind.
+    const schemaJson = renderSchemaJson(preview);
+    const notesMd = renderMigrationNotes(preview);
+    const scripts = generateDataImportScripts(preview);
+    const schemaPath = join(outputDir, "pb_schema.json");
+    const notesPath = join(outputDir, "MIGRATION_NOTES.md");
+    const migratePath = join(outputDir, "pb_migrate.js");
+    const storagePath = join(outputDir, "pb_migrate_storage.js");
+    await writeFile(schemaPath, schemaJson, "utf8");
+    await writeFile(notesPath, notesMd, "utf8");
+    await writeFile(migratePath, scripts.pbMigrate, "utf8");
+    const written = [
+        relative(ctx.cwd, schemaPath),
+        relative(ctx.cwd, notesPath),
+        relative(ctx.cwd, migratePath),
+    ];
+    if (scripts.pbMigrateStorage !== null) {
+        await writeFile(storagePath, scripts.pbMigrateStorage, "utf8");
+        written.push(relative(ctx.cwd, storagePath));
+    }
+    return written;
+}
+/**
+ * The schema JSON is the import-target for a future `percher data
+ * import-schema` command. Shape mirrors PocketBase's
+ * collection-create payload with Percher-internal provenance
+ * fields (`sourceTable`, `source.postgresType`, etc.) — the
+ * importer can strip those before posting to PB's admin API.
+ *
+ * Pretty-printed with 2-space indent so the file is diff-friendly
+ * if the user keeps it under version control.
+ */
+function renderSchemaJson(preview) {
+    return `${JSON.stringify({
+        sourceProjectRef: preview.sourceProjectRef,
+        generatedAt: preview.generatedAt,
+        collections: preview.collections,
+        summary: preview.summary,
+    }, null, 2)}\n`;
+}
+/**
+ * Markdown report the user reads before deciding to commit. Sections
+ * follow the example in the FUTURE9 plan (Steg 2):
+ *   1. Header (projectRef, when generated, totals)
+ *   2. Collections — one block per mapped table
+ *   3. RLS policies — Supabase original + suggested PB rule (or MANUAL)
+ *   4. Unsupported items — every thing the mapper refused to guess at
+ *   5. Auth / storage notes
+ *
+ * Stable wording — tests snapshot-compare. Don't reword on a whim;
+ * change the test if you do.
+ */
+export function renderMigrationNotes(preview) {
+    const lines = [];
+    lines.push("# Supabase → Percher migration preview");
+    lines.push("");
+    lines.push(`- **Source project:** \`${preview.sourceProjectRef}\``);
+    lines.push(`- **Generated at:** ${preview.generatedAt}`);
+    lines.push(`- **Collections:** ${preview.summary.collectionCount}`);
+    lines.push(`- **Fields:** ${preview.summary.fieldCount}`);
+    lines.push(`- **Relation fields:** ${preview.summary.relationFieldCount}`);
+    lines.push(`- **RLS policies:** ${preview.summary.rlsPolicyCount} (${preview.summary.manualRlsPolicyCount} need manual review)`);
+    lines.push(`- **Unsupported items:** ${preview.summary.unsupportedCount}`);
+    lines.push("");
+    lines.push("> This file is generated by `bunx percher migrate-from-supabase`. It is a **preview** — nothing has been written to your PocketBase yet. Review every section below before running the eventual import step.");
+    lines.push("");
+    lines.push("## Running the data import");
+    lines.push("");
+    lines.push("The companion `pb_migrate.js` script copies rows from your Supabase project into PocketBase. It reads credentials from env vars only — no secrets are baked into the generated source.");
+    lines.push("");
+    lines.push("```bash");
+    lines.push("# 1. Install the runtime deps the script imports.");
+    lines.push("bun add pocketbase @supabase/supabase-js");
+    lines.push("");
+    lines.push("# 2. Provide credentials (use a service-role key — never bake it into source).");
+    lines.push("export POCKETBASE_URL=https://<your-app>.percher.run/_/");
+    lines.push("export POCKETBASE_ADMIN_EMAIL=...");
+    lines.push("export POCKETBASE_ADMIN_PASSWORD=...");
+    lines.push("export SUPABASE_URL=https://<ref>.supabase.co");
+    lines.push("export SUPABASE_SERVICE_ROLE_KEY=...");
+    lines.push("");
+    lines.push("# 3. Dry-run posture: the script lives under ./migration-preview/.");
+    lines.push("#    Inspect it first, then run.");
+    lines.push("bun ./migration-preview/pb_migrate.js");
+    lines.push("");
+    lines.push("# Optional: skip rows that already exist in PB (default is fail-fast on duplicate PK).");
+    lines.push("SKIP_EXISTING=1 bun ./migration-preview/pb_migrate.js");
+    lines.push("```");
+    lines.push("");
+    if (preview.migrationNotes.storageMigration !== null) {
+        lines.push("A second script — `pb_migrate_storage.js` — downloads every file in each Supabase storage bucket. The upload side is MANUAL because PocketBase's record-attached-file model doesn't map cleanly onto Supabase's bucket model; the script gives you the bytes + path and a clear hand-off comment. See the script's top docstring.");
+        lines.push("");
+    }
+    lines.push("## Collections");
+    lines.push("");
+    if (preview.collections.length === 0) {
+        lines.push("_No user-schema tables were found in the source project._");
+        lines.push("");
+    }
+    else {
+        for (const collection of preview.collections) {
+            lines.push(`### \`${collection.name}\``);
+            lines.push("");
+            lines.push(`- **Source table:** \`${collection.sourceTable}\``);
+            lines.push(`- **PocketBase type:** \`${collection.type}\``);
+            lines.push(`- **Fields:** ${collection.schema.length}`);
+            lines.push("");
+            if (collection.schema.length === 0) {
+                lines.push("_(No user-defined fields. PB built-in `id`/`created`/`updated` cover this collection.)_");
+                lines.push("");
+            }
+            else {
+                lines.push("| Field | Type | Required | Postgres source | Flag |");
+                lines.push("|---|---|---|---|---|");
+                for (const field of collection.schema) {
+                    const target = field.type === "relation"
+                        ? `relation → \`${field.options.collectionName}\``
+                        : field.type;
+                    lines.push(`| \`${field.name}\` | ${target} | ${field.required ? "yes" : "no"} | \`${field.source.postgresType}\` | ${field.source.flag ? `\`${field.source.flag}\`` : "—"} |`);
+                }
+                lines.push("");
+            }
+            lines.push("> PocketBase API rules default to `null` (most-restrictive). See the RLS section below for the original Supabase policies and suggested rewrites — paste them into PB's collection admin once you've reviewed each one.");
+            lines.push("");
+        }
+    }
+    lines.push("## RLS policies");
+    lines.push("");
+    if (preview.migrationNotes.rlsPolicies.length === 0) {
+        lines.push("_No row-level-security policies were found in the source project._");
+        lines.push("");
+    }
+    else {
+        for (const policy of preview.migrationNotes.rlsPolicies) {
+            lines.push(`### \`${policy.table}\` · policy \`${policy.policyName}\` (${policy.command})`);
+            lines.push("");
+            lines.push("**Original (Supabase Postgres):**");
+            lines.push("");
+            lines.push("```");
+            lines.push(`USING:      ${policy.originalUsing ?? "(none)"}`);
+            lines.push(`WITH CHECK: ${policy.originalWithCheck ?? "(none)"}`);
+            lines.push("```");
+            lines.push("");
+            if (policy.manual) {
+                lines.push("**Suggested PocketBase API rule:** _MANUAL_");
+                lines.push("");
+                lines.push("The rewriter only recognises the canonical `auth.uid() = <column>` pattern. This policy is more complex (function calls, boolean combinators, subqueries, casts, etc.) — translate it by hand. PB API rules use a different mental model than SQL RLS: see https://pocketbase.io/docs/api-rules-and-filters/.");
+            }
+            else {
+                lines.push("**Suggested PocketBase API rule (verify before pasting):**");
+                lines.push("");
+                lines.push("```");
+                lines.push(policy.suggestedRule ?? "");
+                lines.push("```");
+                lines.push("");
+                lines.push("The above is a best-effort rewrite of the canonical `auth.uid() = <column>` pattern. PB rules don't have direct equivalents for SQL operators on related tables; verify against your auth model before deploying.");
+            }
+            lines.push("");
+        }
+    }
+    lines.push("## Unsupported / flagged items");
+    lines.push("");
+    if (preview.migrationNotes.unsupported.length === 0) {
+        lines.push("_Nothing flagged. The schema mapped cleanly._");
+        lines.push("");
+    }
+    else {
+        for (const item of preview.migrationNotes.unsupported) {
+            lines.push(`### \`${item.source}\` — ${item.kind}`);
+            lines.push("");
+            lines.push(item.reason);
+            lines.push("");
+            lines.push(`**Suggestion:** ${item.suggestion}`);
+            lines.push("");
+        }
+    }
+    if (preview.migrationNotes.authMigration) {
+        lines.push("## Auth migration");
+        lines.push("");
+        lines.push(`Source has **${preview.migrationNotes.authMigration.userCount}** auth user${preview.migrationNotes.authMigration.userCount === 1 ? "" : "s"}.`);
+        lines.push("");
+        lines.push(preview.migrationNotes.authMigration.note);
+        lines.push("");
+    }
+    if (preview.migrationNotes.storageMigration) {
+        lines.push("## Storage migration");
+        lines.push("");
+        lines.push(`Source has **${preview.migrationNotes.storageMigration.buckets.length}** storage bucket${preview.migrationNotes.storageMigration.buckets.length === 1 ? "" : "s"}: ${preview.migrationNotes.storageMigration.buckets.map((b) => `\`${b}\``).join(", ")}.`);
+        lines.push("");
+        lines.push(preview.migrationNotes.storageMigration.note);
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+function renderSummary(args) {
+    const counts = args.preview.summary;
+    return [
+        `Wrote migration preview for Supabase project ${args.projectRef} to ${args.outputDirRel}/.`,
+        `${counts.collectionCount} collection${counts.collectionCount === 1 ? "" : "s"} (${counts.fieldCount} fields, ${counts.relationFieldCount} relations),`,
+        `${counts.rlsPolicyCount} RLS polic${counts.rlsPolicyCount === 1 ? "y" : "ies"} (${counts.manualRlsPolicyCount} need manual review),`,
+        `${counts.unsupportedCount} flagged item${counts.unsupportedCount === 1 ? "" : "s"}.`,
+        "Review `MIGRATION_NOTES.md` before running the import step.",
+    ].join(" ");
+}
+//# sourceMappingURL=migrate-supabase-schema.js.map

package/dist/commands/migrate-supabase-schema.js.map

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

package/dist/commands/migrate-supabase-scripts.d.ts

@@ -0,0 +1,64 @@
+import type { MigrationPreview } from "./migrate-supabase-map";
+/**
+ * FUTURE9 Phase C — data-import script generator.
+ *
+ * Pure function: takes the Phase B `MigrationPreview` and emits the
+ * JavaScript source of two scripts the user runs to actually copy
+ * their data over:
+ *
+ *   - `pb_migrate.js` — iterates every collection in FK-dependency
+ *     order, batches 500 rows at a time from Supabase, and creates
+ *     them in PocketBase. Reads credentials from env vars only —
+ *     no secrets baked in.
+ *   - `pb_migrate_storage.js` — (only when the source has storage
+ *     buckets) lists + downloads files from each bucket. The upload
+ *     side is left MANUAL because Supabase's bucket-shape doesn't
+ *     map cleanly to PB's record-attached-file model; the script
+ *     gives the user the bytes + path and a clear hand-off comment.
+ *
+ * Why pure: the generated JS goes through the same write-step path
+ * as the Phase B preview files (`pb_schema.json`,
+ * `MIGRATION_NOTES.md`) — see `writePreviewFiles` in
+ * migrate-supabase-schema.ts. Keeping the generator I/O-free means
+ * tests can pin the exact source byte-for-byte without disk.
+ *
+ * Safety invariants pinned by tests:
+ *
+ *   - Generated scripts read credentials from env vars only. No
+ *     hardcoded URLs, no PAT, no service-role key.
+ *   - `pb_migrate.js` fails fast on missing env vars BEFORE making
+ *     any network call. A misconfigured run can't half-import.
+ *   - Table order is topologically sorted by foreign-key edges.
+ *     Cycles are detected (Postgres allows deferred FKs; PB doesn't)
+ *     and reported in `cyclicTables` so the user can break them
+ *     manually instead of getting a runtime FK-violation.
+ *   - The default behavior is fail-fast on duplicate-PK insert.
+ *     Users opt into skip-on-conflict by setting `SKIP_EXISTING=1`
+ *     in the env. Documented in MIGRATION_NOTES.md (separate step
+ *     in the Phase B renderer).
+ */
+export interface DataImportScripts {
+    /** `pb_migrate.js` source. Always present, even if `preview.collections` is empty (header + admin auth still useful as a smoke test). */
+    pbMigrate: string;
+    /** `pb_migrate_storage.js` source. Null when the source project has no storage buckets. */
+    pbMigrateStorage: string | null;
+    /** Collection names that participate in an FK cycle and couldn't be topologically sorted. Empty when the graph is acyclic. */
+    cyclicTables: string[];
+    /** Final order the generated script migrates collections in. Independent tables first, dependent tables after. Cyclic-set tables come last, in their original input order. */
+    tableOrder: string[];
+}
+/**
+ * Generate the data-import scripts for a Phase B migration preview.
+ * Pure — no I/O. Deterministic — identical input gives byte-identical
+ * scripts.
+ */
+export declare function generateDataImportScripts(preview: MigrationPreview): DataImportScripts;
+/**
+ * Convenience exposed for the Phase B Markdown renderer. Returns the
+ * env-var names the generated `pb_migrate.js` requires — kept in
+ * sync with `REQUIRED_ENV` inside the script by reading the same
+ * source-of-truth array.
+ */
+export declare const PB_MIGRATE_REQUIRED_ENV: readonly ["POCKETBASE_URL", "POCKETBASE_ADMIN_EMAIL", "POCKETBASE_ADMIN_PASSWORD", "SUPABASE_URL", "SUPABASE_SERVICE_ROLE_KEY"];
+export declare const PB_MIGRATE_OPTIONAL_ENV: readonly ["SKIP_EXISTING", "BATCH_SIZE"];
+//# sourceMappingURL=migrate-supabase-scripts.d.ts.map

package/dist/commands/migrate-supabase-scripts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate-supabase-scripts.d.ts","sourceRoot":"","sources":["../../src/commands/migrate-supabase-scripts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAGjB,MAAM,wBAAwB,CAAC;AAEhC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,MAAM,WAAW,iBAAiB;IAChC,yIAAyI;IACzI,SAAS,EAAE,MAAM,CAAC;IAClB,2FAA2F;IAC3F,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,8HAA8H;IAC9H,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,8KAA8K;IAC9K,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,gBAAgB,GAAG,iBAAiB,CAqBtF;AAklBD;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,iIAM1B,CAAC;AAEX,eAAO,MAAM,uBAAuB,0CAA2C,CAAC"}