@percher/core 0.4.10 → 0.4.11

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

@@ -0,0 +1,234 @@
+import { posix } from "node:path";
+import jscodeshift, {} from "jscodeshift";
+/**
+ * Phase C — auto PocketBase client + import insertion.
+ *
+ * After the rewriter converts call sites to `pb.*`, those files reference a
+ * `pb` client that doesn't exist yet (the dangling-pb FAIL the status doctor
+ * reports). This closes that gap mechanically:
+ *
+ *   1. Generate a PARALLEL client module (`src/lib/pocketbase.<ext>`) — a
+ *      NEW file, never a rewrite of the existing Supabase client. Other files
+ *      (untouched storage/rpc/realtime call sites) may still import the old
+ *      `supabase` client; clobbering it would break them and contradicts the
+ *      hybrid model. The old module is left intact and flagged "delete once
+ *      everything's migrated".
+ *   2. Insert `import { pb } from "<relative path>"` into each rewritten file
+ *      that references `pb` without a binding.
+ *
+ * Skips creating a module silently when the project already exports a `pb`
+ * client (imports point at the existing one instead). Everything here is a
+ * "working default" — boilerplate the user may tweak — not a guess at their
+ * exact config.
+ */
+const tsx = jscodeshift.withParser("tsx");
+const CLIENT_FACTORIES = new Set(["createClient", "createBrowserClient", "createServerClient"]);
+export function scaffoldPocketBaseClient(input) {
+    const pbName = input.pbIdentifier ?? "pb";
+    const codeFiles = input.files.filter((f) => f.kind === "code");
+    const flags = [];
+    // Flag the existing Supabase client module(s) for eventual deletion.
+    for (const file of codeFiles) {
+        if (isSupabaseClientModule(file.source)) {
+            flags.push({
+                file: file.relativePath,
+                kind: "manual_review",
+                pattern: "supabase.client_module",
+                note: "This module sets up the Supabase client. It's kept while any Supabase call remains; once everything is migrated to PocketBase, delete it and the imports that reference it.",
+            });
+        }
+    }
+    // If a pb client already exists, import from it instead of generating one.
+    const existing = codeFiles.find((f) => exportsBinding(f.rewritten, pbName));
+    let targetRelNoExt;
+    let clientModule = null;
+    let skippedReason;
+    if (existing) {
+        targetRelNoExt = stripExt(existing.relativePath);
+        skippedReason = "pb_client_exists";
+    }
+    else {
+        const ext = pickExtension(codeFiles);
+        const baseNoExt = pickModuleBase(codeFiles);
+        const targetRel = `${baseNoExt}.${ext}`;
+        // Collision with a non-pb-client file at the exact path → don't clobber.
+        if (input.files.some((f) => f.relativePath === targetRel)) {
+            flags.push({
+                file: targetRel,
+                kind: "manual_review",
+                pattern: "scaffold.path_taken",
+                note: `Couldn't auto-create a PocketBase client — \`${targetRel}\` already exists. Create one that exports \`${pbName}\` and import it in the rewritten files.`,
+            });
+            return {
+                clientModule: null,
+                importInsertions: new Map(),
+                flags,
+                skippedReason: "target_path_taken",
+            };
+        }
+        targetRelNoExt = baseNoExt;
+        clientModule = { relativePath: targetRel, content: renderClientModule(pbName, codeFiles) };
+    }
+    // Insert the import into every changed file that references pb without a binding.
+    const importInsertions = new Map();
+    const changed = new Set(input.changedRelPaths);
+    for (const file of codeFiles) {
+        if (!changed.has(file.relativePath))
+            continue;
+        if (file.relativePath === clientModule?.relativePath)
+            continue; // never self-import
+        if (!referencesUnboundIdentifier(file.rewritten, pbName))
+            continue;
+        const importPath = computeImportPath(file.relativePath, targetRelNoExt);
+        const next = insertNamedImport(file.rewritten, pbName, importPath);
+        if (next !== null)
+            importInsertions.set(file.relativePath, next);
+    }
+    return { clientModule, importInsertions, flags, ...(skippedReason ? { skippedReason } : {}) };
+}
+/** PocketBase client module body. Accessor matches the project shape. */
+function renderClientModule(pbName, codeFiles) {
+    const usesViteEnv = codeFiles.some((f) => f.source.includes("import.meta.env"));
+    const accessor = usesViteEnv
+        ? "import.meta.env.VITE_POCKETBASE_URL"
+        : "process.env.POCKETBASE_URL";
+    return [
+        'import PocketBase from "pocketbase";',
+        "",
+        "// Percher injects the PocketBase URL at deploy time. This is a working",
+        "// default — adjust the URL accessor to match your framework if needed.",
+        `export const ${pbName} = new PocketBase(${accessor});`,
+        "",
+    ].join("\n");
+}
+/** `ts` if the project has any TS file, else `js`. */
+function pickExtension(codeFiles) {
+    return codeFiles.some((f) => f.relativePath.endsWith(".ts") || f.relativePath.endsWith(".tsx"))
+        ? "ts"
+        : "js";
+}
+/** Where to place the generated module — under src/ when the project uses it. */
+function pickModuleBase(codeFiles) {
+    const hasSrc = codeFiles.some((f) => f.relativePath.startsWith("src/"));
+    return hasSrc ? "src/lib/pocketbase" : "lib/pocketbase";
+}
+function stripExt(relPath) {
+    const dot = relPath.lastIndexOf(".");
+    return dot > relPath.lastIndexOf("/") ? relPath.slice(0, dot) : relPath;
+}
+/** Relative, extensionless import specifier from one file to the module. */
+function computeImportPath(fromFileRel, targetRelNoExt) {
+    let rel = posix.relative(posix.dirname(fromFileRel), targetRelNoExt);
+    if (!rel.startsWith("."))
+        rel = `./${rel}`;
+    return rel;
+}
+/** Insert `import { name } from "spec"` at the top of the file. Returns the
+ *  new source, or null if it couldn't parse (caller leaves the file as-is). */
+function insertNamedImport(source, name, spec) {
+    let root;
+    try {
+        root = tsx(source);
+    }
+    catch {
+        return null;
+    }
+    const decl = jscodeshift.importDeclaration([jscodeshift.importSpecifier(jscodeshift.identifier(name))], jscodeshift.literal(spec));
+    const program = root.get().node.program;
+    program.body.unshift(decl);
+    return root.toSource({ quote: "double" });
+}
+/** True when `name` is read as a member object (`name.x`) but never bound. */
+function referencesUnboundIdentifier(source, name) {
+    let root;
+    try {
+        root = tsx(source);
+    }
+    catch {
+        return false;
+    }
+    let declared = false;
+    root.find(jscodeshift.ImportDeclaration).forEach((p) => {
+        for (const spec of p.node.specifiers ?? []) {
+            if (spec.local?.name === name)
+                declared = true;
+        }
+    });
+    root.find(jscodeshift.VariableDeclarator).forEach((p) => {
+        if (p.node.id.type === "Identifier" && p.node.id.name === name) {
+            declared = true;
+        }
+    });
+    let used = false;
+    root.find(jscodeshift.MemberExpression).forEach((p) => {
+        const obj = p.node.object;
+        if (obj.type === "Identifier" && obj.name === name)
+            used = true;
+    });
+    return used && !declared;
+}
+/** True when the module exports a binding named `name` (the existing pb client). */
+function exportsBinding(source, name) {
+    if (!source.includes(`export`) || !source.includes(name))
+        return false;
+    let root;
+    try {
+        root = tsx(source);
+    }
+    catch {
+        return false;
+    }
+    let found = false;
+    root.find(jscodeshift.ExportNamedDeclaration).forEach((p) => {
+        const node = p.node;
+        // export const name = ...
+        if (node.declaration?.type === "VariableDeclaration") {
+            for (const d of node.declaration.declarations) {
+                if (d.type === "VariableDeclarator" &&
+                    d.id.type === "Identifier" &&
+                    d.id.name === name) {
+                    found = true;
+                }
+            }
+        }
+        // export { name } / export { x as name }
+        for (const spec of node.specifiers ?? []) {
+            const exported = spec.exported;
+            if (exported?.type === "Identifier" && exported.name === name) {
+                found = true;
+            }
+        }
+    });
+    return found;
+}
+/** True when the file imports `@supabase/*` AND calls a client factory — i.e.
+ *  it's a Supabase client-setup module, not just a consumer. */
+function isSupabaseClientModule(source) {
+    if (!source.includes("@supabase/"))
+        return false;
+    let root;
+    try {
+        root = tsx(source);
+    }
+    catch {
+        return false;
+    }
+    let importsSupabase = false;
+    root.find(jscodeshift.ImportDeclaration).forEach((p) => {
+        const src = p.node.source.value;
+        if (typeof src === "string" && src.startsWith("@supabase/"))
+            importsSupabase = true;
+    });
+    if (!importsSupabase)
+        return false;
+    let callsFactory = false;
+    root.find(jscodeshift.CallExpression).forEach((p) => {
+        const callee = p.node.callee;
+        if (callee.type === "Identifier" &&
+            CLIENT_FACTORIES.has(callee.name)) {
+            callsFactory = true;
+        }
+    });
+    return callsFactory;
+}
+//# sourceMappingURL=migrate-supabase-scaffold.js.map

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

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

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

