@mondaydotcomorg/z2h-cli 0.29.5 → 0.31.0

package/src/commands/backend.ts

@@ -1,8 +1,10 @@
 import path from 'node:path';
 import { existsSync } from 'node:fs';
+import { readJson, writeJson } from 'fs-extra';
 import { PutObjectCommand } from '@aws-sdk/client-s3';
 import { info, output } from '../util/logger';
 import { mfAppName, getCwdAppName } from '../util/app-name';
+import { whoAmI } from '../util/machine-identity';
 import { readHandlers } from '../backend/handlers';
 import { detectIntegrations } from '../backend/detect-integrations';
 import { getS3Client } from '../util/s3/client';
@@ -18,24 +20,36 @@ function currentAppName(): string {
   return mfAppName(raw);
 }
 
-/**
- * True if the app ships an app-level backend — a `backend/handlers/` directory.
- * Callers gate on this so the deploy path is explicit about whether a backend is in
- * play.
- */
 export function hasHandlers(appDir: string): boolean {
   return existsSync(path.join(appDir, 'backend', 'handlers'));
 }
 
+/** Other features may add top-level fields, so writes below merge into this copy instead of replacing it. */
+async function readExistingUsage(appDir: string): Promise<Record<string, unknown>> {
+  try {
+    return (await readJson(path.join(appDir, 'usage.json'))) as Record<string, unknown>;
+  } catch (err) {
+    if ((err as { code?: string }).code === 'ENOENT') {
+      return {};
+    }
+    throw err;
+  }
+}
+
+/** Keeps the app's git-tracked `usage.json` current with every handler parse (validate or deploy). */
+async function writeUsageJson(appDir: string, patch: Record<string, unknown>): Promise<void> {
+  const existing = await readExistingUsage(appDir);
+  await writeJson(path.join(appDir, 'usage.json'), { ...existing, ...patch }, { spaces: 2 });
+}
+
 /**
- * Read handlers, detect declared integrations, and upload to `prefix` when there
- * is anything to upload. Returns `[]` when there is no `backend/handlers/` dir
- * (or it is empty of sources) so callers can always pass the result to
- * `registerOrUpdateApp` without a separate gate.
+ * Returns `[]` when there is no `backend/handlers/` dir (or it is empty of sources)
+ * so callers can always pass the result to `registerOrUpdateApp` without a separate gate.
  */
 async function readDetectAndUpload(
   appDir: string,
   prefix: string,
+  appName: string,
   version: number,
   deployedBy: string,
   logLabel: string
@@ -44,11 +58,12 @@ async function readDetectAndUpload(
     return [];
   }
   info(`reading backend handlers ${logLabel}`);
-  const { handlers, apiDomains } = await readHandlers(appDir);
+  const { handlers, apiDomains, apiUsages } = await readHandlers(appDir);
   const integrations = detectIntegrations(apiDomains);
   if (Object.keys(handlers).length === 0) {
     return integrations;
   }
+  await writeUsageJson(appDir, { appName, deployedBy, apiUsages });
   const s3 = getS3Client();
   const meta = JSON.stringify({ version, deployedBy, handlers: Object.keys(handlers) });
   const put = (key: string, body: string, contentType: string) =>
@@ -65,11 +80,6 @@ async function readDetectAndUpload(
  * from their sources. Each `.js` handler is uploaded as its own flat file — no
  * compilation, no bundling, no npm deps.
  *
- * Live and preview differ only in where the handlers land, so that is the only
- * thing `isPreview` switches:
- * - live:    `<appName>/backend-<version>` — the app's immutable per-version slot.
- * - preview: `<mfKeyPrefix without /MF>/MS` — beside the preview's `/MF` frontend.
- *
  * Integration sync note: the returned set is re-derived from the CURRENT backend
  * sources on every deploy, and the platform set is reconciled to exactly match
  * it (there is no stored declaration to fall back on). A deploy therefore always
@@ -88,25 +98,26 @@ export async function deployBackend(opts: {
   const prefix = isPreview ? `${mfKeyPrefix.replace(/\/MF$/, '')}/MS` : `${appName}/backend-${version}`;
   const logLabel = isPreview ? 'for preview' : `for "${appName}"`;
   try {
-    return await readDetectAndUpload(appDir, prefix, version, deployedBy, logLabel);
+    return await readDetectAndUpload(appDir, prefix, appName, version, deployedBy, logLabel);
   } catch (err) {
     throw tagDeployError('deploy_backend_error', err);
   }
 }
 
 /**
- * Run the same handler validation deploy runs (syntax, isolate constraints,
- * handler rules, integration detection) against the working tree — without
- * uploading anything. Throws on the first invalid handler.
+ * Runs the same checks deploy does against the working tree, refreshing the
+ * local `usage.json` — no upload to S3. Throws on the first invalid handler.
  */
 export async function backendValidateCommand(appDir: string = process.cwd()): Promise<void> {
   if (!hasHandlers(appDir)) {
     output('[z2h-cli] no backend/handlers/ directory — nothing to validate', { handlers: [], integrations: [] });
     return;
   }
-  const { handlers, apiDomains } = await readHandlers(appDir);
+  const { handlers, apiDomains, apiUsages } = await readHandlers(appDir);
   const names = Object.keys(handlers).sort();
   const integrations = detectIntegrations(apiDomains);
+  const { name } = (await readJson(path.join(appDir, 'package.json'))) as { name?: string };
+  await writeUsageJson(appDir, { appName: name ? mfAppName(name) : undefined, deployedBy: whoAmI(), apiUsages });
   const list = (xs: string[]) => (xs.length ? xs.join(', ') : 'none');
   output(`[z2h-cli] ${names.length} handler(s) valid: ${list(names)}\n[z2h-cli] integrations: ${list(integrations)}`, {
     handlers: names,

package/src/commands/create.ts

@@ -108,6 +108,7 @@ export async function createCommand(appName: string, opts: CreateOptions = {}):
   await copy(path.join(appTemplatesDir, 'gitignore'), path.join(appDir, '.gitignore'));
   await copy(path.join(appTemplatesDir, 'claude-settings.json'), path.join(appDir, '.claude', 'settings.json'));
   await copy(path.join(appTemplatesDir, 'CLAUDE.md'), path.join(appDir, 'CLAUDE.md'));
+  await copy(path.join(appTemplatesDir, 'usage.json'), path.join(appDir, 'usage.json'));
 
   // html-embed: also copy the source HTML.
   if (template === 'html-embed' && opts.htmlFile) {

package/src/commands/deploy.ts

@@ -1,4 +1,3 @@
-import os from 'node:os';
 import path from 'node:path';
 import { copy, ensureDir, readJson } from 'fs-extra';
 import { info, warn, output, getOutputMode } from '../util/logger';
@@ -19,8 +18,8 @@ import { getRemoteUrl, guardCleanTree, pullAndResolve, pushToRemote, initRepo }
 import { resolveGitEnv } from '../util/git/git-env';
 import { type RemoteType, validateRemoteOptions, resolveRemoteUrl } from '../util/git/remote-options';
 import { setupS3Client } from '../util/s3/client';
-import { getMachineAppName } from '../util/machine-identity';
-import { registerOrUpdateApp } from '../util/broker/app';
+import { whoAmI } from '../util/machine-identity';
+import { fetchApp, registerOrUpdateApp } from '../util/broker/app';
 import { openInBrowser } from '../util/open-browser';
 import { resolvePortAndMetadata } from '../shadow/prepare';
 import { DeployError, tagDeployError, grantReasonForStatus } from '../util/errors';
@@ -30,11 +29,6 @@ import { promptForTags } from './tag';
 import type { ConsumerPaths, DeployFailureReason } from '../types';
 import type { ManifestEntry, AssetManifestFile } from '../util/manifest';
 
-/** Who is publishing this version — the machine identity, else the OS user. */
-function whoDeployed(): string {
-  return getMachineAppName() ?? os.userInfo().username;
-}
-
 export interface DeployOptions {
   dryRun?: boolean;
   remote?: RemoteType;
@@ -106,7 +100,7 @@ async function buildAndStamp(opts: {
   } else {
     ({ assetManifest } = await buildCommand({ publicUrl: opts.publicUrl }));
   }
-  const deployedBy = whoDeployed();
+  const deployedBy = whoAmI();
 
   return {
     ...assetManifest,
@@ -132,8 +126,10 @@ async function uploadAndRegister(opts: {
   gitRemote: string;
   isPreview: boolean;
   description?: string;
+  masterAppName?: string;
 }): Promise<void> {
-  const { paths, keyPrefix, appName, token, nextVersion, entry, gitRemote, isPreview, description } = opts;
+  const { paths, keyPrefix, appName, token, nextVersion, entry, gitRemote, isPreview, description, masterAppName } =
+    opts;
 
   info(`uploading ${isPreview ? 'preview ' : ''}build → s3://${BUCKET_WRITE_NAME}/${keyPrefix}/`);
   await uploadDir(paths.shadowBuild, keyPrefix);
@@ -146,14 +142,34 @@ async function uploadAndRegister(opts: {
     appName,
     mfKeyPrefix: keyPrefix,
     version: nextVersion,
-    deployedBy: whoDeployed(),
+    deployedBy: whoAmI(),
     isPreview,
   });
 
-  await registerOrUpdateApp({ appName, token, nextVersion, entry, gitRemote, integrations, description });
+  await registerOrUpdateApp({
+    appName,
+    token,
+    nextVersion,
+    entry,
+    gitRemote,
+    integrations,
+    description,
+    masterAppName,
+  });
 }
 
 async function deployPreview({ paths, consumerName, appName, token, opts }: DeployContext): Promise<void> {
+  // A preview inherits from the live app it previews, resolved by name server-side —
+  // fail fast with an actionable message if that app was never claimed/deployed (e.g. a
+  // local checkout scaffolded before `create` started claiming names), rather than
+  // letting a deep backend 404 surface as a generic "App registration failed".
+  if (!(await fetchApp(appName))) {
+    throw new DeployError(
+      'register_error',
+      `Cannot preview "${appName}": it has never been created or deployed. Run 'z2h-cli create ${consumerName}' (or deploy it once) first.`
+    );
+  }
+
   await ensureDir(paths.shadowDir);
   const { previewId } = await resolvePortAndMetadata(paths, cleanAppName(consumerName));
 
@@ -190,6 +206,7 @@ async function deployPreview({ paths, consumerName, appName, token, opts }: Depl
     entry,
     gitRemote: '',
     isPreview: true,
+    masterAppName: appName,
   });
 
   const previewUrl = `https://bigbrain.me/bigbrain-vibe/${previewSlug}`;

package/src/commands/generate.ts

@@ -5,7 +5,7 @@ import { execa } from 'execa';
 import { pathExists, readdir } from 'fs-extra';
 import { assertWorkspace } from '../util/workspace';
 import { validateAppName, cleanAppName, mfAppName } from '../util/app-name';
-import { fetchApp } from '../util/broker/app';
+import { claimApp, fetchApp } from '../util/broker/app';
 import { patchBuiltBundle, patchOneFile, type PatchedConfig } from '../util/dashboard-templates/patch-bundle';
 import { findTemplate, type DashboardTemplateEntry } from '../util/dashboard-templates/load-catalog';
 import { initRepo, defaultS3Remote } from '../util/git/repo';
@@ -163,6 +163,13 @@ export async function generateCommand(appName: string, opts: GenerateOptions): P
     throw new Error(`An app named "${appName}" already exists in the Z2H registry. Pick a different name.`);
   }
 
+  // generate skips `create` entirely, but the preview it deploys below still resolves this
+  // app's own row by name server-side — claim it now so that lookup finds something, same as
+  // `create` does for the normal flow.
+  if (!existing) {
+    await claimApp(mfAppName(appName), defaultS3Remote(appName));
+  }
+
   info(`copying template "${template.id}" → ${appDir}`);
   // Excludes node_modules (installed into templateDir itself by build-templates.mjs, never
   // needed by the generated app), .build-shadow (a scratch dir that build-templates.mjs

package/src/templates/app/usage.json

@@ -0,0 +1 @@
+{}

package/src/util/broker/app.ts

@@ -72,12 +72,13 @@ async function registerApp(
   visibility: 'public' | 'private',
   gitRemote: string,
   integrations?: string[],
-  description?: string
+  description?: string,
+  masterAppName?: string
 ): Promise<void> {
   const res = await fetch(`${brokerBaseUrl()}/z2h-cli/apps/register`, {
     method: 'POST',
     headers: { Authorization: `Bearer ${token}`, 'Content-Type': 'application/json', ...routingHeaders() },
-    body: JSON.stringify({ appName, version, entry, visibility, gitRemote, integrations, description }),
+    body: JSON.stringify({ appName, version, entry, visibility, gitRemote, integrations, description, masterAppName }),
   });
   if (!res.ok) {
     const text = await res.text();
@@ -114,6 +115,8 @@ export interface RegisterOrUpdateOptions {
   gitRemote: string;
   integrations?: string[];
   description?: string;
+  /** For a preview app's first registration, the real app it previews. Ignored past v1. */
+  masterAppName?: string;
 }
 
 /**
@@ -123,13 +126,23 @@ export interface RegisterOrUpdateOptions {
  * deploy and preview so this branching logic lives in exactly one place.
  */
 export async function registerOrUpdateApp(opts: RegisterOrUpdateOptions): Promise<void> {
-  const { appName, token, nextVersion, entry, gitRemote, integrations, description } = opts;
+  const { appName, token, nextVersion, entry, gitRemote, integrations, description, masterAppName } = opts;
 
   try {
     if (nextVersion === 1) {
       const visibility = await resolveAppVisibility(appName);
       info(`registering "${appName}" → v${nextVersion} (${visibility})`);
-      await registerApp(appName, token, nextVersion, entry, visibility, gitRemote, integrations, description);
+      await registerApp(
+        appName,
+        token,
+        nextVersion,
+        entry,
+        visibility,
+        gitRemote,
+        integrations,
+        description,
+        masterAppName
+      );
     } else {
       info(`updating "${appName}" → v${nextVersion}`);
       await updateApp(appName, token, nextVersion, entry, gitRemote, integrations, description);

package/src/util/machine-identity.ts

@@ -1,10 +1,14 @@
+import os from 'node:os';
+
 /**
  * Returns the machine app name when running as a service (e.g. agent-runner).
  * Available when the process is a monday.com microservice with `APP_NAME` set
- * by the platform runtime.
- *
- * Returns `undefined` for interactive human users (fallback to os.userInfo).
+ * by the platform runtime. Returns `undefined` for interactive human users.
  */
 export function getMachineAppName(): string | undefined {
   return process.env.APP_NAME || undefined;
 }
+
+export function whoAmI(): string {
+  return getMachineAppName() ?? os.userInfo().username;
+}

package/dist/backend/__tests__/ast.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ast.test.d.ts","sourceRoot":"","sources":["../../../src/backend/__tests__/ast.test.ts"],"names":[],"mappings":""}

package/dist/backend/__tests__/parse.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"parse.test.d.ts","sourceRoot":"","sources":["../../../src/backend/__tests__/parse.test.ts"],"names":[],"mappings":""}

package/dist/backend/ast.d.ts

@@ -1,39 +0,0 @@
-import type { AnyNode, Expression, Pattern, Program, VariableDeclaration } from 'acorn';
-export interface Declaration {
-    kind: VariableDeclaration['kind'];
-    init: Expression | null | undefined;
-    /**
-     * Property path from `init` to this binding: `[]` for `const x = init`,
-     * `['a', 'b']` for `const { a: { b: x } } = init`, `undefined` when the value
-     * is not a plain property read (array/rest/default patterns).
-     */
-    path: string[] | undefined;
-}
-export interface Bindings {
-    /** Every `var|let|const <name> = …` in the file, by name. */
-    declarations: Map<string, Declaration[]>;
-    /** Names whose value cannot be pinned: reassigned, updated, or bound as parameters. */
-    unpinnable: Set<string>;
-}
-/** Every identifier a binding pattern introduces (`{ a, b: [c] } = …` → a, c). */
-export declare const patternNames: (pattern: Pattern) => string[];
-export declare function collectBindings(program: Program): Bindings;
-export interface PathResolver {
-    /**
-     * Dotted path of a member chain, following `const` aliases back to their
-     * source: with `const sf = ctx.api.v1.snowflake`, `sf.query` resolves to
-     * `ctx.api.v1.snowflake.query`. Destructuring counts too
-     * (`const { snowflake: sf } = ctx.api.v1`). `undefined` if any link is dynamic.
-     *
-     * Only single, never-reassigned, never-shadowed `const` bindings are followed —
-     * anything else is left as written, so a `let` alias or a parameter of the same
-     * name is never mistaken for the channel. The handler's first parameter is
-     * treated as `ctx` even when renamed (`handler(context)` → `context.api.v1.db`
-     * resolves as `ctx.api.v1.db`).
-     */
-    pathOf(node: AnyNode): string | undefined;
-}
-export declare function createPathResolver(bindings: Bindings, contextParam?: string): PathResolver;
-/** Every `ctx.api.v1.<domain>` the program touches (known or not), through `paths`. */
-export declare function collectApiDomains(program: Program, paths: PathResolver): Set<string>;
-//# sourceMappingURL=ast.d.ts.map

package/dist/backend/ast.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ast.d.ts","sourceRoot":"","sources":["../../src/backend/ast.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,OAAO,CAAC;AAKxF,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAClC,IAAI,EAAE,UAAU,GAAG,IAAI,GAAG,SAAS,CAAC;IACpC;;;;OAIG;IACH,IAAI,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;CAC5B;AAED,MAAM,WAAW,QAAQ;IACvB,6DAA6D;IAC7D,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;IACzC,uFAAuF;IACvF,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACzB;AA8CD,kFAAkF;AAClF,eAAO,MAAM,YAAY,GAAI,SAAS,OAAO,KAAG,MAAM,EAAmD,CAAC;AAE1G,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,QAAQ,CA4C1D;AA2BD,MAAM,WAAW,YAAY;IAC3B;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;CAC3C;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,YAAY,CA6B1F;AAED,uFAAuF;AACvF,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,GAAG,GAAG,CAAC,MAAM,CAAC,CAWpF"}

package/dist/backend/ast.js

@@ -1,149 +0,0 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-
-const acornWalk = require('acorn-walk');
-
-/**
- * Every identifier a binding pattern introduces, with its property path from the
- * pattern's value. `path` is deliberately not defaulted: callers pass `[]` for
- * the root and `undefined` once the pattern stops being a plain property read.
- */
-function patternBindings(pattern, path) {
-    switch (pattern.type) {
-        case 'Identifier':
-            return [{ name: pattern.name, path }];
-        case 'ObjectPattern':
-            return pattern.properties.flatMap(p => {
-                if (p.type === 'RestElement') {
-                    return patternBindings(p.argument, undefined);
-                }
-                const key = propertyKey(p.key, p.computed);
-                return patternBindings(p.value, path && key !== undefined ? [...path, key] : undefined);
-            });
-        case 'ArrayPattern':
-            return pattern.elements.flatMap(e => (e ? patternBindings(e, undefined) : []));
-        case 'AssignmentPattern':
-            return patternBindings(pattern.left, undefined);
-        case 'RestElement':
-            return patternBindings(pattern.argument, undefined);
-        default:
-            // MemberExpression targets (`obj.x = …`) bind no names.
-            return [];
-    }
-}
-function propertyKey(key, computed) {
-    if (key.type === 'Literal' && typeof key.value === 'string') {
-        return key.value;
-    }
-    if (!computed && key.type === 'Identifier') {
-        return key.name;
-    }
-    return undefined;
-}
-/** Every identifier a binding pattern introduces (`{ a, b: [c] } = …` → a, c). */
-const patternNames = (pattern) => patternBindings(pattern, []).map(b => b.name);
-function collectBindings(program) {
-    const declarations = new Map();
-    const unpinnable = new Set();
-    const markUnpinnable = (pattern) => patternNames(pattern).forEach(n => unpinnable.add(n));
-    acornWalk.full(program, node => {
-        switch (node.type) {
-            case 'VariableDeclaration':
-                for (const declarator of node.declarations) {
-                    for (const { name, path } of patternBindings(declarator.id, [])) {
-                        const list = declarations.get(name) ?? [];
-                        list.push({ kind: node.kind, init: declarator.init, path });
-                        declarations.set(name, list);
-                    }
-                }
-                break;
-            case 'AssignmentExpression':
-                markUnpinnable(node.left);
-                break;
-            case 'UpdateExpression':
-                if (node.argument.type === 'Identifier') {
-                    unpinnable.add(node.argument.name);
-                }
-                break;
-            case 'ForInStatement':
-            case 'ForOfStatement':
-                if (node.left.type !== 'VariableDeclaration') {
-                    markUnpinnable(node.left);
-                }
-                break;
-            case 'FunctionDeclaration':
-            case 'FunctionExpression':
-            case 'ArrowFunctionExpression':
-                node.params.forEach(markUnpinnable);
-                break;
-            case 'CatchClause':
-                if (node.param) {
-                    markUnpinnable(node.param);
-                }
-                break;
-        }
-    });
-    return { declarations, unpinnable };
-}
-/** `a.b.c` / `a['b'].c` → root `a`, parts `[b, c]`; `undefined` if any link is dynamic or the root is not an identifier. */
-function memberChain(node) {
-    if (node.type === 'ChainExpression') {
-        return memberChain(node.expression);
-    }
-    const parts = [];
-    let cur = node;
-    while (cur.type === 'MemberExpression') {
-        const key = propertyKey(cur.property, cur.computed);
-        if (key === undefined) {
-            return undefined;
-        }
-        parts.unshift(key);
-        cur = cur.object;
-    }
-    return cur.type === 'Identifier' ? { root: cur.name, parts } : undefined;
-}
-function createPathResolver(bindings, contextParam) {
-    function resolveChain(node, resolving) {
-        const chain = memberChain(node);
-        if (!chain) {
-            return undefined;
-        }
-        return [resolveRoot(chain.root, resolving), ...chain.parts].join('.');
-    }
-    function resolveRoot(name, resolving) {
-        if (contextParam !== undefined && name === contextParam) {
-            return 'ctx';
-        }
-        if (bindings.unpinnable.has(name) || resolving.has(name)) {
-            return name;
-        }
-        const decls = bindings.declarations.get(name);
-        if (!decls || decls.length !== 1) {
-            return name;
-        }
-        const [{ kind, init, path }] = decls;
-        if (kind !== 'const' || !init || !path) {
-            return name;
-        }
-        const base = resolveChain(init, new Set(resolving).add(name));
-        return base ? [base, ...path].join('.') : name;
-    }
-    return { pathOf: node => resolveChain(node, new Set()) };
-}
-/** Every `ctx.api.v1.<domain>` the program touches (known or not), through `paths`. */
-function collectApiDomains(program, paths) {
-    const apiDomains = new Set();
-    acornWalk.simple(program, {
-        MemberExpression(node) {
-            const [obj, api, version, domain] = paths.pathOf(node)?.split('.') ?? [];
-            if (obj === 'ctx' && api === 'api' && version === 'v1' && domain) {
-                apiDomains.add(domain);
-            }
-        },
-    });
-    return apiDomains;
-}
-
-exports.collectApiDomains = collectApiDomains;
-exports.collectBindings = collectBindings;
-exports.createPathResolver = createPathResolver;
-exports.patternNames = patternNames;

package/dist/backend/handler-declaration.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"handler-declaration.d.ts","sourceRoot":"","sources":["../../src/backend/handler-declaration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,UAAU,EACV,mBAAmB,EAEnB,iBAAiB,EAEjB,SAAS,EACV,MAAM,OAAO,CAAC;AAMf,MAAM,MAAM,kBAAkB,GAC1B;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,mBAAmB,CAAC,QAAQ,CAAC,CAAA;CAAE,GAC3D;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,UAAU,GAAG,IAAI,GAAG,SAAS,CAAA;CAAE,CAAC;AAE9D,8DAA8D;AAC9D,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,SAAS,CAAC,SAAS,GAAG,iBAAiB,CAAC,EAAE,GAC/C,kBAAkB,GAAG,SAAS,CAahC;AAED,yGAAyG;AACzG,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,GAAG,iBAAiB,GAAG,OAAO,CAe3E;AAsCD,mGAAmG;AACnG,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,kBAAkB,GAAG,MAAM,GAAG,SAAS,CAG3F;AAED,gGAAgG;AAChG,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,MAAM,CAK/C,CAAC"}

package/dist/backend/messages.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/backend/messages.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,QAAQ;uBACA,MAAM;yBACJ,MAAM;0BACL,MAAM;iCAEC,MAAM;0BAEb,MAAM;6BAEH,MAAM,UAAU,MAAM;wBAE3B,MAAM,QAAQ,MAAM,UAAU,MAAM,UAAU,MAAM;CAEzE,CAAC"}

package/dist/backend/parse.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/backend/parse.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8D,KAAK,OAAO,EAAkB,MAAM,OAAO,CAAC;AAkDjH;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAuBhE"}

package/dist/esm/backend/__tests__/ast.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ast.test.d.ts","sourceRoot":"","sources":["../../../../src/backend/__tests__/ast.test.ts"],"names":[],"mappings":""}

package/dist/esm/backend/__tests__/parse.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"parse.test.d.ts","sourceRoot":"","sources":["../../../../src/backend/__tests__/parse.test.ts"],"names":[],"mappings":""}

package/dist/esm/backend/ast.d.ts

@@ -1,39 +0,0 @@
-import type { AnyNode, Expression, Pattern, Program, VariableDeclaration } from 'acorn';
-export interface Declaration {
-    kind: VariableDeclaration['kind'];
-    init: Expression | null | undefined;
-    /**
-     * Property path from `init` to this binding: `[]` for `const x = init`,
-     * `['a', 'b']` for `const { a: { b: x } } = init`, `undefined` when the value
-     * is not a plain property read (array/rest/default patterns).
-     */
-    path: string[] | undefined;
-}
-export interface Bindings {
-    /** Every `var|let|const <name> = …` in the file, by name. */
-    declarations: Map<string, Declaration[]>;
-    /** Names whose value cannot be pinned: reassigned, updated, or bound as parameters. */
-    unpinnable: Set<string>;
-}
-/** Every identifier a binding pattern introduces (`{ a, b: [c] } = …` → a, c). */
-export declare const patternNames: (pattern: Pattern) => string[];
-export declare function collectBindings(program: Program): Bindings;
-export interface PathResolver {
-    /**
-     * Dotted path of a member chain, following `const` aliases back to their
-     * source: with `const sf = ctx.api.v1.snowflake`, `sf.query` resolves to
-     * `ctx.api.v1.snowflake.query`. Destructuring counts too
-     * (`const { snowflake: sf } = ctx.api.v1`). `undefined` if any link is dynamic.
-     *
-     * Only single, never-reassigned, never-shadowed `const` bindings are followed —
-     * anything else is left as written, so a `let` alias or a parameter of the same
-     * name is never mistaken for the channel. The handler's first parameter is
-     * treated as `ctx` even when renamed (`handler(context)` → `context.api.v1.db`
-     * resolves as `ctx.api.v1.db`).
-     */
-    pathOf(node: AnyNode): string | undefined;
-}
-export declare function createPathResolver(bindings: Bindings, contextParam?: string): PathResolver;
-/** Every `ctx.api.v1.<domain>` the program touches (known or not), through `paths`. */
-export declare function collectApiDomains(program: Program, paths: PathResolver): Set<string>;
-//# sourceMappingURL=ast.d.ts.map

package/dist/esm/backend/ast.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ast.d.ts","sourceRoot":"","sources":["../../../src/backend/ast.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,OAAO,CAAC;AAKxF,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAClC,IAAI,EAAE,UAAU,GAAG,IAAI,GAAG,SAAS,CAAC;IACpC;;;;OAIG;IACH,IAAI,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;CAC5B;AAED,MAAM,WAAW,QAAQ;IACvB,6DAA6D;IAC7D,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;IACzC,uFAAuF;IACvF,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACzB;AA8CD,kFAAkF;AAClF,eAAO,MAAM,YAAY,GAAI,SAAS,OAAO,KAAG,MAAM,EAAmD,CAAC;AAE1G,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,QAAQ,CA4C1D;AA2BD,MAAM,WAAW,YAAY;IAC3B;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;CAC3C;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,YAAY,CA6B1F;AAED,uFAAuF;AACvF,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,GAAG,GAAG,CAAC,MAAM,CAAC,CAWpF"}