@assistant-ui/metro 0.0.7 → 0.0.10

package/dist/transformer.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"transformer.d.cts","names":[],"sources":["../src/transformer.ts"],"mappings":";;KAeK;EACH,YAAY;IACV;IACA;IACA;MACM;QAA2B;;;KAEhC;;EAEH;GACC;;iBA2Ca,UACd,OAAO,WAAW;iBA0CJ"}
+{"version":3,"file":"transformer.d.cts","names":[],"sources":["../src/transformer.ts"],"mappings":";;KAeK;EACH,YAAY;IACV;IACA;IACA;MACM;QAA2B;;;KAEhC;;EAEH;GACC;;iBA2Ca,UACd,OAAO,WAAW;iBA2CJ"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@assistant-ui/metro",
-  "version": "0.0.7",
+  "version": "0.0.10",
   "description": "Metro / Expo integration for assistant-ui: the \"use generative\" directive compiler that colocates a tool's schema, server execute, and client render in one file. Works with Expo and bare React Native.",
   "keywords": [
     "assistant-ui",
@@ -37,13 +37,13 @@
     "@babel/types": "^8.0.4"
   },
   "devDependencies": {
-    "@types/node": "^26.1.1",
+    "@types/node": "^26.2.0",
     "tsdown": "^0.22.14",
     "typescript": "npm:@typescript/typescript6@^6.0.2",
     "typescript-7": "npm:typescript@^7.0.2",
     "vitest": "^4.1.10",
-    "@assistant-ui/x-buildutils": "0.0.21",
-    "@assistant-ui/x-generative-compiler": "^0.0.11"
+    "@assistant-ui/x-buildutils": "0.0.23",
+    "@assistant-ui/x-generative-compiler": "^0.0.14"
   },
   "publishConfig": {
     "access": "public",

package/src/index.ts

@@ -8,6 +8,8 @@ const require = createRequire(import.meta.url);
  * preserved and only `transformer.babelTransformerPath` is augmented.
  */
 export type MetroConfigLike = {
+  /** assistant-ui options, stripped from the config handed back to Metro. */
+  aui?: WithAuiOptions | undefined;
   transformer?:
     | {
         babelTransformerPath?: string | undefined;
@@ -24,6 +26,21 @@ export type MetroConfigLike = {
  */
 export const UPSTREAM_TRANSFORMER_ENV = "AUI_METRO_UPSTREAM_TRANSFORMER";
 
+/**
+ * Env var carrying the `backendless` option to the transformer. Metro forks its
+ * transform workers after `metro.config` is evaluated, so they inherit it.
+ */
+export const BACKENDLESS_ENV = "AUI_METRO_BACKENDLESS";
+
+export interface WithAuiOptions {
+  /**
+   * The app has no backend importing the server builds of its `"use generative"`
+   * modules (e.g. cloud-hosted runs). Frontend/human tool schemas then stay
+   * uploadable from the client instead of being assumed backend-known.
+   */
+  backendless?: boolean;
+}
+
 /**
  * Wraps a Metro (or Expo) config so assistant-ui `"use generative"` modules are
  * compiled. Such a file colocates a tool's schema, its `execute`, and its
@@ -40,7 +57,10 @@ export const UPSTREAM_TRANSFORMER_ENV = "AUI_METRO_UPSTREAM_TRANSFORMER";
  * const { getDefaultConfig } = require("expo/metro-config");
  * const { withAui } = require("@assistant-ui/metro");
  *
- * module.exports = withAui(getDefaultConfig(__dirname));
+ * module.exports = withAui({
+ *   ...getDefaultConfig(__dirname),
+ *   aui: { backendless: true },
+ * });
  * ```
  *
  * Authoring is identical to the web: a `"use generative"` file whose default
@@ -48,8 +68,13 @@ export const UPSTREAM_TRANSFORMER_ENV = "AUI_METRO_UPSTREAM_TRANSFORMER";
  */
 export function withAui<T extends MetroConfigLike>(config: T): T {
   const self = require.resolve("@assistant-ui/metro/transformer");
+  // Metro validates config keys it does not recognize, so `aui` must not
+  // survive into the returned config.
+  const { aui, ...baseConfig } = config;
   const upstream = config.transformer?.babelTransformerPath;
 
+  if (aui?.backendless) process.env[BACKENDLESS_ENV] = "1";
+
   // Guard against a double-wrap (`withAui(withAui(config))`, or a shared config
   // already wrapped): if it already points at our transformer, keep the real
   // upstream captured earlier rather than overwriting it with our own path,
@@ -59,10 +84,10 @@ export function withAui<T extends MetroConfigLike>(config: T): T {
   }
 
   return {
-    ...config,
+    ...baseConfig,
     transformer: {
       ...config.transformer,
       babelTransformerPath: self,
     },
-  };
+  } as T;
 }

package/src/transformer.ts

@@ -5,7 +5,7 @@ import {
   compileGenerative,
   isGenerativeModule,
 } from "@assistant-ui/x-generative-compiler";
-import { UPSTREAM_TRANSFORMER_ENV } from "./index";
+import { BACKENDLESS_ENV, UPSTREAM_TRANSFORMER_ENV } from "./index";
 
 const require = createRequire(import.meta.url);
 
@@ -86,6 +86,7 @@ export function transform(
       // resolve; the environment split already keeps a server `execute` out of
       // the client bundle.
       injectServerOnly: false,
+      backendless: process.env[BACKENDLESS_ENV] === "1",
     });
 
     return upstream.transform({ ...props, src: code });
@@ -112,5 +113,7 @@ function selfCacheToken(): string {
 export function getCacheKey(): string {
   const upstream = upstreamTransformer();
   const base = upstream.getCacheKey ? upstream.getCacheKey() : "";
-  return `${base}$aui-metro:${selfCacheToken()}`;
+  const backendless =
+    process.env[BACKENDLESS_ENV] === "1" ? ":backendless" : "";
+  return `${base}$aui-metro:${selfCacheToken()}${backendless}`;
 }