@superblocksteam/vite-plugin-file-sync 1.99.99-next.3 → 2.0.0-SNAPSHOT.2143e2e95d0107ab

package/dist/ensure-app-provider.js

@@ -0,0 +1,209 @@
+import { parse } from "@babel/parser";
+import * as t from "@babel/types";
+import { EXTERNAL_LIBRARY_OPTIONS } from "./parsing/imports.js";
+import { traverse } from "./traverse.js";
+const LIBRARY_IMPORT_PATH = EXTERNAL_LIBRARY_OPTIONS.find((option) => option.library === "@superblocksteam/library")?.library ?? "@superblocksteam/library";
+const LIBRARY_APP_EXPORT_NAME = "App";
+const REACT_ROUTER_IMPORT_PATH = "react-router";
+const REACT_ROUTER_OUTLET_EXPORT_NAME = "Outlet";
+function isJsxIdentifier(name) {
+    return name.type === "JSXIdentifier";
+}
+function getAppProviderLocalNameFromImports(programPath) {
+    for (const stmt of programPath.get("body")) {
+        if (!stmt.isImportDeclaration())
+            continue;
+        if (stmt.node.source.value !== LIBRARY_IMPORT_PATH)
+            continue;
+        for (const spec of stmt.get("specifiers")) {
+            if (!spec.isImportSpecifier())
+                continue;
+            const imported = spec.get("imported");
+            const local = spec.get("local");
+            if (imported.isIdentifier() &&
+                imported.node.name === LIBRARY_APP_EXPORT_NAME) {
+                return local.isIdentifier() ? local.node.name : null;
+            }
+        }
+    }
+    return null;
+}
+function getOutletLocalNameFromImports(programPath) {
+    for (const stmt of programPath.get("body")) {
+        if (!stmt.isImportDeclaration())
+            continue;
+        if (stmt.node.source.value !== REACT_ROUTER_IMPORT_PATH)
+            continue;
+        for (const spec of stmt.get("specifiers")) {
+            if (!spec.isImportSpecifier())
+                continue;
+            const imported = spec.get("imported");
+            const local = spec.get("local");
+            if (imported.isIdentifier() &&
+                imported.node.name === REACT_ROUTER_OUTLET_EXPORT_NAME) {
+                return local.isIdentifier() ? local.node.name : null;
+            }
+        }
+    }
+    return null;
+}
+function resolveDefaultExportedFunction(programPath) {
+    const body = programPath.get("body");
+    const defaultExport = body.find((p) => p.isExportDefaultDeclaration());
+    if (!defaultExport || !defaultExport.isExportDefaultDeclaration()) {
+        return null;
+    }
+    const decl = defaultExport.get("declaration");
+    if (decl.isFunctionDeclaration()) {
+        return decl;
+    }
+    if (decl.isArrowFunctionExpression() || decl.isFunctionExpression()) {
+        return decl;
+    }
+    if (decl.isIdentifier()) {
+        const binding = defaultExport.scope.getBinding(decl.node.name);
+        if (!binding) {
+            return null;
+        }
+        const bindingPath = binding.path;
+        if (bindingPath.isFunctionDeclaration()) {
+            return bindingPath;
+        }
+        if (bindingPath.isVariableDeclarator()) {
+            const init = bindingPath.get("init");
+            if (init.isArrowFunctionExpression() || init.isFunctionExpression()) {
+                return init;
+            }
+        }
+    }
+    return null;
+}
+function findFirstReturnedJsxExpressionNoMutate(fnPath) {
+    const body = fnPath.get("body");
+    // Arrow function expression-body returning JSX
+    if (!body.isBlockStatement()) {
+        if (fnPath.isArrowFunctionExpression() &&
+            (body.isJSXElement() || body.isJSXFragment())) {
+            return body.node;
+        }
+        return null;
+    }
+    const returnPath = body.get("body").find((s) => s.isReturnStatement());
+    if (!returnPath)
+        return null;
+    const arg = returnPath.get("argument");
+    if (!arg || Array.isArray(arg) || !arg.isExpression())
+        return null;
+    if (!arg.isJSXElement() && !arg.isJSXFragment())
+        return null;
+    return arg.node;
+}
+function hasOutletInReturnedJsx(returnedJsx, outletLocalName) {
+    let found = false;
+    const visit = (node) => {
+        if (found)
+            return;
+        if (t.isJSXElement(node)) {
+            const name = node.openingElement.name;
+            if (isJsxIdentifier(name) && name.name === outletLocalName) {
+                found = true;
+                return;
+            }
+            for (const child of node.children) {
+                visit(child);
+                if (found)
+                    return;
+            }
+            return;
+        }
+        if (t.isJSXFragment(node)) {
+            for (const child of node.children) {
+                visit(child);
+                if (found)
+                    return;
+            }
+        }
+    };
+    visit(returnedJsx);
+    return found;
+}
+function hasUnwrappedOutletInReturnedJsx(returnedJsx, providerLocalName, outletLocalName) {
+    let foundUnwrappedOutlet = false;
+    const visit = (node, underProvider) => {
+        if (foundUnwrappedOutlet)
+            return;
+        if (t.isJSXElement(node)) {
+            const name = node.openingElement.name;
+            const isProvider = isJsxIdentifier(name) && name.name === providerLocalName;
+            const isOutlet = isJsxIdentifier(name) && name.name === outletLocalName;
+            const nextUnderProvider = underProvider || isProvider;
+            if (isOutlet && !nextUnderProvider) {
+                foundUnwrappedOutlet = true;
+                return;
+            }
+            for (const child of node.children) {
+                visit(child, nextUnderProvider);
+                if (foundUnwrappedOutlet)
+                    return;
+            }
+            return;
+        }
+        if (t.isJSXFragment(node)) {
+            for (const child of node.children) {
+                visit(child, underProvider);
+                if (foundUnwrappedOutlet)
+                    return;
+            }
+        }
+    };
+    visit(returnedJsx, false);
+    return foundUnwrappedOutlet;
+}
+export function needsAppProviderFixInAppTsx(sourceCode) {
+    // Fast pre-check: most files shouldn't be parsed.
+    const hasLiteralOutletTag = sourceCode.includes("<Outlet");
+    const mightHaveAliasedOutlet = sourceCode.includes(REACT_ROUTER_IMPORT_PATH) &&
+        sourceCode.includes(REACT_ROUTER_OUTLET_EXPORT_NAME) &&
+        sourceCode.includes("<");
+    if (!hasLiteralOutletTag && !mightHaveAliasedOutlet) {
+        return false;
+    }
+    let ast;
+    try {
+        ast = parse(sourceCode, {
+            sourceType: "module",
+            plugins: ["typescript", "jsx"],
+        });
+    }
+    catch {
+        return false;
+    }
+    let programPath = null;
+    traverse(ast, {
+        Program(path) {
+            programPath = path;
+            path.stop();
+        },
+    });
+    if (!programPath)
+        return false;
+    const defaultFn = resolveDefaultExportedFunction(programPath);
+    if (!defaultFn)
+        return false;
+    const returnedJsx = findFirstReturnedJsxExpressionNoMutate(defaultFn);
+    if (!returnedJsx)
+        return false;
+    const outletLocalName = getOutletLocalNameFromImports(programPath) ??
+        REACT_ROUTER_OUTLET_EXPORT_NAME;
+    // Strict: if there is no Outlet in the returned JSX, we should not complain.
+    if (!hasOutletInReturnedJsx(returnedJsx, outletLocalName)) {
+        return false;
+    }
+    const providerLocalName = getAppProviderLocalNameFromImports(programPath);
+    if (!providerLocalName) {
+        // If Outlet is present but the library App import isn't, Clark must fix App.tsx.
+        return true;
+    }
+    return hasUnwrappedOutletInReturnedJsx(returnedJsx, providerLocalName, outletLocalName);
+}
+//# sourceMappingURL=ensure-app-provider.js.map

