@portel/photon 1.29.0 → 1.31.0

package/dist/capability-negotiator.d.ts

@@ -22,7 +22,45 @@ export declare class CapabilityNegotiator {
      *
      * Key: Server instance → Value: raw capabilities object from initialize request
      */
-    private rawClientCapabilities;
+    /**
+     * Public so PhotonServer can expose a back-compat alias for tests that
+     * seed raw capabilities directly. Prefer `setRawCapabilities()` in
+     * non-test code paths.
+     */
+    rawClientCapabilities: WeakMap<Server<{
+        method: string;
+        params?: {
+            [x: string]: unknown;
+            _meta?: {
+                [x: string]: unknown;
+                progressToken?: string | number | undefined;
+                "io.modelcontextprotocol/related-task"?: {
+                    taskId: string;
+                } | undefined;
+            } | undefined;
+        } | undefined;
+    }, {
+        method: string;
+        params?: {
+            [x: string]: unknown;
+            _meta?: {
+                [x: string]: unknown;
+                progressToken?: string | number | undefined;
+                "io.modelcontextprotocol/related-task"?: {
+                    taskId: string;
+                } | undefined;
+            } | undefined;
+        } | undefined;
+    }, {
+        [x: string]: unknown;
+        _meta?: {
+            [x: string]: unknown;
+            progressToken?: string | number | undefined;
+            "io.modelcontextprotocol/related-task"?: {
+                taskId: string;
+            } | undefined;
+        } | undefined;
+    }>, Record<string, any>>;
     /**
      * Store raw capabilities for a server instance.
      * Called from the transport message interceptor.

package/dist/capability-negotiator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capability-negotiator.d.ts","sourceRoot":"","sources":["../src/capability-negotiator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAIxE,qBAAa,oBAAoB;IAC/B;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,qBAAqB,CAA8C;IAE3E;;;OAGG;IACH,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAI3E;;;;;;;;;;;;;OAaG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAqBnC;;;;;OAKG;IACH,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAW5C;;;;;;;OAOG;IACH,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAMzC;;;;;;;;;OASG;IACH,oCAAoC,CAClC,SAAS,EAAE;QAAE,SAAS,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAA;KAAE,EACnD,YAAY,EAAE,MAAM,EACpB,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI,GACjC,IAAI;CAcR"}
+{"version":3,"file":"capability-negotiator.d.ts","sourceRoot":"","sources":["../src/capability-negotiator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAIxE,qBAAa,oBAAoB;IAC/B;;;;;;;;;;;OAWG;IACH;;;;OAIG;IACH,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6BAA8C;IAEnE;;;OAGG;IACH,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAI3E;;;;;;;;;;;;;OAaG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAqBnC;;;;;OAKG;IACH,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAW5C;;;;;;;OAOG;IACH,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAMzC;;;;;;;;;OASG;IACH,oCAAoC,CAClC,SAAS,EAAE;QAAE,SAAS,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAA;KAAE,EACnD,YAAY,EAAE,MAAM,EACpB,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI,GACjC,IAAI;CAcR"}

package/dist/capability-negotiator.js

@@ -22,6 +22,11 @@ export class CapabilityNegotiator {
      *
      * Key: Server instance → Value: raw capabilities object from initialize request
      */
+    /**
+     * Public so PhotonServer can expose a back-compat alias for tests that
+     * seed raw capabilities directly. Prefer `setRawCapabilities()` in
+     * non-test code paths.
+     */
     rawClientCapabilities = new WeakMap();
     /**
      * Store raw capabilities for a server instance.

package/dist/capability-negotiator.js.map

@@ -1 +1 @@
-{"version":3,"file":"capability-negotiator.js","sourceRoot":"","sources":["../src/capability-negotiator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,MAAM,iBAAiB,GAAG,4BAA4B,CAAC;AAEvD,MAAM,OAAO,oBAAoB;IAC/B;;;;;;;;;;;OAWG;IACK,qBAAqB,GAAG,IAAI,OAAO,EAA+B,CAAC;IAE3E;;;OAGG;IACH,kBAAkB,CAAC,MAAc,EAAE,YAAiC;QAClE,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACvD,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,UAAU,CAAC,MAAc;QACvB,sFAAsF;QACtF,MAAM,YAAY,GAAG,MAAM,CAAC,qBAAqB,EAAyB,CAAC;QAC3E,IAAI,YAAY,EAAE,YAAY,EAAE,CAAC,iBAAiB,CAAC,EAAE,CAAC;YACpD,OAAO,IAAI,CAAC;QACd,CAAC;QAED,8EAA8E;QAC9E,iFAAiF;QACjF,MAAM,GAAG,GAAG,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACnD,IAAI,GAAG,EAAE,UAAU,EAAE,CAAC,iBAAiB,CAAC,EAAE,CAAC;YACzC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,qDAAqD;QACrD,MAAM,UAAU,GAAG,MAAM,CAAC,gBAAgB,EAAE,CAAC;QAC7C,IAAI,UAAU,EAAE,IAAI,KAAK,MAAM;YAAE,OAAO,IAAI,CAAC;QAE7C,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;;OAKG;IACH,mBAAmB,CAAC,MAAc;QAChC,MAAM,YAAY,GAAG,MAAM,CAAC,qBAAqB,EAAE,CAAC;QAEpD,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,sDAAsD;QACtD,OAAO,CAAC,CAAC,YAAY,CAAC,WAAW,CAAC;IACpC,CAAC;IAED;;;;;;;OAOG;IACH,gBAAgB,CAAC,MAAc;QAC7B,MAAM,YAAY,GAAG,MAAM,CAAC,qBAAqB,EAAE,CAAC;QACpD,IAAI,CAAC,YAAY;YAAE,OAAO,KAAK,CAAC;QAChC,OAAO,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC;IACjC,CAAC;IAED;;;;;;;;;OASG;IACH,oCAAoC,CAClC,SAAmD,EACnD,YAAoB,EACpB,SAAkC;QAElC,MAAM,aAAa,GAAG,SAAS,CAAC,SAAS,CAAC;QAC1C,SAAS,CAAC,SAAS,GAAG,CAAC,OAAY,EAAE,KAAW,EAAE,EAAE;YAClD,mDAAmD;YACnD,IAAI,OAAO,EAAE,MAAM,KAAK,YAAY,IAAI,OAAO,EAAE,MAAM,EAAE,CAAC;gBACxD,IAAI,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;oBAChC,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;gBAC5E,CAAC;YACH,CAAC;YACD,0CAA0C;YAC1C,SAAS,EAAE,CAAC,OAAO,CAAC,CAAC;YACrB,aAAa,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAClC,CAAC,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"capability-negotiator.js","sourceRoot":"","sources":["../src/capability-negotiator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,MAAM,iBAAiB,GAAG,4BAA4B,CAAC;AAEvD,MAAM,OAAO,oBAAoB;IAC/B;;;;;;;;;;;OAWG;IACH;;;;OAIG;IACH,qBAAqB,GAAG,IAAI,OAAO,EAA+B,CAAC;IAEnE;;;OAGG;IACH,kBAAkB,CAAC,MAAc,EAAE,YAAiC;QAClE,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACvD,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,UAAU,CAAC,MAAc;QACvB,sFAAsF;QACtF,MAAM,YAAY,GAAG,MAAM,CAAC,qBAAqB,EAAyB,CAAC;QAC3E,IAAI,YAAY,EAAE,YAAY,EAAE,CAAC,iBAAiB,CAAC,EAAE,CAAC;YACpD,OAAO,IAAI,CAAC;QACd,CAAC;QAED,8EAA8E;QAC9E,iFAAiF;QACjF,MAAM,GAAG,GAAG,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACnD,IAAI,GAAG,EAAE,UAAU,EAAE,CAAC,iBAAiB,CAAC,EAAE,CAAC;YACzC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,qDAAqD;QACrD,MAAM,UAAU,GAAG,MAAM,CAAC,gBAAgB,EAAE,CAAC;QAC7C,IAAI,UAAU,EAAE,IAAI,KAAK,MAAM;YAAE,OAAO,IAAI,CAAC;QAE7C,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;;OAKG;IACH,mBAAmB,CAAC,MAAc;QAChC,MAAM,YAAY,GAAG,MAAM,CAAC,qBAAqB,EAAE,CAAC;QAEpD,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,sDAAsD;QACtD,OAAO,CAAC,CAAC,YAAY,CAAC,WAAW,CAAC;IACpC,CAAC;IAED;;;;;;;OAOG;IACH,gBAAgB,CAAC,MAAc;QAC7B,MAAM,YAAY,GAAG,MAAM,CAAC,qBAAqB,EAAE,CAAC;QACpD,IAAI,CAAC,YAAY;YAAE,OAAO,KAAK,CAAC;QAChC,OAAO,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC;IACjC,CAAC;IAED;;;;;;;;;OASG;IACH,oCAAoC,CAClC,SAAmD,EACnD,YAAoB,EACpB,SAAkC;QAElC,MAAM,aAAa,GAAG,SAAS,CAAC,SAAS,CAAC;QAC1C,SAAS,CAAC,SAAS,GAAG,CAAC,OAAY,EAAE,KAAW,EAAE,EAAE;YAClD,mDAAmD;YACnD,IAAI,OAAO,EAAE,MAAM,KAAK,YAAY,IAAI,OAAO,EAAE,MAAM,EAAE,CAAC;gBACxD,IAAI,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;oBAChC,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;gBAC5E,CAAC;YACH,CAAC;YACD,0CAA0C;YAC1C,SAAS,EAAE,CAAC,OAAO,CAAC,CAAC;YACrB,aAAa,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAClC,CAAC,CAAC;IACJ,CAAC;CACF"}

package/dist/cf-bindings-parser.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Parse a photon's `protected cfBindings = { ... }` declaration.
+ *
+ * Mirrors how `protected settings` is recognized in the schema-extractor
+ * (object-literal initializer on a protected class field). Returns null
+ * when the photon doesn't declare any CF bindings.
+ *
+ * The schema is intentionally narrow — only the binding-name → resource
+ * mappings (and the boolean opt-ins for ai/images/browser). Anything
+ * fancier belongs in the per-photon override JSON layered at deploy
+ * time.
+ */
+import type { CfBindingsConfig } from './runtime/cf-local.js';
+export declare function parseCfBindings(tsContent: string): CfBindingsConfig | null;
+//# sourceMappingURL=cf-bindings-parser.d.ts.map

package/dist/cf-bindings-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cf-bindings-parser.d.ts","sourceRoot":"","sources":["../src/cf-bindings-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAK9D,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CA0B1E"}

package/dist/cf-bindings-parser.js

@@ -0,0 +1,98 @@
+/**
+ * Parse a photon's `protected cfBindings = { ... }` declaration.
+ *
+ * Mirrors how `protected settings` is recognized in the schema-extractor
+ * (object-literal initializer on a protected class field). Returns null
+ * when the photon doesn't declare any CF bindings.
+ *
+ * The schema is intentionally narrow — only the binding-name → resource
+ * mappings (and the boolean opt-ins for ai/images/browser). Anything
+ * fancier belongs in the per-photon override JSON layered at deploy
+ * time.
+ */
+import * as ts from 'typescript';
+const NAMED_BINDING_CATEGORIES = ['r2', 'kv', 'd1', 'queue', 'vectorize'];
+const BOOLEAN_CATEGORIES = ['ai', 'images', 'browser'];
+export function parseCfBindings(tsContent) {
+    if (!tsContent.includes('cfBindings'))
+        return null;
+    const sourceFile = ts.createSourceFile('cf-bindings.ts', tsContent, ts.ScriptTarget.Latest, true);
+    let result = null;
+    const visit = (node) => {
+        if (result)
+            return;
+        if (ts.isPropertyDeclaration(node) &&
+            node.name.getText(sourceFile) === 'cfBindings' &&
+            node.modifiers?.some((m) => m.kind === ts.SyntaxKind.ProtectedKeyword) &&
+            node.initializer &&
+            ts.isObjectLiteralExpression(node.initializer)) {
+            result = readBindingsLiteral(node.initializer, sourceFile);
+            return;
+        }
+        ts.forEachChild(node, visit);
+    };
+    visit(sourceFile);
+    return result;
+}
+function readBindingsLiteral(obj, sourceFile) {
+    const out = {};
+    for (const prop of obj.properties) {
+        if (!ts.isPropertyAssignment(prop))
+            continue;
+        const key = prop.name.getText(sourceFile);
+        const init = prop.initializer;
+        if (NAMED_BINDING_CATEGORIES.includes(key)) {
+            if (!ts.isObjectLiteralExpression(init))
+                continue;
+            const map = {};
+            for (const sub of init.properties) {
+                if (!ts.isPropertyAssignment(sub))
+                    continue;
+                const subKey = unquote(sub.name.getText(sourceFile));
+                if (ts.isStringLiteral(sub.initializer)) {
+                    map[subKey] = sub.initializer.text;
+                    continue;
+                }
+                // d1 accepts `{ name, id }` so users can hand the deploy adapter
+                // a real database UUID for `database_id` separate from the
+                // human-readable `database_name`.
+                if (key === 'd1' && ts.isObjectLiteralExpression(sub.initializer)) {
+                    let name;
+                    let id;
+                    for (const inner of sub.initializer.properties) {
+                        if (!ts.isPropertyAssignment(inner))
+                            continue;
+                        const innerKey = unquote(inner.name.getText(sourceFile));
+                        if (!ts.isStringLiteral(inner.initializer))
+                            continue;
+                        if (innerKey === 'name')
+                            name = inner.initializer.text;
+                        else if (innerKey === 'id')
+                            id = inner.initializer.text;
+                    }
+                    if (name && id) {
+                        map[subKey] = { name, id };
+                    }
+                }
+            }
+            out[key] = map;
+            continue;
+        }
+        if (BOOLEAN_CATEGORIES.includes(key)) {
+            if (init.kind === ts.SyntaxKind.TrueKeyword) {
+                out[key] = true;
+            }
+            else if (init.kind === ts.SyntaxKind.FalseKeyword) {
+                out[key] = false;
+            }
+        }
+    }
+    return out;
+}
+function unquote(s) {
+    if (s.length >= 2 && (s.startsWith('"') || s.startsWith("'"))) {
+        return s.slice(1, -1);
+    }
+    return s;
+}
+//# sourceMappingURL=cf-bindings-parser.js.map

package/dist/cf-bindings-parser.js.map

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

package/dist/cf-usage-scanner.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Source scanner for the new `Cloudflare` injection surface.
+ *
+ * A photon that takes `private cf: Cloudflare` (or any other parameter
+ * name typed `Cloudflare`) reaches into per-binding resources via
+ * `cf.kv(qualifier?)`, `cf.r2(qualifier?)`, etc. The runtime needs to
+ * know — at boot time, before any tool runs — which **qualifiers** the
+ * photon will use, because both miniflare (local sandbox) and
+ * wrangler.toml (deploy) require every binding to be declared up front.
+ *
+ * This scanner walks the photon source and discovers:
+ *   1. Constructor parameter names typed `Cloudflare` (so we recognize
+ *      `this.<paramName>.kv(...)` regardless of what the author named
+ *      the field — `cf`, `xCloud`, `cloud`, etc.).
+ *   2. Every literal qualifier passed to a scoped category method on
+ *      one of those parameter names.
+ *   3. The boolean `share` flags inferred from any reference to the
+ *      shared categories (`ai`, `images`, `browser`).
+ *
+ * Dynamic qualifiers (e.g. `cf.kv(this.tenantId)`) are flagged as
+ * `dynamicQualifiers` per category so the runtime can throw a clear
+ * error pointing the author at `protected cfBindings` overrides — far
+ * better than letting miniflare crash with "binding undefined."
+ *
+ * Single source of truth for both runtime seeding and deploy autogen,
+ * so the binding-name convention can never drift between the two
+ * (a real risk before this scanner — `bindingNameFor(...)` lived in one
+ * place but every consumer recomputed it).
+ */
+import { type ScopedBindingCategory } from '@portel/photon-core';
+/** Categories that take an optional qualifier and use auto-naming. */
+declare const SCOPED_CATEGORIES: readonly ScopedBindingCategory[];
+/** Categories with a single shared binding per Worker (no qualifier). */
+declare const SHARED_CATEGORIES: readonly ["ai", "images", "browser"];
+export type SharedCategory = (typeof SHARED_CATEGORIES)[number];
+export interface CfUsage {
+    /**
+     * Per-category set of literal qualifier strings the photon uses.
+     * The empty-string entry `''` means the default (no-qualifier) call
+     * `cf.kv()`. Other entries are the literal arg passed to a qualified
+     * call like `cf.kv('cache')`.
+     */
+    qualifiers: Record<ScopedBindingCategory, Set<string>>;
+    /**
+     * Categories where at least one call passed a non-literal expression
+     * (e.g. a variable). The runtime can't statically resolve the
+     * binding name; surfaces as a clear error rather than a silent
+     * miniflare miss.
+     */
+    dynamicQualifiers: Set<ScopedBindingCategory>;
+    /** True if the photon reads the corresponding shared binding. */
+    shared: Record<SharedCategory, boolean>;
+    /**
+     * Constructor parameter names (or property names) recognized as the
+     * Cloudflare access path on this photon. Always at least includes
+     * `cf` for the legacy `this.cf` shape so existing static-analysis
+     * sites continue to work; extended with any additional names found
+     * via a typed constructor parameter.
+     */
+    accessPaths: Set<string>;
+}
+/**
+ * Scan a photon's TypeScript source and return everything the runtime
+ * + deploy code-gen needs to know about its CF usage.
+ */
+export declare function scanCfUsage(tsContent: string): CfUsage;
+/**
+ * All scoped binding names the photon will use, expanded against the
+ * photon's name. Hands a deduplicated list to miniflare-config emission
+ * and wrangler.toml emission. Dynamic qualifiers contribute only the
+ * default name — the rest must come from `protected cfBindings`
+ * overrides.
+ */
+export declare function expandScopedBindingNames(photonName: string, usage: CfUsage): Record<ScopedBindingCategory, string[]>;
+export { SCOPED_CATEGORIES, SHARED_CATEGORIES };
+//# sourceMappingURL=cf-usage-scanner.d.ts.map

package/dist/cf-usage-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cf-usage-scanner.d.ts","sourceRoot":"","sources":["../src/cf-usage-scanner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAGH,OAAO,EAAkB,KAAK,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAEjF,sEAAsE;AACtE,QAAA,MAAM,iBAAiB,EAAE,SAAS,qBAAqB,EAM7C,CAAC;AAEX,yEAAyE;AACzE,QAAA,MAAM,iBAAiB,sCAAuC,CAAC;AAE/D,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhE,MAAM,WAAW,OAAO;IACtB;;;;;OAKG;IACH,UAAU,EAAE,MAAM,CAAC,qBAAqB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IACvD;;;;;OAKG;IACH,iBAAiB,EAAE,GAAG,CAAC,qBAAqB,CAAC,CAAC;IAC9C,iEAAiE;IACjE,MAAM,EAAE,MAAM,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;IACxC;;;;;;OAMG;IACH,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC1B;AAaD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CA2DtD;AA0DD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,OAAO,GACb,MAAM,CAAC,qBAAqB,EAAE,MAAM,EAAE,CAAC,CAUzC;AAED,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/cf-usage-scanner.js

@@ -0,0 +1,179 @@
+/**
+ * Source scanner for the new `Cloudflare` injection surface.
+ *
+ * A photon that takes `private cf: Cloudflare` (or any other parameter
+ * name typed `Cloudflare`) reaches into per-binding resources via
+ * `cf.kv(qualifier?)`, `cf.r2(qualifier?)`, etc. The runtime needs to
+ * know — at boot time, before any tool runs — which **qualifiers** the
+ * photon will use, because both miniflare (local sandbox) and
+ * wrangler.toml (deploy) require every binding to be declared up front.
+ *
+ * This scanner walks the photon source and discovers:
+ *   1. Constructor parameter names typed `Cloudflare` (so we recognize
+ *      `this.<paramName>.kv(...)` regardless of what the author named
+ *      the field — `cf`, `xCloud`, `cloud`, etc.).
+ *   2. Every literal qualifier passed to a scoped category method on
+ *      one of those parameter names.
+ *   3. The boolean `share` flags inferred from any reference to the
+ *      shared categories (`ai`, `images`, `browser`).
+ *
+ * Dynamic qualifiers (e.g. `cf.kv(this.tenantId)`) are flagged as
+ * `dynamicQualifiers` per category so the runtime can throw a clear
+ * error pointing the author at `protected cfBindings` overrides — far
+ * better than letting miniflare crash with "binding undefined."
+ *
+ * Single source of truth for both runtime seeding and deploy autogen,
+ * so the binding-name convention can never drift between the two
+ * (a real risk before this scanner — `bindingNameFor(...)` lived in one
+ * place but every consumer recomputed it).
+ */
+import * as ts from 'typescript';
+import { bindingNameFor } from '@portel/photon-core';
+/** Categories that take an optional qualifier and use auto-naming. */
+const SCOPED_CATEGORIES = [
+    'kv',
+    'r2',
+    'd1',
+    'queue',
+    'vectorize',
+];
+/** Categories with a single shared binding per Worker (no qualifier). */
+const SHARED_CATEGORIES = ['ai', 'images', 'browser'];
+function emptyUsage() {
+    const qualifiers = {};
+    for (const cat of SCOPED_CATEGORIES)
+        qualifiers[cat] = new Set();
+    return {
+        qualifiers,
+        dynamicQualifiers: new Set(),
+        shared: { ai: false, images: false, browser: false },
+        accessPaths: new Set(['cf']),
+    };
+}
+/**
+ * Scan a photon's TypeScript source and return everything the runtime
+ * + deploy code-gen needs to know about its CF usage.
+ */
+export function scanCfUsage(tsContent) {
+    const usage = emptyUsage();
+    if (!tsContent)
+        return usage;
+    const sourceFile = ts.createSourceFile('cf-usage.ts', tsContent, ts.ScriptTarget.Latest, true);
+    // (1) Walk every class declaration and discover constructor params
+    // typed `Cloudflare`. The param name becomes an additional access
+    // path the call-scanner recognises.
+    const visitForAccessPaths = (node) => {
+        if (ts.isClassDeclaration(node)) {
+            for (const member of node.members) {
+                if (!ts.isConstructorDeclaration(member))
+                    continue;
+                for (const param of member.parameters) {
+                    if (!param.name || !ts.isIdentifier(param.name))
+                        continue;
+                    if (!param.type)
+                        continue;
+                    const typeText = param.type.getText(sourceFile).trim();
+                    if (typeText === 'Cloudflare' || typeText.startsWith('Cloudflare ')) {
+                        usage.accessPaths.add(param.name.text);
+                    }
+                }
+            }
+        }
+        ts.forEachChild(node, visitForAccessPaths);
+    };
+    visitForAccessPaths(sourceFile);
+    // (2) Walk every property/element access. We're looking for two
+    // shapes: `this.<accessPath>.<category>(...)` (scoped) and
+    // `this.<accessPath>.<sharedCategory>` (shared). Tracking both in
+    // one walker keeps source-file traversal cost down on big photons.
+    const visitForUsage = (node) => {
+        // Scoped category call: `this.<path>.<cat>(<qualifier?>)`
+        if (ts.isCallExpression(node) && ts.isPropertyAccessExpression(node.expression)) {
+            const access = node.expression;
+            const cat = access.name.getText(sourceFile);
+            if (SCOPED_CATEGORIES.includes(cat)) {
+                if (matchesAccessPath(access.expression, sourceFile, usage.accessPaths)) {
+                    recordScopedCall(usage, cat, node, sourceFile);
+                }
+            }
+        }
+        // Shared category access: `this.<path>.<shared>` (no call required —
+        // `this.cf.ai.run(...)` reads `ai` first).
+        if (ts.isPropertyAccessExpression(node)) {
+            const cat = node.name.getText(sourceFile);
+            if (SHARED_CATEGORIES.includes(cat)) {
+                if (matchesAccessPath(node.expression, sourceFile, usage.accessPaths)) {
+                    usage.shared[cat] = true;
+                }
+            }
+        }
+        ts.forEachChild(node, visitForUsage);
+    };
+    visitForUsage(sourceFile);
+    return usage;
+}
+/**
+ * Does `expr` resolve to one of the photon's recognized Cloudflare
+ * access paths? Accepts both `this.cf` and bare `cf` (the latter shows
+ * up when an author destructures the parameter into a local).
+ */
+function matchesAccessPath(expr, sourceFile, paths) {
+    // `this.<name>` or `(this as ...).<name>`
+    if (ts.isPropertyAccessExpression(expr)) {
+        const name = expr.name.getText(sourceFile);
+        if (!paths.has(name))
+            return false;
+        const receiver = unwrapTypeAssertion(expr.expression);
+        return receiver.kind === ts.SyntaxKind.ThisKeyword;
+    }
+    return false;
+}
+function unwrapTypeAssertion(expr) {
+    // `(this as Foo).cf`, `(<Foo>this).cf`, `(this as unknown as Foo).cf`
+    if (ts.isParenthesizedExpression(expr)) {
+        return unwrapTypeAssertion(expr.expression);
+    }
+    if (ts.isAsExpression(expr) || ts.isTypeAssertionExpression(expr)) {
+        return unwrapTypeAssertion(expr.expression);
+    }
+    return expr;
+}
+function recordScopedCall(usage, cat, call, sourceFile) {
+    const args = call.arguments;
+    if (args.length === 0) {
+        usage.qualifiers[cat].add('');
+        return;
+    }
+    const first = args[0];
+    if (ts.isStringLiteralLike(first)) {
+        usage.qualifiers[cat].add(first.text);
+        return;
+    }
+    // Non-literal — author passed a variable / expression. Track so the
+    // runtime can fail clearly when this binding is reached for.
+    usage.dynamicQualifiers.add(cat);
+    // Best-effort: also add '' so the default binding is at least
+    // configured. The dynamic call may still hit a name the runtime
+    // doesn't know, but the default keeps simple branches working.
+    usage.qualifiers[cat].add('');
+}
+/**
+ * All scoped binding names the photon will use, expanded against the
+ * photon's name. Hands a deduplicated list to miniflare-config emission
+ * and wrangler.toml emission. Dynamic qualifiers contribute only the
+ * default name — the rest must come from `protected cfBindings`
+ * overrides.
+ */
+export function expandScopedBindingNames(photonName, usage) {
+    const out = {};
+    for (const cat of SCOPED_CATEGORIES) {
+        const names = [];
+        for (const qualifier of usage.qualifiers[cat]) {
+            names.push(bindingNameFor(photonName, cat, qualifier || undefined));
+        }
+        out[cat] = names;
+    }
+    return out;
+}
+export { SCOPED_CATEGORIES, SHARED_CATEGORIES };
+//# sourceMappingURL=cf-usage-scanner.js.map

package/dist/cf-usage-scanner.js.map

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

package/dist/cli/commands/build.js

@@ -904,7 +904,7 @@ async function runCli(methodName: string, methodArgs: string[], source: string,
   runtime.start();
 
   const loader = new PhotonLoader(false);
-  if (depMap) (loader as any).preloadedDependencies = depMap;
+  if (depMap) loader.preloadedDependencies = depMap;
   const photonInstance = await loader.loadFromModule(mod, filePath, source);
   const result = await loader.executeTool(photonInstance, methodName, parsedArgs);
 

package/dist/cli/commands/cf.d.ts

@@ -0,0 +1,18 @@
+/**
+ * `photon cf` — inspect and edit a photon's CF binding overrides.
+ *
+ * The override JSON layers on top of `protected cfBindings` so users can
+ * repoint a binding (e.g., point `kv: cache` at a different namespace)
+ * without editing photon source. This command surface is intentionally
+ * thin; the heavier "create resource", "test connection", and Beam UI
+ * panel land in later phases.
+ *
+ * Examples:
+ *   photon cf bindings my-photon                       # show declared + override
+ *   photon cf set my-photon kv.cache prod-cache       # repoint a binding
+ *   photon cf set my-photon ai true                    # toggle a boolean opt-in
+ *   photon cf reset my-photon                          # drop the override
+ */
+import type { Command } from 'commander';
+export declare function registerCfCommands(program: Command): void;
+//# sourceMappingURL=cf.d.ts.map

package/dist/cli/commands/cf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cf.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/cf.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWzC,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA4EzD"}