@assistant-ui/metro 0.0.8 → 0.0.11

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":";;KAYK;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.8",
+  "version": "0.0.11",
   "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,12 @@
     "@babel/types": "^8.0.4"
   },
   "devDependencies": {
-    "@types/node": "^26.1.2",
-    "tsdown": "^0.22.14",
+    "@assistant-ui/x-buildutils": "0.0.24",
+    "@assistant-ui/x-generative-compiler": "^0.0.15",
+    "@types/node": "^26.2.0",
     "typescript": "npm:@typescript/typescript6@^6.0.2",
     "typescript-7": "npm:typescript@^7.0.2",
-    "vitest": "^4.1.10",
-    "@assistant-ui/x-buildutils": "0.0.22",
-    "@assistant-ui/x-generative-compiler": "^0.0.12"
+    "vitest": "^4.1.11"
   },
   "publishConfig": {
     "access": "public",
@@ -59,7 +58,7 @@
     "url": "https://github.com/assistant-ui/assistant-ui/issues"
   },
   "scripts": {
-    "build": "tsdown",
+    "build": "aui-build",
     "test": "vitest run",
     "test:watch": "vitest"
   }

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

@@ -3,15 +3,12 @@ import { statSync } from "node:fs";
 import { fileURLToPath } from "node:url";
 import {
   compileGenerative,
-  isGenerativeModule,
+  isGenerativeSource,
 } 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);
 
-/** Source modules a `"use generative"` directive can appear in. */
-const SOURCE_RE = /\.[cm]?[jt]sx?$/;
-
 /** Minimal shape of a Metro babel transformer. */
 type BabelTransformer = {
   transform: (props: {
@@ -72,7 +69,7 @@ export function transform(
   const upstream = upstreamTransformer();
   const { filename, src, options } = props;
 
-  if (SOURCE_RE.test(filename) && isGenerativeModule(src)) {
+  if (isGenerativeSource(filename, src)) {
     const target = isServerEnvironment(
       options?.customTransformOptions?.environment,
     )
@@ -86,6 +83,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 +110,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}`;
 }