package/dist/ensure-app-provider.js.map

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

package/dist/errors/error-handler.d.ts

@@ -1,5 +1,5 @@
-import type { ServerError } from "@superblocksteam/library-shared/types";
 import type { EventEmitter } from "events";
+import type { ServerError } from "@superblocksteam/library-shared/types";
 export type ErrorEventMap = {
     error: [error: ServerError];
 };
@@ -7,21 +7,10 @@ export type ErrorEventMap = {
  * Interface for objects that can emit error events
  * Based on Node.js EventEmitter
  */
-export interface ErrorEmitter {
+interface ErrorEmitter {
     emit: EventEmitter<ErrorEventMap>["emit"];
     listeners: EventEmitter<ErrorEventMap>["listeners"];
 }
-/**
- * Wraps a method with error handling that emits an error event when an exception occurs
- * NOTE: This swallows the error
- *
- * @param instance - The object instance containing the method to wrap
- * @param methodName - The name of the method to wrap
- */
-export declare function withErrorHandling<T extends ErrorEmitter>(instance: T, methodName: keyof T & string, details: {
-    operation: string;
-    rethrow?: boolean;
-}): void;
 /**
  * Helper function to apply error handling to multiple methods at once
  *
@@ -32,4 +21,5 @@ export declare function applyErrorHandling<T extends ErrorEmitter>(instance: T,
     operation: string;
     rethrow?: boolean;
 }>>): void;
+export {};
 //# sourceMappingURL=error-handler.d.ts.map

package/dist/errors/error-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../src/errors/error-handler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,WAAW,EACZ,MAAM,uCAAuC,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAE3C,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;CAC7B,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,YAAY,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;IAC1C,SAAS,EAAE,YAAY,CAAC,aAAa,CAAC,CAAC,WAAW,CAAC,CAAC;CACrD;AAMD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,YAAY,EACtD,QAAQ,EAAE,CAAC,EACX,UAAU,EAAE,MAAM,CAAC,GAAG,MAAM,EAC5B,OAAO,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAChD,IAAI,CA2CN;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,YAAY,EACvD,QAAQ,EAAE,CAAC,EACX,OAAO,EAAE,OAAO,CACd,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CACnE,GACA,IAAI,CAQN"}
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../src/errors/error-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAE3C,OAAO,KAAK,EAEV,WAAW,EACZ,MAAM,uCAAuC,CAAC;AAI/C,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;CAC7B,CAAC;AAEF;;;GAGG;AACH,UAAU,YAAY;IACpB,IAAI,EAAE,YAAY,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;IAC1C,SAAS,EAAE,YAAY,CAAC,aAAa,CAAC,CAAC,WAAW,CAAC,CAAC;CACrD;AA8DD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,YAAY,EACvD,QAAQ,EAAE,CAAC,EACX,OAAO,EAAE,OAAO,CACd,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CACnE,GACA,IAAI,CAQN"}

package/dist/errors/error-handler.js

@@ -9,7 +9,7 @@ const isPromise = (value) => {
  * @param instance - The object instance containing the method to wrap
  * @param methodName - The name of the method to wrap
  */
-export function withErrorHandling(instance, methodName, details) {
+function withErrorHandling(instance, methodName, details) {
     const originalMethod = instance[methodName];
     if (typeof originalMethod !== "function")
         return;

package/dist/errors/error-handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"error-handler.js","sourceRoot":"","sources":["../../src/errors/error-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAoB5D,MAAM,SAAS,GAAG,CAAC,KAAc,EAA6B,EAAE;IAC9D,OAAO,KAAK,YAAY,OAAO,CAAC;AAClC,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAC/B,QAAW,EACX,UAA4B,EAC5B,OAAiD;IAEjD,MAAM,cAAc,GAAG,QAAQ,CAAC,UAAU,CAEzB,CAAC;IAClB,IAAI,OAAO,cAAc,KAAK,UAAU;QAAE,OAAO;IAEjD,MAAM,WAAW,GAAG,CAAC,KAAc,EAAE,EAAE;QACrC,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC;QAEnE,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;QAExC,MAAM,UAAU,GAAuB;YACrC,IAAI,EAAE,uBAAuB;YAC7B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,IAAI;YACJ,OAAO,EACL,KAAK,YAAY,KAAK;gBACpB,CAAC,CAAC,KAAK,CAAC,OAAO;gBACf,CAAC,CAAC,oBAAoB,UAAU,EAAE;YACtC,UAAU,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;SAC7D,CAAC;QAEF,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QAEnC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC,CAAC;IAED,QAAQ,CAAC,UAAU,CAAS,GAAG,UAAmB,GAAG,IAAW;QAC/D,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAChD,IAAI,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;gBACtB,OAAO,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YACnC,CAAC;iBAAM,CAAC;gBACN,OAAO,MAAM,CAAC;YAChB,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,WAAW,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAChC,QAAW,EACX,OAEC;IAED,KAAK,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5D,MAAM,YAAY,GAAG;YACnB,GAAG,OAAO;YACV,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,KAAK;SAClC,CAAC;QACF,iBAAiB,CAAC,QAAQ,EAAE,UAA8B,EAAE,YAAY,CAAC,CAAC;IAC5E,CAAC;AACH,CAAC"}
+{"version":3,"file":"error-handler.js","sourceRoot":"","sources":["../../src/errors/error-handler.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAe5D,MAAM,SAAS,GAAG,CAAC,KAAc,EAA6B,EAAE;IAC9D,OAAO,KAAK,YAAY,OAAO,CAAC;AAClC,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,SAAS,iBAAiB,CACxB,QAAW,EACX,UAA4B,EAC5B,OAAiD;IAEjD,MAAM,cAAc,GAAG,QAAQ,CAAC,UAAU,CAEzB,CAAC;IAClB,IAAI,OAAO,cAAc,KAAK,UAAU;QAAE,OAAO;IAEjD,MAAM,WAAW,GAAG,CAAC,KAAc,EAAE,EAAE;QACrC,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC;QAEnE,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;QAExC,MAAM,UAAU,GAAuB;YACrC,IAAI,EAAE,uBAAuB;YAC7B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,IAAI;YACJ,OAAO,EACL,KAAK,YAAY,KAAK;gBACpB,CAAC,CAAC,KAAK,CAAC,OAAO;gBACf,CAAC,CAAC,oBAAoB,UAAU,EAAE;YACtC,UAAU,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;SAC7D,CAAC;QAEF,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QAEnC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC,CAAC;IAED,QAAQ,CAAC,UAAU,CAAS,GAAG,UAAmB,GAAG,IAAW;QAC/D,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAChD,IAAI,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;gBACtB,OAAO,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YACnC,CAAC;iBAAM,CAAC;gBACN,OAAO,MAAM,CAAC;YAChB,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,WAAW,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAChC,QAAW,EACX,OAEC;IAED,KAAK,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5D,MAAM,YAAY,GAAG;YACnB,GAAG,OAAO;YACV,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,KAAK;SAClC,CAAC;QACF,iBAAiB,CAAC,QAAQ,EAAE,UAA8B,EAAE,YAAY,CAAC,CAAC;IAC5E,CAAC;AACH,CAAC"}

package/dist/extract-api-integrations.d.ts

@@ -0,0 +1,99 @@
+export type IntegrationInfo = {
+    key: string;
+    pluginId: string;
+    id: string;
+};
+export type ExtractApiIntegrationsResult = {
+    integrations: IntegrationInfo[];
+    unresolvedKeys: string[];
+};
+/**
+ * Extract integration declarations from an SDK API source file.
+ *
+ * Anchors on the exported `api({ ... })` config object and extracts
+ * integrations from its `integrations` property.
+ *
+ * Supports inline declarations:
+ * `integrations: { db: postgres("uuid") }`
+ *
+ * Top-level variable references:
+ * `const DB = postgres("uuid"); integrations: { db: DB }`
+ *
+ * And string variable indirection:
+ * `const ID = "uuid"; integrations: { db: postgres(ID) }`
+ *
+ * Also resolves top-level `export const` declarations and `as const`
+ * literals in the same file (e.g. `export const ID = "uuid" as const;`) —
+ * a deliberate, additive improvement over the previous bare-declaration-only
+ * behavior. This is still single-file scope: only same-file declarations
+ * (exported or not) are considered, imports are never followed.
+ *
+ * Single-file only: does not follow imports, so an integration declared via
+ * an imported constant or an imported `integrations` object cannot be
+ * resolved here — it is silently dropped (its key is simply absent from the
+ * returned array, with no signal that it was seen but unresolved). Callers
+ * that need imported declarations resolved, or that need to know about
+ * unresolved keys instead of silently losing them, must use
+ * {@link extractApiIntegrations} instead.
+ */
+export declare function extractIntegrationsFromSource(source: string): IntegrationInfo[];
+/**
+ * Single-file only: does not follow imports, so an integration declared via
+ * an imported constant or an imported `integrations` object cannot be
+ * resolved here — it is silently dropped (its `id` is simply absent from the
+ * returned array, with no signal that it was seen but unresolved). Callers
+ * that need imported declarations resolved, or that need to know about
+ * unresolved keys instead of silently losing them, must use
+ * {@link extractApiIntegrations} instead.
+ */
+export declare function extractIntegrationIdsFromSource(source: string): string[];
+/**
+ * Async variant of {@link extractIntegrationsFromSource} that also resolves
+ * integrations declared via imports from other files, and reports which
+ * `integrations` object keys could not be resolved to a complete
+ * `{ key, pluginId, id }` triple.
+ *
+ * Import resolution supports one-hop relative imports (e.g., `../lib/integrations.js`).
+ * For each imported name, resolves it in the imported module via:
+ * 1. Imported string-literal constants: `export const SHEETS_ID = "sheets-uuid"`
+ *    (including `as const`/type-assertion wrapping and re-exports via
+ *    `export { name }` specifiers).
+ * 2. Imported integration declarations: `export const jira = restApiIntegration("jira-uuid")`
+ *    including string-literal indirection within the imported module, and
+ *    the same `export { name }` specifier form.
+ *
+ * Non-relative imports (package imports) are not followed.
+ *
+ * `params.entryPoint` MUST be an app-root-relative posix path (e.g.
+ * `server/apis/get-rows.ts`), never an absolute path or one containing a
+ * backslash — an entry point that violates this contract skips import
+ * resolution entirely (see the guard at the top of
+ * `buildImportedIntegrationRefs`). Within that contract, resolved relative
+ * import candidates that would escape the app root (e.g. `../../../secrets.ts`)
+ * are skipped without reading them, but that `..`-prefix skip is only a
+ * best-effort guard against traversal *relative to entryPoint's own
+ * directory* — it is not a substitute for real containment enforcement.
+ * Authoritative containment against the actual filesystem root lives in the
+ * caller's `readSource` implementation (see `resolveContainedPath` in
+ * `collect-sdk-apis.mts`), which re-resolves every candidate against the app
+ * root before touching disk.
+ *
+ * `unresolvedKeys` entries are one of:
+ * - a specific `integrations` object key that could not be resolved
+ * - `"(unknown)"` for an `ObjectProperty` whose key itself couldn't be read
+ *   (e.g. a computed key)
+ * - `"(dynamic)"` for a non-`ObjectProperty` member of the integrations
+ *   object (spread elements, methods)
+ * - `"*"` as a sentinel meaning the whole `integrations` value could not be
+ *   statically resolved at all (e.g. `api({ integrations })` shorthand, or
+ *   `api({ integrations: sharedObject })` referencing a non-literal value,
+ *   or the entry file itself failing to parse) — in this case `integrations`
+ *   is always `[]`.
+ */
+export declare function extractApiIntegrations(params: {
+    source: string;
+    entryPoint: string;
+    readSource: (path: string) => Promise<string | undefined>;
+}): Promise<ExtractApiIntegrationsResult>;
+export declare function resolveRelativeImportPath(fromPath: string, importPath: string): string[];
+//# sourceMappingURL=extract-api-integrations.d.ts.map

package/dist/extract-api-integrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-api-integrations.d.ts","sourceRoot":"","sources":["../src/extract-api-integrations.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,eAAe,GAAG;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;CACZ,CAAC;AAySF,MAAM,MAAM,4BAA4B,GAAG;IACzC,YAAY,EAAE,eAAe,EAAE,CAAC;IAChC,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B,CAAC;AAqIF;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,MAAM,GACb,eAAe,EAAE,CAWnB;AAED;;;;;;;;GAQG;AACH,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAIxE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,wBAAsB,sBAAsB,CAAC,MAAM,EAAE;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CAC3D,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAsBxC;AAUD,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,MAAM,EAAE,CAcV"}