@@ -1,8 +1,8 @@
 import { z } from "zod";
-import type { Context } from "../context";
-import { type AskUserRecovery, type NoneRecovery, type ToolRecovery } from "../recovery";
-import { type InspectSupabaseError } from "./migrate-supabase";
-import { type MigrationPreview } from "./migrate-supabase-map";
+import type { Context } from "../context.js";
+import { type AskUserRecovery, type NoneRecovery, type ToolRecovery } from "../recovery.js";
+import { type InspectSupabaseError } from "./migrate-supabase.js";
+import { type MigrationPreview } from "./migrate-supabase-map.js";
 /**
  * FUTURE9 Phase B chunk 2 — schema migration write step.
  *

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

@@ -1,10 +1,10 @@
 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";
+import { recoveryAsk, recoveryNone, } from "../recovery.js";
+import { inspectSupabase, } from "./migrate-supabase.js";
+import { mapSupabaseToPocketBase } from "./migrate-supabase-map.js";
+import { generateDataImportScripts } from "./migrate-supabase-scripts.js";
 /**
  * FUTURE9 Phase B chunk 2 — schema migration write step.
  *

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

@@ -1,4 +1,4 @@
-import type { MigrationPreview } from "./migrate-supabase-map";
+import type { MigrationPreview } from "./migrate-supabase-map.js";
 /**
  * FUTURE9 Phase C — data-import script generator.
  *

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

@@ -121,6 +121,40 @@ export interface RewriteSupabaseSdkResult {
  * code has no Supabase calls left to match).
  */
 export declare function rewriteSupabaseSdk(input: RewriteSupabaseSdkInput): RewriteSupabaseSdkResult;
+export interface SupabaseUsageScan {
+    /** File imports from `@supabase/*` (static import, dynamic import, or require). */
+    importsSupabase: boolean;
+    /** `supabase.auth.*(...)` call sites. */
+    authCalls: number;
+    /** `supabase.from(...)` CRUD chains. Reported, but NOT part of
+     *  migrationComplete — a remaining `.from()` keeps the file importing
+     *  the client, so `importsSupabase` is the backstop. */
+    fromCalls: number;
+    /** `supabase.storage.*` chains. */
+    storage: number;
+    /** `supabase.rpc(...)` sites. */
+    rpc: number;
+    /** `supabase.channel(...)` realtime chains. */
+    realtime: number;
+    /** `supabase.functions.invoke(...)` sites. */
+    edgeFunctions: number;
+    /** File reads `pb.<x>` as a member at all (whether or not `pb` is bound). */
+    usesPb: boolean;
+    /** File reads `pb.<x>` but has no `pb` binding (import / declaration /
+     *  param) in scope — the dangling reference a rewrite leaves until the
+     *  PocketBase client is wired. */
+    danglingPb: boolean;
+    /** Set when the source failed to parse; all counts are 0. */
+    parseError?: string;
+}
+export declare function scanSupabaseUsage(input: {
+    source: string;
+    supabaseIdentifiers?: string[];
+    /** PocketBase identifier to check for usage/dangling refs. Defaults to `pb`.
+     *  MUST match the `pbIdentifier` a rewrite emitted, or the dangling-pb check
+     *  silently passes (e.g. a project rewritten with pbIdentifier "db"). */
+    pbIdentifier?: string;
+}): SupabaseUsageScan;
 /**
  * Entry point matching jscodeshift's `transform` signature, in case
  * a caller wants to run this as a standalone codemod via the

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

@@ -1 +1 @@
-{"version":3,"file":"migrate-supabase-sdk.d.ts","sourceRoot":"","sources":["../../src/commands/migrate-supabase-sdk.ts"],"names":[],"mappings":"AAAA,OAAoB,EAClB,KAAK,GAAG,EAGR,KAAK,QAAQ,EACb,KAAK,OAAO,EACb,MAAM,aAAa,CAAC;AAErB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAEH,MAAM,MAAM,eAAe;AACzB,sDAAsD;AACpD,WAAW;AACb,sEAAsE;GACpE,eAAe;AACjB,uHAAuH;GACrH,aAAa,CAAC;AAElB,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,eAAe,CAAC;IACtB,0EAA0E;IAC1E,OAAO,EAAE,MAAM,CAAC;IAChB,0FAA0F;IAC1F,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,uBAAuB;IACtC,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,wBAAwB;IACvC,uFAAuF;IACvF,SAAS,EAAE,MAAM,CAAC;IAClB,uGAAuG;IACvG,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB;;;;;;;;;;;;OAYG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAKD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,uBAAuB,GAAG,wBAAwB,CAsD3F;AAimDD;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,UAAU,SAAS,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,GAAE,OAAY,GAAG,MAAM,GAAG,IAAI,CAOjG"}
+{"version":3,"file":"migrate-supabase-sdk.d.ts","sourceRoot":"","sources":["../../src/commands/migrate-supabase-sdk.ts"],"names":[],"mappings":"AAAA,OAAoB,EAClB,KAAK,GAAG,EAGR,KAAK,QAAQ,EACb,KAAK,OAAO,EACb,MAAM,aAAa,CAAC;AAGrB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAEH,MAAM,MAAM,eAAe;AACzB,sDAAsD;AACpD,WAAW;AACb,sEAAsE;GACpE,eAAe;AACjB,uHAAuH;GACrH,aAAa,CAAC;AAElB,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,eAAe,CAAC;IACtB,0EAA0E;IAC1E,OAAO,EAAE,MAAM,CAAC;IAChB,0FAA0F;IAC1F,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,uBAAuB;IACtC,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,wBAAwB;IACvC,uFAAuF;IACvF,SAAS,EAAE,MAAM,CAAC;IAClB,uGAAuG;IACvG,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB;;;;;;;;;;;;OAYG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAKD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,uBAAuB,GAAG,wBAAwB,CAsD3F;AAyiDD,MAAM,WAAW,iBAAiB;IAChC,mFAAmF;IACnF,eAAe,EAAE,OAAO,CAAC;IACzB,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB;;4DAEwD;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,8CAA8C;IAC9C,aAAa,EAAE,MAAM,CAAC;IACtB,6EAA6E;IAC7E,MAAM,EAAE,OAAO,CAAC;IAChB;;sCAEkC;IAClC,UAAU,EAAE,OAAO,CAAC;IACpB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAcD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B;;6EAEyE;IACzE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,iBAAiB,CA4DpB;AAqLD;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,UAAU,SAAS,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,GAAE,OAAY,GAAG,MAAM,GAAG,IAAI,CAOjG"}

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

@@ -1,4 +1,5 @@
 import jscodeshift, {} from "jscodeshift";
+import { recipeFor } from "./migrate-supabase-recipes.js";
 /** AST library pre-bound to the TypeScript parser via jscodeshift's `.withParser`. */
 const tsx = jscodeshift.withParser("tsx");
 /**
@@ -179,6 +180,21 @@ function rewriteAuthCalls(root, supabaseNames, pbName, flags, state) {
             case "onAuthStateChange":
                 replaceAuthOnChange(path, pbName, flags, state);
                 return;
+            default: {
+                // Any auth method we don't map (getSession, getClaims,
+                // refreshSession, signInWithOtp, verifyOtp,
+                // resetPasswordForEmail, updateUser, …). NEVER pass it
+                // through silently — left untouched it still calls Supabase,
+                // so flag it or the report under-reports the remaining work.
+                // When we have a concrete PB recipe, fold it into the note so
+                // the flag is actionable, not just "do it yourself".
+                const recipe = recipeFor(`auth.${method}`);
+                const note = recipe
+                    ? `supabase.auth.${method}(...) isn't auto-translated (the PB equivalent diverges) — it still calls Supabase. ${recipe.recipe}`
+                    : `supabase.auth.${method}(...) isn't auto-translated — it still calls Supabase. Map it to PocketBase's auth API by hand (https://pocketbase.io/docs/authentication/).`;
+                flags.push(makeFlag(path, "unsupported", `auth.${method}`, note));
+                return;
+            }
         }
     });
 }
@@ -1047,6 +1063,159 @@ function readFirstStringArg(call) {
     }
     return null;
 }
+const EMPTY_SCAN = {
+    importsSupabase: false,
+    authCalls: 0,
+    fromCalls: 0,
+    storage: 0,
+    rpc: 0,
+    realtime: 0,
+    edgeFunctions: 0,
+    usesPb: false,
+    danglingPb: false,
+};
+export function scanSupabaseUsage(input) {
+    const supabaseNames = new Set(input.supabaseIdentifiers ?? ["supabase"]);
+    const pbName = input.pbIdentifier ?? "pb";
+    const mentionsSupabase = sourceMentionsSupabase(input.source, supabaseNames);
+    // includes() (not a word-boundary regex) so a custom identifier with regex-
+    // special chars can't break the fast-path; a false positive only costs a parse.
+    const mentionsPb = input.source.includes(pbName);
+    if (!mentionsSupabase && !mentionsPb)
+        return { ...EMPTY_SCAN };
+    let root;
+    try {
+        root = tsx(input.source);
+    }
+    catch (err) {
+        return { ...EMPTY_SCAN, parseError: err instanceof Error ? err.message : String(err) };
+    }
+    const scan = { ...EMPTY_SCAN };
+    scan.importsSupabase = importsSupabasePackage(root);
+    root.find(jscodeshift.CallExpression).forEach((path) => {
+        const chainRoot = findChainRoot(path.node);
+        if (chainRoot?.type !== "Identifier")
+            return;
+        if (!supabaseNames.has(chainRoot.name))
+            return;
+        // Count once per chain — only at the outermost call.
+        const parent = path.parent?.node;
+        if (parent?.type === "MemberExpression" &&
+            parent.object === path.node) {
+            return;
+        }
+        const steps = readChainSteps(path.node);
+        const first = steps[0];
+        if (!first)
+            return;
+        switch (first.method) {
+            case "auth":
+                scan.authCalls += 1;
+                break;
+            case "from":
+                scan.fromCalls += 1;
+                break;
+            case "storage":
+                scan.storage += 1;
+                break;
+            case "rpc":
+                scan.rpc += 1;
+                break;
+            case "channel":
+                scan.realtime += 1;
+                break;
+            case "functions":
+                if (steps[1]?.method === "invoke")
+                    scan.edgeFunctions += 1;
+                break;
+        }
+    });
+    const pb = analyzePbBinding(root, pbName);
+    scan.usesPb = pb.usesPb;
+    scan.danglingPb = pb.usesPb && !pb.declared;
+    return scan;
+}
+/** True when the program imports/requires any `@supabase/*` package. */
+function importsSupabasePackage(root) {
+    let found = false;
+    root.find(jscodeshift.ImportDeclaration).forEach((p) => {
+        const src = p.node.source.value;
+        if (typeof src === "string" && src.startsWith("@supabase/"))
+            found = true;
+    });
+    if (found)
+        return true;
+    // require("@supabase/...") and dynamic import("@supabase/...")
+    root.find(jscodeshift.CallExpression).forEach((p) => {
+        const callee = p.node.callee;
+        const isRequire = callee.type === "Identifier" && callee.name === "require";
+        const isDynImport = callee.type === "Import";
+        if (!isRequire && !isDynImport)
+            return;
+        const arg = p.node.arguments[0];
+        if ((arg?.type === "Literal" || arg?.type === "StringLiteral") &&
+            typeof arg.value === "string" &&
+            arg.value.startsWith("@supabase/")) {
+            found = true;
+        }
+    });
+    return found;
+}
+/** Whether `pbName` is read as an object (`pbName.x`) and whether it's bound. */
+function analyzePbBinding(root, pbName) {
+    let declared = false;
+    root.find(jscodeshift.ImportDeclaration).forEach((p) => {
+        for (const spec of p.node.specifiers ?? []) {
+            if (spec.local?.name === pbName)
+                declared = true;
+        }
+    });
+    root.find(jscodeshift.VariableDeclarator).forEach((p) => {
+        const id = p.node.id;
+        if (id.type === "Identifier" && id.name === pbName)
+            declared = true;
+        if (id.type === "ObjectPattern" &&
+            objectPatternBindsName(id, pbName)) {
+            declared = true;
+        }
+    });
+    // Function params named pbName (any function kind). A param is itself a
+    // binding, so its body's `pbName.x` isn't dangling.
+    const checkParams = (params) => {
+        for (const param of params) {
+            if (param.type === "Identifier" && param.name === pbName) {
+                declared = true;
+            }
+        }
+    };
+    root.find(jscodeshift.FunctionDeclaration).forEach((p) => {
+        checkParams(p.node.params);
+    });
+    root.find(jscodeshift.FunctionExpression).forEach((p) => {
+        checkParams(p.node.params);
+    });
+    root.find(jscodeshift.ArrowFunctionExpression).forEach((p) => {
+        checkParams(p.node.params);
+    });
+    let usedAsObject = false;
+    root.find(jscodeshift.MemberExpression).forEach((p) => {
+        const obj = p.node.object;
+        if (obj.type === "Identifier" && obj.name === pbName)
+            usedAsObject = true;
+    });
+    return { usesPb: usedAsObject, declared };
+}
+function objectPatternBindsName(pattern, name) {
+    for (const prop of pattern.properties) {
+        if ((prop.type === "Property" || prop.type === "ObjectProperty") &&
+            "value" in prop &&
+            prop.value.type === "Identifier" &&
+            prop.value.name === name) {
+            return true;
+        }
+    }
+    return false;
+}
 function findObjectProp(obj, name) {
     for (const prop of obj.properties) {
         if ((prop.type === "Property" || prop.type === "ObjectProperty") &&