@dxos/functions 0.7.5-labs.ea4b4c2 → 0.7.5-labs.f400bbc

package/dist/lib/browser/bundler/index.mjs

@@ -17,19 +17,19 @@ var Bundler = class {
   constructor(_options) {
     this._options = _options;
   }
-  async bundle(source) {
+  async bundle({ path, source }) {
     const { sandboxedModules: providedModules, ...options } = this._options;
     const createResult = async (result) => {
       return {
         timestamp: Date.now(),
-        sourceHash: Buffer.from(await subtleCrypto.digest("SHA-256", Buffer.from(source))),
+        sourceHash: source ? Buffer.from(await subtleCrypto.digest("SHA-256", Buffer.from(source))) : void 0,
         ...result
       };
     };
     if (this._options.platform === "browser") {
       invariant(initialized, "Compiler not initialized.", {
         F: __dxlog_file,
-        L: 57,
+        L: 71,
         S: this,
         A: [
           "initialized",
@@ -38,7 +38,7 @@ var Bundler = class {
       });
       await initialized;
     }
-    const imports = analyzeSourceFileImports(source);
+    const imports = source ? analyzeSourceFileImports(source) : [];
     try {
       const result = await build({
         platform: options.platform,
@@ -49,7 +49,7 @@ var Bundler = class {
         metafile: true,
         write: false,
         entryPoints: [
-          "memory:main.tsx"
+          path ?? "memory:main.tsx"
         ],
         bundle: true,
         format: "esm",
@@ -59,15 +59,15 @@ var Bundler = class {
             setup: (build2) => {
               build2.onResolve({
                 filter: /^\.\/runtime\.js$/
-              }, ({ path }) => {
+              }, ({ path: path2 }) => {
                 return {
-                  path,
+                  path: path2,
                   external: true
                 };
               });
               build2.onResolve({
                 filter: /^dxos:functions$/
-              }, ({ path }) => {
+              }, ({ path: path2 }) => {
                 return {
                   path: "./runtime.js",
                   external: true
@@ -75,17 +75,17 @@ var Bundler = class {
               });
               build2.onResolve({
                 filter: /^memory:/
-              }, ({ path }) => {
+              }, ({ path: path2 }) => {
                 return {
-                  path: path.split(":")[1],
+                  path: path2.split(":")[1],
                   namespace: "memory"
                 };
               });
               build2.onLoad({
                 filter: /.*/,
                 namespace: "memory"
-              }, ({ path }) => {
-                if (path === "main.tsx") {
+              }, ({ path: path2 }) => {
+                if (path2 === "main.tsx") {
                   return {
                     contents: source,
                     loader: "tsx"
@@ -95,9 +95,9 @@ var Bundler = class {
               for (const module of providedModules) {
                 build2.onResolve({
                   filter: new RegExp(`^${module}$`)
-                }, ({ path }) => {
+                }, ({ path: path2 }) => {
                   return {
-                    path,
+                    path: path2,
                     namespace: "injected-module"
                   };
                 });
@@ -105,13 +105,13 @@ var Bundler = class {
               build2.onLoad({
                 filter: /.*/,
                 namespace: "injected-module"
-              }, ({ path }) => {
-                const namedImports = imports.find((entry) => entry.moduleIdentifier === path)?.namedImports ?? [];
+              }, ({ path: path2 }) => {
+                const namedImports = imports.find((entry) => entry.moduleIdentifier === path2)?.namedImports ?? [];
                 return {
                   contents: `
-                  const { ${namedImports.join(",")} } = window.__DXOS_SANDBOX_MODULES__[${JSON.stringify(path)}];
+                  const { ${namedImports.join(",")} } = window.__DXOS_SANDBOX_MODULES__[${JSON.stringify(path2)}];
                   export { ${namedImports.join(",")} };
-                  export default window.__DXOS_SANDBOX_MODULES__[${JSON.stringify(path)}].default;
+                  export default window.__DXOS_SANDBOX_MODULES__[${JSON.stringify(path2)}].default;
                 `,
                   loader: "tsx"
                 };
@@ -123,7 +123,7 @@ var Bundler = class {
       });
       log("compile complete", result.metafile, {
         F: __dxlog_file,
-        L: 121,
+        L: 135,
         S: this,
         C: (f, a) => f(...a)
       });
@@ -141,7 +141,7 @@ var Bundler = class {
   analyzeImports(result) {
     invariant(result.outputFiles, void 0, {
       F: __dxlog_file,
-      L: 134,
+      L: 148,
       S: this,
       A: [
         "result.outputFiles",

package/dist/lib/browser/bundler/index.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/bundler/bundler.ts"],
-  "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport { type BuildOptions } from 'esbuild';\nimport { build, initialize, type BuildResult, type Plugin } from 'esbuild-wasm';\n\nimport { subtleCrypto } from '@dxos/crypto';\nimport { invariant } from '@dxos/invariant';\nimport { log } from '@dxos/log';\n\nexport type Import = {\n  moduleUrl: string;\n  defaultImport: boolean;\n  namedImports: string[];\n};\n\nexport type BundlerResult = {\n  timestamp: number;\n  sourceHash: Buffer;\n  imports?: Import[];\n  bundle?: string;\n  error?: any;\n};\n\nexport type BundlerOptions = {\n  platform: BuildOptions['platform'];\n  sandboxedModules: string[];\n  remoteModules: Record<string, string>;\n};\n\nlet initialized: Promise<void>;\nexport const initializeBundler = async (options: { wasmUrl: string }) => {\n  await (initialized ??= initialize({\n    wasmURL: options.wasmUrl,\n  }));\n};\n\n/**\n * ESBuild bundler.\n */\nexport class Bundler {\n  constructor(private readonly _options: BundlerOptions) {}\n\n  async bundle(source: string): Promise<BundlerResult> {\n    const { sandboxedModules: providedModules, ...options } = this._options;\n\n    const createResult = async (result?: Partial<BundlerResult>) => {\n      return {\n        timestamp: Date.now(),\n        sourceHash: Buffer.from(await subtleCrypto.digest('SHA-256', Buffer.from(source))),\n        ...result,\n      };\n    };\n\n    if (this._options.platform === 'browser') {\n      invariant(initialized, 'Compiler not initialized.');\n      await initialized;\n    }\n\n    const imports = analyzeSourceFileImports(source);\n\n    // https://esbuild.github.io/api/#build\n    try {\n      const result = await build({\n        platform: options.platform,\n        conditions: ['workerd', 'browser'],\n        metafile: true,\n        write: false,\n        entryPoints: ['memory:main.tsx'],\n        bundle: true,\n        format: 'esm',\n        plugins: [\n          {\n            name: 'memory',\n            setup: (build) => {\n              build.onResolve({ filter: /^\\.\\/runtime\\.js$/ }, ({ path }) => {\n                return { path, external: true };\n              });\n\n              build.onResolve({ filter: /^dxos:functions$/ }, ({ path }) => {\n                return { path: './runtime.js', external: true };\n              });\n\n              build.onResolve({ filter: /^memory:/ }, ({ path }) => {\n                return { path: path.split(':')[1], namespace: 'memory' };\n              });\n\n              build.onLoad({ filter: /.*/, namespace: 'memory' }, ({ path }) => {\n                if (path === 'main.tsx') {\n                  return {\n                    contents: source,\n                    loader: 'tsx',\n                  };\n                }\n              });\n\n              for (const module of providedModules) {\n                build.onResolve({ filter: new RegExp(`^${module}$`) }, ({ path }) => {\n                  return { path, namespace: 'injected-module' };\n                });\n              }\n\n              build.onLoad({ filter: /.*/, namespace: 'injected-module' }, ({ path }) => {\n                const namedImports = imports.find((entry) => entry.moduleIdentifier === path)?.namedImports ?? [];\n                return {\n                  contents: `\n                  const { ${namedImports.join(',')} } = window.__DXOS_SANDBOX_MODULES__[${JSON.stringify(path)}];\n                  export { ${namedImports.join(',')} };\n                  export default window.__DXOS_SANDBOX_MODULES__[${JSON.stringify(path)}].default;\n                `,\n                  loader: 'tsx',\n                };\n              });\n            },\n          },\n          httpPlugin,\n        ],\n      });\n\n      log('compile complete', result.metafile);\n\n      return await createResult({\n        imports: this.analyzeImports(result),\n        bundle: result.outputFiles![0].text,\n      });\n    } catch (err) {\n      return await createResult({ error: err });\n    }\n  }\n\n  // TODO(dmaretskyi): In the future we can replace the compiler with SWC with plugins running in WASM.\n  analyzeImports(result: BuildResult): Import[] {\n    invariant(result.outputFiles);\n\n    // TODO(dmaretskyi): Support import aliases and wildcard imports.\n    const parsedImports = allMatches(IMPORT_REGEX, result.outputFiles[0].text);\n    return Object.values(result.metafile!.outputs)[0].imports.map((entry): Import => {\n      const namedImports: string[] = [];\n\n      const parsedImport = parsedImports.find((capture) => capture?.[4] === entry.path);\n      if (parsedImport?.[2]) {\n        NAMED_IMPORTS_REGEX.lastIndex = 0;\n        const namedImportsMatch = NAMED_IMPORTS_REGEX.exec(parsedImport[2]);\n        if (namedImportsMatch) {\n          namedImportsMatch[1].split(',').forEach((importName) => {\n            namedImports.push(importName.trim());\n          });\n        }\n      }\n\n      return {\n        moduleUrl: entry.path,\n        defaultImport: !!parsedImport?.[1],\n        namedImports,\n      };\n    });\n  }\n\n  analyzeSourceFileImports(code: string) {\n    // TODO(dmaretskyi): Support import aliases and wildcard imports.\n    const parsedImports = allMatches(IMPORT_REGEX, code);\n    return parsedImports.map((capture) => {\n      return {\n        defaultImportName: capture[1],\n        namedImports: capture[2]?.split(',').map((importName) => importName.trim()),\n        wildcardImportName: capture[3],\n        moduleIdentifier: capture[4],\n        quotes: capture[5],\n      };\n    });\n  }\n}\n\n// https://regex101.com/r/FEN5ks/1\n// https://stackoverflow.com/a/73265022\n// $1 = default import name (can be non-existent)\n// $2 = destructured exports (can be non-existent)\n// $3 = wildcard import name (can be non-existent)\n// $4 = module identifier\n// $5 = quotes used (either ' or \")\nconst IMPORT_REGEX =\n  /import(?:(?:(?:[ \\n\\t]+([^ *\\n\\t{},]+)[ \\n\\t]*(?:,|[ \\n\\t]+))?([ \\n\\t]*{(?:[ \\n\\t]*[^ \\n\\t\"'{}]+[ \\n\\t]*,?)+})?[ \\n\\t]*)|[ \\n\\t]*\\*[ \\n\\t]*as[ \\n\\t]+([^ \\n\\t{}]+)[ \\n\\t]+)from[ \\n\\t]*(?:['\"])([^'\"\\n]+)(['\"])/gm;\n\nconst NAMED_IMPORTS_REGEX = /[ \\n\\t]*{((?:[ \\n\\t]*[^ \\n\\t\"'{}]+[ \\n\\t]*,?)+)}[ \\n\\t]*/gm;\n\nconst allMatches = (regex: RegExp, str: string) => {\n  regex.lastIndex = 0;\n\n  let match;\n  const matches = [];\n  while ((match = regex.exec(str))) {\n    matches.push(match);\n  }\n\n  return matches;\n};\n\ntype ParsedImport = {\n  defaultImportName?: string;\n  namedImports: string[];\n  wildcardImportName?: string;\n  moduleIdentifier: string;\n  quotes: string;\n};\n\nconst analyzeSourceFileImports = (code: string): ParsedImport[] => {\n  // TODO(dmaretskyi): Support import aliases and wildcard imports.\n  const parsedImports = allMatches(IMPORT_REGEX, code);\n  return parsedImports.map((capture) => {\n    return {\n      defaultImportName: capture[1],\n      namedImports: capture[2]\n        ?.trim()\n        .slice(1, -1)\n        .split(',')\n        .map((importName) => importName.trim()),\n      wildcardImportName: capture[3],\n      moduleIdentifier: capture[4],\n      quotes: capture[5],\n    };\n  });\n};\n\nconst httpPlugin: Plugin = {\n  name: 'http',\n  setup: (build) => {\n    // Intercept import paths starting with \"http:\" and \"https:\" so esbuild doesn't attempt to map them to a file system location.\n    // Tag them with the \"http-url\" namespace to associate them with this plugin.\n    build.onResolve({ filter: /^https?:\\/\\// }, (args) => ({\n      path: args.path,\n      namespace: 'http-url',\n    }));\n\n    // We also want to intercept all import paths inside downloaded files and resolve them against the original URL.\n    // All of these files will be in the \"http-url\" namespace.\n    // Make sure to keep the newly resolved URL in the \"http-url\" namespace so imports inside it will also be resolved as URLs recursively.\n    build.onResolve({ filter: /.*/, namespace: 'http-url' }, (args) => ({\n      path: new URL(args.path, args.importer).toString(),\n      namespace: 'http-url',\n    }));\n\n    // When a URL is loaded, we want to actually download the content from the internet.\n    // This has just enough logic to be able to handle the example import from unpkg.com but in reality this would probably need to be more complex.\n    build.onLoad({ filter: /.*/, namespace: 'http-url' }, async (args) => {\n      const response = await fetch(args.path);\n      return { contents: await response.text(), loader: 'jsx' };\n    });\n  },\n};\n"],
-  "mappings": "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",
-  "names": ["build", "initialize", "subtleCrypto", "invariant", "log", "initialized", "initializeBundler", "options", "wasmURL", "wasmUrl", "Bundler", "constructor", "_options", "bundle", "source", "sandboxedModules", "providedModules", "createResult", "result", "timestamp", "Date", "now", "sourceHash", "Buffer", "from", "digest", "platform", "imports", "analyzeSourceFileImports", "conditions", "metafile", "write", "entryPoints", "format", "plugins", "name", "setup", "onResolve", "filter", "path", "external", "split", "namespace", "onLoad", "contents", "loader", "module", "RegExp", "namedImports", "find", "entry", "moduleIdentifier", "join", "JSON", "stringify", "httpPlugin", "analyzeImports", "outputFiles", "text", "err", "error", "parsedImports", "allMatches", "IMPORT_REGEX", "Object", "values", "outputs", "map", "parsedImport", "capture", "NAMED_IMPORTS_REGEX", "lastIndex", "namedImportsMatch", "exec", "forEach", "importName", "push", "trim", "moduleUrl", "defaultImport", "code", "defaultImportName", "wildcardImportName", "quotes", "regex", "str", "match", "matches", "slice", "args", "URL", "importer", "toString", "response", "fetch"]
+  "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport { type BuildOptions } from 'esbuild';\nimport { build, initialize, type BuildResult, type Plugin } from 'esbuild-wasm';\n\nimport { subtleCrypto } from '@dxos/crypto';\nimport { invariant } from '@dxos/invariant';\nimport { log } from '@dxos/log';\n\nexport type Import = {\n  moduleUrl: string;\n  defaultImport: boolean;\n  namedImports: string[];\n};\n\nexport type BundleOptions = {\n  /**\n   * Path to the source file on the local file system.\n   * If provided, the path will be used instead of the `source` code.\n   */\n  path?: string;\n\n  /**\n   * Source code to bundle.\n   * Required if `path` is not provided.\n   */\n  source?: string;\n};\n\nexport type BundleResult = {\n  timestamp: number;\n  sourceHash?: Buffer;\n  imports?: Import[];\n  bundle?: string;\n  error?: any;\n};\n\nexport type BundlerOptions = {\n  platform: BuildOptions['platform'];\n  sandboxedModules: string[];\n  remoteModules: Record<string, string>;\n};\n\nlet initialized: Promise<void>;\nexport const initializeBundler = async (options: { wasmUrl: string }) => {\n  await (initialized ??= initialize({\n    wasmURL: options.wasmUrl,\n  }));\n};\n\n/**\n * ESBuild bundler.\n */\nexport class Bundler {\n  constructor(private readonly _options: BundlerOptions) {}\n\n  async bundle({ path, source }: BundleOptions): Promise<BundleResult> {\n    const { sandboxedModules: providedModules, ...options } = this._options;\n\n    const createResult = async (result?: Partial<BundleResult>) => {\n      return {\n        timestamp: Date.now(),\n        sourceHash: source ? Buffer.from(await subtleCrypto.digest('SHA-256', Buffer.from(source))) : undefined,\n        ...result,\n      };\n    };\n\n    if (this._options.platform === 'browser') {\n      invariant(initialized, 'Compiler not initialized.');\n      await initialized;\n    }\n\n    const imports = source ? analyzeSourceFileImports(source) : [];\n\n    // https://esbuild.github.io/api/#build\n    try {\n      const result = await build({\n        platform: options.platform,\n        conditions: ['workerd', 'browser'],\n        metafile: true,\n        write: false,\n        entryPoints: [path ?? 'memory:main.tsx'],\n        bundle: true,\n        format: 'esm',\n        plugins: [\n          {\n            name: 'memory',\n            setup: (build) => {\n              build.onResolve({ filter: /^\\.\\/runtime\\.js$/ }, ({ path }) => {\n                return { path, external: true };\n              });\n\n              build.onResolve({ filter: /^dxos:functions$/ }, ({ path }) => {\n                return { path: './runtime.js', external: true };\n              });\n\n              build.onResolve({ filter: /^memory:/ }, ({ path }) => {\n                return { path: path.split(':')[1], namespace: 'memory' };\n              });\n\n              build.onLoad({ filter: /.*/, namespace: 'memory' }, ({ path }) => {\n                if (path === 'main.tsx') {\n                  return {\n                    contents: source,\n                    loader: 'tsx',\n                  };\n                }\n              });\n\n              for (const module of providedModules) {\n                build.onResolve({ filter: new RegExp(`^${module}$`) }, ({ path }) => {\n                  return { path, namespace: 'injected-module' };\n                });\n              }\n\n              build.onLoad({ filter: /.*/, namespace: 'injected-module' }, ({ path }) => {\n                const namedImports = imports.find((entry) => entry.moduleIdentifier === path)?.namedImports ?? [];\n                return {\n                  contents: `\n                  const { ${namedImports.join(',')} } = window.__DXOS_SANDBOX_MODULES__[${JSON.stringify(path)}];\n                  export { ${namedImports.join(',')} };\n                  export default window.__DXOS_SANDBOX_MODULES__[${JSON.stringify(path)}].default;\n                `,\n                  loader: 'tsx',\n                };\n              });\n            },\n          },\n          httpPlugin,\n        ],\n      });\n\n      log('compile complete', result.metafile);\n\n      return await createResult({\n        imports: this.analyzeImports(result),\n        bundle: result.outputFiles![0].text,\n      });\n    } catch (err) {\n      return await createResult({ error: err });\n    }\n  }\n\n  // TODO(dmaretskyi): In the future we can replace the compiler with SWC with plugins running in WASM.\n  analyzeImports(result: BuildResult): Import[] {\n    invariant(result.outputFiles);\n\n    // TODO(dmaretskyi): Support import aliases and wildcard imports.\n    const parsedImports = allMatches(IMPORT_REGEX, result.outputFiles[0].text);\n    return Object.values(result.metafile!.outputs)[0].imports.map((entry): Import => {\n      const namedImports: string[] = [];\n\n      const parsedImport = parsedImports.find((capture) => capture?.[4] === entry.path);\n      if (parsedImport?.[2]) {\n        NAMED_IMPORTS_REGEX.lastIndex = 0;\n        const namedImportsMatch = NAMED_IMPORTS_REGEX.exec(parsedImport[2]);\n        if (namedImportsMatch) {\n          namedImportsMatch[1].split(',').forEach((importName) => {\n            namedImports.push(importName.trim());\n          });\n        }\n      }\n\n      return {\n        moduleUrl: entry.path,\n        defaultImport: !!parsedImport?.[1],\n        namedImports,\n      };\n    });\n  }\n\n  analyzeSourceFileImports(code: string) {\n    // TODO(dmaretskyi): Support import aliases and wildcard imports.\n    const parsedImports = allMatches(IMPORT_REGEX, code);\n    return parsedImports.map((capture) => {\n      return {\n        defaultImportName: capture[1],\n        namedImports: capture[2]?.split(',').map((importName) => importName.trim()),\n        wildcardImportName: capture[3],\n        moduleIdentifier: capture[4],\n        quotes: capture[5],\n      };\n    });\n  }\n}\n\n// https://regex101.com/r/FEN5ks/1\n// https://stackoverflow.com/a/73265022\n// $1 = default import name (can be non-existent)\n// $2 = destructured exports (can be non-existent)\n// $3 = wildcard import name (can be non-existent)\n// $4 = module identifier\n// $5 = quotes used (either ' or \")\nconst IMPORT_REGEX =\n  /import(?:(?:(?:[ \\n\\t]+([^ *\\n\\t{},]+)[ \\n\\t]*(?:,|[ \\n\\t]+))?([ \\n\\t]*{(?:[ \\n\\t]*[^ \\n\\t\"'{}]+[ \\n\\t]*,?)+})?[ \\n\\t]*)|[ \\n\\t]*\\*[ \\n\\t]*as[ \\n\\t]+([^ \\n\\t{}]+)[ \\n\\t]+)from[ \\n\\t]*(?:['\"])([^'\"\\n]+)(['\"])/gm;\n\nconst NAMED_IMPORTS_REGEX = /[ \\n\\t]*{((?:[ \\n\\t]*[^ \\n\\t\"'{}]+[ \\n\\t]*,?)+)}[ \\n\\t]*/gm;\n\nconst allMatches = (regex: RegExp, str: string) => {\n  regex.lastIndex = 0;\n\n  let match;\n  const matches = [];\n  while ((match = regex.exec(str))) {\n    matches.push(match);\n  }\n\n  return matches;\n};\n\ntype ParsedImport = {\n  defaultImportName?: string;\n  namedImports: string[];\n  wildcardImportName?: string;\n  moduleIdentifier: string;\n  quotes: string;\n};\n\nconst analyzeSourceFileImports = (code: string): ParsedImport[] => {\n  // TODO(dmaretskyi): Support import aliases and wildcard imports.\n  const parsedImports = allMatches(IMPORT_REGEX, code);\n  return parsedImports.map((capture) => {\n    return {\n      defaultImportName: capture[1],\n      namedImports: capture[2]\n        ?.trim()\n        .slice(1, -1)\n        .split(',')\n        .map((importName) => importName.trim()),\n      wildcardImportName: capture[3],\n      moduleIdentifier: capture[4],\n      quotes: capture[5],\n    };\n  });\n};\n\nconst httpPlugin: Plugin = {\n  name: 'http',\n  setup: (build) => {\n    // Intercept import paths starting with \"http:\" and \"https:\" so esbuild doesn't attempt to map them to a file system location.\n    // Tag them with the \"http-url\" namespace to associate them with this plugin.\n    build.onResolve({ filter: /^https?:\\/\\// }, (args) => ({\n      path: args.path,\n      namespace: 'http-url',\n    }));\n\n    // We also want to intercept all import paths inside downloaded files and resolve them against the original URL.\n    // All of these files will be in the \"http-url\" namespace.\n    // Make sure to keep the newly resolved URL in the \"http-url\" namespace so imports inside it will also be resolved as URLs recursively.\n    build.onResolve({ filter: /.*/, namespace: 'http-url' }, (args) => ({\n      path: new URL(args.path, args.importer).toString(),\n      namespace: 'http-url',\n    }));\n\n    // When a URL is loaded, we want to actually download the content from the internet.\n    // This has just enough logic to be able to handle the example import from unpkg.com but in reality this would probably need to be more complex.\n    build.onLoad({ filter: /.*/, namespace: 'http-url' }, async (args) => {\n      const response = await fetch(args.path);\n      return { contents: await response.text(), loader: 'jsx' };\n    });\n  },\n};\n"],
+  "mappings": "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",
+  "names": ["build", "initialize", "subtleCrypto", "invariant", "log", "initialized", "initializeBundler", "options", "wasmURL", "wasmUrl", "Bundler", "constructor", "_options", "bundle", "path", "source", "sandboxedModules", "providedModules", "createResult", "result", "timestamp", "Date", "now", "sourceHash", "Buffer", "from", "digest", "undefined", "platform", "imports", "analyzeSourceFileImports", "conditions", "metafile", "write", "entryPoints", "format", "plugins", "name", "setup", "onResolve", "filter", "external", "split", "namespace", "onLoad", "contents", "loader", "module", "RegExp", "namedImports", "find", "entry", "moduleIdentifier", "join", "JSON", "stringify", "httpPlugin", "analyzeImports", "outputFiles", "text", "err", "error", "parsedImports", "allMatches", "IMPORT_REGEX", "Object", "values", "outputs", "map", "parsedImport", "capture", "NAMED_IMPORTS_REGEX", "lastIndex", "namedImportsMatch", "exec", "forEach", "importName", "push", "trim", "moduleUrl", "defaultImport", "code", "defaultImportName", "wildcardImportName", "quotes", "regex", "str", "match", "matches", "slice", "args", "URL", "importer", "toString", "response", "fetch"]
 }

package/dist/lib/browser/{chunk-PI2DP37S.mjs → chunk-IXJNRWJP.mjs}

@@ -7,7 +7,6 @@ var ScriptType = class extends TypedObject({
   typename: "dxos.org/type/Script",
   version: "0.1.0"
 })({
-  // TODO(burdon): Change to URI?
   name: S.optional(S.String),
   description: S.optional(S.String),
   // TODO(burdon): Change to hash of deployed content.
@@ -104,18 +103,12 @@ var SubscriptionTriggerSchema = S2.Struct({
     [AST.TitleAnnotationId]: "Options"
   }))
 }).pipe(S2.mutable);
-var TriggerSchema = S2.Union(
-  //
-  TimerTriggerSchema,
-  WebhookTriggerSchema,
-  SubscriptionTriggerSchema,
-  EmailTriggerSchema,
-  QueueTriggerSchema
-).annotations({
+var TriggerSchema = S2.Union(TimerTriggerSchema, WebhookTriggerSchema, SubscriptionTriggerSchema, EmailTriggerSchema, QueueTriggerSchema).annotations({
   [AST.TitleAnnotationId]: "Trigger"
 });
 var FunctionTriggerSchema = S2.Struct({
   // TODO(burdon): What type does this reference.
+  // TODO(wittjosiah): This should probably be a Ref?
   function: S2.optional(S2.String.annotations({
     [AST.TitleAnnotationId]: "Function"
   })),
@@ -155,6 +148,43 @@ var FUNCTION_TYPES = [
   FunctionTrigger
 ];
 
+// packages/core/functions/src/types/trace.ts
+import { EchoObject, Expando, ObjectId, Ref as Ref2, S as S3 } from "@dxos/echo-schema";
+var InvocationTrace = S3.Struct({
+  id: ObjectId,
+  /**
+  * Queue DXN for function/workflow invocation events.
+  */
+  invocationTraceQueue: Ref2(Expando),
+  /**
+  * DXN of the invoked function/workflow.
+  */
+  invocationTarget: Ref2(Expando),
+  /**
+  * Present for automatic invocations.
+  */
+  trigger: S3.optional(Ref2(FunctionTrigger))
+}).pipe(EchoObject("dxos.org/type/InvocationTrace", "0.1.0"));
+var TraceEventLog = S3.Struct({
+  timestampMs: S3.Number,
+  level: S3.String,
+  message: S3.String,
+  context: S3.optional(S3.Object)
+});
+var TraceEventException = S3.Struct({
+  timestampMs: S3.Number,
+  message: S3.String,
+  name: S3.String,
+  stack: S3.optional(S3.String)
+});
+var TraceEvent = S3.Struct({
+  id: ObjectId,
+  outcome: S3.String,
+  truncated: S3.Boolean,
+  logs: S3.Array(TraceEventLog),
+  exceptions: S3.Array(TraceEventException)
+}).pipe(EchoObject("dxos.org/type/TraceEvent", "0.1.0"));
+
 export {
   ScriptType,
   FunctionType,
@@ -166,4 +196,4 @@ export {
   FunctionManifestSchema,
   FUNCTION_TYPES
 };
-//# sourceMappingURL=chunk-PI2DP37S.mjs.map
+//# sourceMappingURL=chunk-IXJNRWJP.mjs.map

package/dist/lib/browser/chunk-IXJNRWJP.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/types/schema.ts", "../../../src/types/types.ts", "../../../src/types/trace.ts"],
+  "sourcesContent": ["//\n// Copyright 2024 DXOS.org\n//\n\nimport { JsonSchemaType, Ref, S, TypedObject } from '@dxos/echo-schema';\nimport { TextType } from '@dxos/schema';\n\n/**\n * Source script.\n */\nexport class ScriptType extends TypedObject({\n  typename: 'dxos.org/type/Script',\n  version: '0.1.0',\n})({\n  name: S.optional(S.String),\n  description: S.optional(S.String),\n  // TODO(burdon): Change to hash of deployed content.\n  // Whether source has changed since last deploy.\n  changed: S.optional(S.Boolean),\n  source: Ref(TextType),\n}) {}\n\n/**\n * Function deployment.\n */\n// TODO(burdon): Move to core/functions.\nexport class FunctionType extends TypedObject({\n  typename: 'dxos.org/type/Function',\n  version: '0.1.0',\n})({\n  // TODO(burdon): Rename to id/uri?\n  name: S.NonEmptyString,\n  version: S.String,\n\n  description: S.optional(S.String),\n\n  // Reference to a source script if it exists within ECHO.\n  // TODO(burdon): Don't ref ScriptType directly (core).\n  source: S.optional(Ref(ScriptType)),\n\n  inputSchema: S.optional(JsonSchemaType),\n  outputSchema: S.optional(JsonSchemaType),\n\n  // Local binding to a function name.\n  binding: S.optional(S.String),\n}) {}\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport { AST, OptionsAnnotationId, RawObject, S, TypedObject, DXN } from '@dxos/echo-schema';\n\n/**\n * Type discriminator for TriggerType.\n * Every spec has a type field of type TriggerKind that we can use to understand which type we're working with.\n * https://www.typescriptlang.org/docs/handbook/2/narrowing.html#discriminated-unions\n */\nexport enum TriggerKind {\n  Timer = 'timer',\n  Webhook = 'webhook',\n  Subscription = 'subscription',\n  Email = 'email',\n  Queue = 'queue',\n}\n\n// TODO(burdon): Rename prop kind.\nconst typeLiteralAnnotations = { [AST.TitleAnnotationId]: 'Type' };\n\n/**\n * Cron timer.\n */\nconst TimerTriggerSchema = S.Struct({\n  type: S.Literal(TriggerKind.Timer).annotations(typeLiteralAnnotations),\n  cron: S.String.annotations({\n    [AST.TitleAnnotationId]: 'Cron',\n    [AST.ExamplesAnnotationId]: ['0 0 * * *'],\n  }),\n}).pipe(S.mutable);\n\nexport type TimerTrigger = S.Schema.Type<typeof TimerTriggerSchema>;\n\nconst EmailTriggerSchema = S.Struct({\n  type: S.Literal(TriggerKind.Email).annotations(typeLiteralAnnotations),\n}).pipe(S.mutable);\n\nexport type EmailTrigger = S.Schema.Type<typeof EmailTriggerSchema>;\n\nconst QueueTriggerSchema = S.Struct({\n  type: S.Literal(TriggerKind.Queue).annotations(typeLiteralAnnotations),\n  queue: DXN,\n}).pipe(S.mutable);\n\nexport type QueueTrigger = S.Schema.Type<typeof QueueTriggerSchema>;\n\n/**\n * Webhook.\n */\nconst WebhookTriggerSchema = S.Struct({\n  type: S.Literal(TriggerKind.Webhook).annotations(typeLiteralAnnotations),\n  method: S.optional(\n    S.String.annotations({\n      [AST.TitleAnnotationId]: 'Method',\n      [OptionsAnnotationId]: ['GET', 'POST'],\n    }),\n  ),\n  port: S.optional(\n    S.Number.annotations({\n      [AST.TitleAnnotationId]: 'Port',\n    }),\n  ),\n}).pipe(S.mutable);\n\nexport type WebhookTrigger = S.Schema.Type<typeof WebhookTriggerSchema>;\n\n// TODO(burdon): Use ECHO definition (from https://github.com/dxos/dxos/pull/8233).\nconst QuerySchema = S.Struct({\n  type: S.optional(S.String.annotations({ [AST.TitleAnnotationId]: 'Type' })),\n  props: S.optional(S.Record({ key: S.String, value: S.Any })),\n}).annotations({ [AST.TitleAnnotationId]: 'Query' });\n\n/**\n * Subscription.\n */\nconst SubscriptionTriggerSchema = S.Struct({\n  type: S.Literal(TriggerKind.Subscription).annotations(typeLiteralAnnotations),\n  // TODO(burdon): Define query DSL (from ECHO). Reconcile with Table.Query.\n  filter: QuerySchema,\n  options: S.optional(\n    S.Struct({\n      // Watch changes to object (not just creation).\n      deep: S.optional(S.Boolean.annotations({ [AST.TitleAnnotationId]: 'Nested' })),\n      // Debounce changes (delay in ms).\n      delay: S.optional(S.Number.annotations({ [AST.TitleAnnotationId]: 'Delay' })),\n    }).annotations({ [AST.TitleAnnotationId]: 'Options' }),\n  ),\n}).pipe(S.mutable);\n\nexport type SubscriptionTrigger = S.Schema.Type<typeof SubscriptionTriggerSchema>;\n\n/**\n * Trigger schema (discriminated union).\n */\nexport const TriggerSchema = S.Union(\n  TimerTriggerSchema,\n  WebhookTriggerSchema,\n  SubscriptionTriggerSchema,\n  EmailTriggerSchema,\n  QueueTriggerSchema,\n).annotations({\n  [AST.TitleAnnotationId]: 'Trigger',\n});\n\nexport type TriggerType = S.Schema.Type<typeof TriggerSchema>;\n\n/**\n * Function trigger.\n */\nexport const FunctionTriggerSchema = S.Struct({\n  // TODO(burdon): What type does this reference.\n  // TODO(wittjosiah): This should probably be a Ref?\n  function: S.optional(S.String.annotations({ [AST.TitleAnnotationId]: 'Function' })),\n\n  enabled: S.optional(S.Boolean.annotations({ [AST.TitleAnnotationId]: 'Enabled' })),\n\n  // TODO(burdon): Flatten entire schema.\n  spec: S.optional(TriggerSchema),\n\n  // TODO(burdon): Get meta from function.\n  // The `meta` property is merged into the event data passed to the function.\n  meta: S.optional(S.mutable(S.Record({ key: S.String, value: S.Any }))),\n});\n\nexport type FunctionTriggerType = S.Schema.Type<typeof FunctionTriggerSchema>;\n\n/**\n * Function trigger.\n */\nexport class FunctionTrigger extends TypedObject({\n  typename: 'dxos.org/type/FunctionTrigger',\n  version: '0.1.0',\n})(FunctionTriggerSchema.fields) {}\n\n/**\n * Function definition.\n * @deprecated (Use dxos.org/type/Function)\n */\n// TODO(burdon): Reconcile with FunctionType.\nexport class FunctionDef extends TypedObject({\n  typename: 'dxos.org/type/FunctionDef',\n  version: '0.1.0',\n})({\n  uri: S.String,\n  description: S.optional(S.String),\n  route: S.String,\n  handler: S.String,\n}) {}\n\n/**\n * Function manifest file.\n */\nexport const FunctionManifestSchema = S.Struct({\n  functions: S.optional(S.mutable(S.Array(RawObject(FunctionDef)))),\n  triggers: S.optional(S.mutable(S.Array(RawObject(FunctionTrigger)))),\n});\n\nexport type FunctionManifest = S.Schema.Type<typeof FunctionManifestSchema>;\n\nexport const FUNCTION_TYPES = [FunctionDef, FunctionTrigger];\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { EchoObject, Expando, ObjectId, Ref, S } from '@dxos/echo-schema';\n\nimport { FunctionTrigger } from './types';\n\nconst InvocationTrace = S.Struct({\n  id: ObjectId,\n  /**\n   * Queue DXN for function/workflow invocation events.\n   */\n  invocationTraceQueue: Ref(Expando),\n  /**\n   * DXN of the invoked function/workflow.\n   */\n  invocationTarget: Ref(Expando),\n  /**\n   * Present for automatic invocations.\n   */\n  trigger: S.optional(Ref(FunctionTrigger)),\n}).pipe(EchoObject('dxos.org/type/InvocationTrace', '0.1.0'));\n\nexport type InvocationTraceEvent = S.Schema.Type<typeof InvocationTrace>;\n\nconst TraceEventLog = S.Struct({\n  timestampMs: S.Number,\n  level: S.String,\n  message: S.String,\n  context: S.optional(S.Object),\n});\n\nconst TraceEventException = S.Struct({\n  timestampMs: S.Number,\n  message: S.String,\n  name: S.String,\n  stack: S.optional(S.String),\n});\n\nconst TraceEvent = S.Struct({\n  id: ObjectId,\n  outcome: S.String,\n  truncated: S.Boolean,\n  logs: S.Array(TraceEventLog),\n  exceptions: S.Array(TraceEventException),\n}).pipe(EchoObject('dxos.org/type/TraceEvent', '0.1.0'));\n\nexport type TraceEvent = S.Schema.Type<typeof TraceEvent>;\n"],
+  "mappings": "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",
+  "names": ["JsonSchemaType", "Ref", "S", "TypedObject", "TextType", "ScriptType", "TypedObject", "typename", "version", "name", "S", "optional", "String", "description", "changed", "Boolean", "source", "Ref", "TextType", "FunctionType", "NonEmptyString", "inputSchema", "JsonSchemaType", "outputSchema", "binding", "AST", "OptionsAnnotationId", "RawObject", "S", "TypedObject", "DXN", "TriggerKind", "typeLiteralAnnotations", "AST", "TitleAnnotationId", "TimerTriggerSchema", "S", "Struct", "type", "Literal", "annotations", "cron", "String", "ExamplesAnnotationId", "pipe", "mutable", "EmailTriggerSchema", "QueueTriggerSchema", "queue", "DXN", "WebhookTriggerSchema", "method", "optional", "OptionsAnnotationId", "port", "Number", "QuerySchema", "props", "Record", "key", "value", "Any", "SubscriptionTriggerSchema", "filter", "options", "deep", "Boolean", "delay", "TriggerSchema", "Union", "FunctionTriggerSchema", "function", "enabled", "spec", "meta", "FunctionTrigger", "TypedObject", "typename", "version", "fields", "FunctionDef", "uri", "description", "route", "handler", "FunctionManifestSchema", "functions", "Array", "RawObject", "triggers", "FUNCTION_TYPES", "EchoObject", "Expando", "ObjectId", "Ref", "S", "InvocationTrace", "S", "Struct", "id", "ObjectId", "invocationTraceQueue", "Ref", "Expando", "invocationTarget", "trigger", "optional", "FunctionTrigger", "pipe", "EchoObject", "TraceEventLog", "timestampMs", "Number", "level", "String", "message", "context", "Object", "TraceEventException", "name", "stack", "TraceEvent", "outcome", "truncated", "Boolean", "logs", "Array", "exceptions"]
+}

package/dist/lib/browser/{chunk-JNWHUD6Z.mjs → chunk-XLM3CJXO.mjs}

@@ -2,7 +2,7 @@ import "@dxos/node-std/globals";
 import {
   FunctionDef,
   FunctionTrigger
-} from "./chunk-PI2DP37S.mjs";
+} from "./chunk-IXJNRWJP.mjs";
 
 // packages/core/functions/src/function/function-registry.ts
 import { Event } from "@dxos/async";
@@ -477,4 +477,4 @@ export {
   createTimerTrigger,
   TriggerRegistry
 };
-//# sourceMappingURL=chunk-JNWHUD6Z.mjs.map
+//# sourceMappingURL=chunk-XLM3CJXO.mjs.map

package/dist/lib/browser/index.mjs

@@ -13,7 +13,7 @@ import {
   TriggerRegistry,
   createSubscriptionTrigger,
   createTimerTrigger
-} from "./chunk-JNWHUD6Z.mjs";
+} from "./chunk-XLM3CJXO.mjs";
 import {
   FUNCTION_TYPES,
   FunctionDef,
@@ -24,14 +24,29 @@ import {
   ScriptType,
   TriggerKind,
   TriggerSchema
-} from "./chunk-PI2DP37S.mjs";
+} from "./chunk-IXJNRWJP.mjs";
 import "./chunk-XRCXIG74.mjs";
 
 // packages/core/functions/src/handler.ts
+import { Schema as S } from "@effect/schema";
 import { PublicKey } from "@dxos/client";
 import { log } from "@dxos/log";
-import { nonNullable } from "@dxos/util";
+import { isNonNullable } from "@dxos/util";
 var __dxlog_file = "/home/runner/work/dxos/dxos/packages/core/functions/src/handler.ts";
+var defineFunction = (params) => {
+  if (!S.isSchema(params.inputSchema)) {
+    throw new Error("Input schema must be a valid schema");
+  }
+  if (typeof params.handler !== "function") {
+    throw new Error("Handler must be a function");
+  }
+  return {
+    description: params.description,
+    inputSchema: params.inputSchema,
+    outputSchema: params.outputSchema ?? S.Any,
+    handler: params.handler
+  };
+};
 var subscriptionHandler = (handler, types) => {
   return async ({ event: { data }, context, response, ...rest }) => {
     const { client } = context;
@@ -39,20 +54,20 @@ var subscriptionHandler = (handler, types) => {
     if (!space) {
       log.error("Invalid space", void 0, {
         F: __dxlog_file,
-        L: 133,
+        L: 180,
         S: void 0,
         C: (f, a) => f(...a)
       });
       return response.status(500);
     }
     registerTypes(space, types);
-    const objects = space ? data.objects?.map((id) => space.db.getObjectById(id)).filter(nonNullable) : [];
+    const objects = space ? data.objects?.map((id) => space.db.getObjectById(id)).filter(isNonNullable) : [];
     if (!!data.spaceKey && !space) {
       log.warn("invalid space", {
         data
       }, {
         F: __dxlog_file,
-        L: 143,
+        L: 192,
         S: void 0,
         C: (f, a) => f(...a)
       });
@@ -62,7 +77,7 @@ var subscriptionHandler = (handler, types) => {
         objects: objects?.length
       }, {
         F: __dxlog_file,
-        L: 145,
+        L: 194,
         S: void 0,
         C: (f, a) => f(...a)
       });
@@ -106,6 +121,7 @@ export {
   TriggerSchema,
   createSubscriptionTrigger,
   createTimerTrigger,
+  defineFunction,
   getInvocationUrl,
   getUserFunctionUrlInMetadata,
   incrementSemverPatch,

package/dist/lib/browser/index.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/handler.ts"],
-  "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport { type Schema as S } from '@effect/schema';\n\nimport { type Client, PublicKey } from '@dxos/client';\nimport { type Space, type SpaceId } from '@dxos/client/echo';\nimport type { CoreDatabase, ReactiveEchoObject } from '@dxos/echo-db';\nimport { log } from '@dxos/log';\nimport { nonNullable } from '@dxos/util';\n\n// TODO(burdon): Model after http request. Ref Lambda/OpenFaaS.\n// https://docs.aws.amazon.com/lambda/latest/dg/typescript-handler.html\n// https://www.serverless.com/framework/docs/providers/aws/guide/serverless.yml/#functions\n// https://www.npmjs.com/package/aws-lambda\n\n/**\n * Function handler.\n */\nexport type FunctionHandler<TData = {}, TMeta = {}> = (params: {\n  context: FunctionContext;\n  event: FunctionEvent<TData, TMeta>;\n\n  /**\n   * @deprecated\n   */\n  response: FunctionResponse;\n}) => Promise<Response | FunctionResponse | void>;\n\n/**\n * Function context.\n */\nexport interface FunctionContext {\n  getSpace: (spaceId: SpaceId) => Promise<SpaceAPI>;\n\n  /**\n   * Space from which the function was invoked.\n   */\n  space: SpaceAPI | undefined;\n\n  ai: FunctionContextAi;\n\n  /**\n   * @deprecated\n   */\n  // TODO(burdon): Limit access to individual space.\n  client: Client;\n  /**\n   * @deprecated\n   */\n  // TODO(burdon): Replace with storage service abstraction.\n  dataDir?: string;\n}\n\nexport interface FunctionContextAi {\n  // TODO(dmaretskyi): Refer to cloudflare AI docs for more comprehensive typedefs.\n  run(model: string, inputs: any, options?: any): Promise<any>;\n}\n\n/**\n * Event payload.\n */\n// TODO(dmaretskyi): Update type definitions to match the actual payload.\nexport type FunctionEvent<TData = {}, TMeta = {}> = {\n  data: FunctionEventMeta<TMeta> & TData;\n};\n\n/**\n * Metadata from trigger.\n */\nexport type FunctionEventMeta<TMeta = {}> = {\n  meta: TMeta;\n};\n\n/**\n * Function response.\n */\nexport type FunctionResponse = {\n  status(code: number): FunctionResponse;\n};\n\n//\n// API.\n//\n\n/**\n * Space interface available to functions.\n */\nexport interface SpaceAPI {\n  get id(): SpaceId;\n  get crud(): CoreDatabase;\n}\n\nconst __assertFunctionSpaceIsCompatibleWithTheClientSpace = () => {\n  // eslint-disable-next-line unused-imports/no-unused-vars\n  const y: SpaceAPI = {} as Space;\n};\n\n//\n// Subscription utils.\n//\n\nexport type RawSubscriptionData = {\n  spaceKey?: string;\n  objects?: string[];\n};\n\nexport type SubscriptionData = {\n  space?: Space;\n  objects?: ReactiveEchoObject<any>[];\n};\n\n/**\n * Handler wrapper for subscription events; extracts space and objects.\n *\n * To test:\n * ```\n * curl -s -X POST -H \"Content-Type: application/json\" --data '{\"space\": \"0446...1cbb\"}' http://localhost:7100/dev/email-extractor\n * ```\n *\n * NOTE: Get space key from devtools or `dx space list --json`\n */\n// TODO(burdon): Evolve into plugin definition like Composer.\nexport const subscriptionHandler = <TMeta>(\n  handler: FunctionHandler<SubscriptionData, TMeta>,\n  types?: S.Schema<any>[],\n): FunctionHandler<RawSubscriptionData, TMeta> => {\n  return async ({ event: { data }, context, response, ...rest }) => {\n    const { client } = context;\n    const space = data.spaceKey ? client.spaces.get(PublicKey.from(data.spaceKey)) : undefined;\n    if (!space) {\n      log.error('Invalid space');\n      return response.status(500);\n    }\n\n    registerTypes(space, types);\n    const objects = space\n      ? data.objects?.map<ReactiveEchoObject<any> | undefined>((id) => space!.db.getObjectById(id)).filter(nonNullable)\n      : [];\n\n    if (!!data.spaceKey && !space) {\n      log.warn('invalid space', { data });\n    } else {\n      log.info('handler', { space: space?.key.truncate(), objects: objects?.length });\n    }\n\n    return handler({ event: { data: { ...data, space, objects } }, context, response, ...rest });\n  };\n};\n\n// TODO(burdon): Evolve types as part of function metadata.\nconst registerTypes = (space: Space, types: S.Schema<any>[] = []) => {\n  const registry = space.db.graph.schemaRegistry;\n  for (const type of types) {\n    if (!registry.hasSchema(type)) {\n      registry.addSchema([type]);\n    }\n  }\n};\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAMA,SAAsBA,iBAAiB;AAGvC,SAASC,WAAW;AACpB,SAASC,mBAAmB;;AAkHrB,IAAMC,sBAAsB,CACjCC,SACAC,UAAAA;AAEA,SAAO,OAAO,EAAEC,OAAO,EAAEC,KAAI,GAAIC,SAASC,UAAU,GAAGC,KAAAA,MAAM;AAC3D,UAAM,EAAEC,OAAM,IAAKH;AACnB,UAAMI,QAAQL,KAAKM,WAAWF,OAAOG,OAAOC,IAAIC,UAAUC,KAAKV,KAAKM,QAAQ,CAAA,IAAKK;AACjF,QAAI,CAACN,OAAO;AACVO,UAAIC,MAAM,iBAAA,QAAA;;;;;;AACV,aAAOX,SAASY,OAAO,GAAA;IACzB;AAEAC,kBAAcV,OAAOP,KAAAA;AACrB,UAAMkB,UAAUX,QACZL,KAAKgB,SAASC,IAAyC,CAACC,OAAOb,MAAOc,GAAGC,cAAcF,EAAAA,CAAAA,EAAKG,OAAOC,WAAAA,IACnG,CAAA;AAEJ,QAAI,CAAC,CAACtB,KAAKM,YAAY,CAACD,OAAO;AAC7BO,UAAIW,KAAK,iBAAiB;QAAEvB;MAAK,GAAA;;;;;;IACnC,OAAO;AACLY,UAAIY,KAAK,WAAW;QAAEnB,OAAOA,OAAOoB,IAAIC,SAAAA;QAAYV,SAASA,SAASW;MAAO,GAAA;;;;;;IAC/E;AAEA,WAAO9B,QAAQ;MAAEE,OAAO;QAAEC,MAAM;UAAE,GAAGA;UAAMK;UAAOW;QAAQ;MAAE;MAAGf;MAASC;MAAU,GAAGC;IAAK,CAAA;EAC5F;AACF;AAGA,IAAMY,gBAAgB,CAACV,OAAcP,QAAyB,CAAA,MAAE;AAC9D,QAAM8B,WAAWvB,MAAMc,GAAGU,MAAMC;AAChC,aAAWC,QAAQjC,OAAO;AACxB,QAAI,CAAC8B,SAASI,UAAUD,IAAAA,GAAO;AAC7BH,eAASK,UAAU;QAACF;OAAK;IAC3B;EACF;AACF;",
-  "names": ["PublicKey", "log", "nonNullable", "subscriptionHandler", "handler", "types", "event", "data", "context", "response", "rest", "client", "space", "spaceKey", "spaces", "get", "PublicKey", "from", "undefined", "log", "error", "status", "registerTypes", "objects", "map", "id", "db", "getObjectById", "filter", "nonNullable", "warn", "info", "key", "truncate", "length", "registry", "graph", "schemaRegistry", "type", "hasSchema", "addSchema"]
+  "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport { Schema as S } from '@effect/schema';\nimport { type Effect } from 'effect';\n\nimport { type Client, PublicKey } from '@dxos/client';\nimport { type Space, type SpaceId } from '@dxos/client/echo';\nimport type { CoreDatabase, EchoDatabase, ReactiveEchoObject } from '@dxos/echo-db';\nimport { type HasId } from '@dxos/echo-schema';\nimport { type DXN } from '@dxos/keys';\nimport { log } from '@dxos/log';\nimport { type QueryResult } from '@dxos/protocols';\nimport { isNonNullable } from '@dxos/util';\n\n// TODO(burdon): Model after http request. Ref Lambda/OpenFaaS.\n// https://docs.aws.amazon.com/lambda/latest/dg/typescript-handler.html\n// https://www.serverless.com/framework/docs/providers/aws/guide/serverless.yml/#functions\n// https://www.npmjs.com/package/aws-lambda\n\n/**\n * Function handler.\n */\nexport type FunctionHandler<TData = {}, TMeta = {}, TOutput = any> = (params: {\n  context: FunctionContext;\n  event: FunctionEvent<TData, TMeta>;\n  /**\n   * @deprecated\n   */\n  response: FunctionResponse;\n}) => TOutput | Promise<TOutput> | Effect.Effect<TOutput, any>;\n\n/**\n * Function context.\n */\nexport interface FunctionContext {\n  getSpace: (spaceId: SpaceId) => Promise<SpaceAPI>;\n\n  /**\n   * Space from which the function was invoked.\n   */\n  space: SpaceAPI | undefined;\n\n  ai: FunctionContextAi;\n\n  /**\n   * @deprecated\n   */\n  // TODO(burdon): Limit access to individual space.\n  client: Client;\n  /**\n   * @deprecated\n   */\n  // TODO(burdon): Replace with storage service abstraction.\n  dataDir?: string;\n}\n\nexport interface FunctionContextAi {\n  // TODO(dmaretskyi): Refer to cloudflare AI docs for more comprehensive typedefs.\n  run(model: string, inputs: any, options?: any): Promise<any>;\n}\n\n/**\n * Event payload.\n */\n// TODO(dmaretskyi): Update type definitions to match the actual payload.\nexport type FunctionEvent<TData = {}, TMeta = {}> = {\n  data: FunctionEventMeta<TMeta> & TData;\n};\n\n/**\n * Metadata from trigger.\n */\nexport type FunctionEventMeta<TMeta = {}> = {\n  meta: TMeta;\n};\n\n/**\n * Function response.\n */\nexport type FunctionResponse = {\n  status(code: number): FunctionResponse;\n};\n\n//\n// API.\n//\n\n// TODO(dmaretskyi): Temporary API to get the queues working.\n// TODO(dmaretskyi): To be replaced with integrating queues into echo.\nexport interface QueuesAPI {\n  queryQueue(queue: DXN, options?: {}): Promise<QueryResult>;\n  insertIntoQueue(queue: DXN, objects: HasId[]): Promise<void>;\n}\n\n/**\n * Space interface available to functions.\n */\nexport interface SpaceAPI {\n  get id(): SpaceId;\n  /**\n   * @deprecated\n   */\n  get crud(): CoreDatabase;\n  get db(): EchoDatabase;\n  // TODO(dmaretskyi): Align with echo api --- queues.get(id).append(items);\n  get queues(): QueuesAPI;\n}\n\n// TODO(wittjosiah): Fix this.\nconst __assertFunctionSpaceIsCompatibleWithTheClientSpace = () => {\n  // const _: SpaceAPI = {} as Space;\n};\n\nexport type FunctionDefinition = {\n  description?: string;\n  inputSchema: S.Schema.AnyNoContext;\n  outputSchema?: S.Schema.AnyNoContext;\n  handler: FunctionHandler<any>;\n};\n\nexport type DefineFunctionParams<T, O = any> = {\n  description?: string;\n  inputSchema: S.Schema<T, any>;\n  outputSchema?: S.Schema<O, any>;\n  handler: FunctionHandler<T, any, O>;\n};\n\n// TODO(dmaretskyi): Bind input type to function handler.\nexport const defineFunction = <T, O>(params: DefineFunctionParams<T, O>): FunctionDefinition => {\n  if (!S.isSchema(params.inputSchema)) {\n    throw new Error('Input schema must be a valid schema');\n  }\n  if (typeof params.handler !== 'function') {\n    throw new Error('Handler must be a function');\n  }\n\n  return {\n    description: params.description,\n    inputSchema: params.inputSchema,\n    outputSchema: params.outputSchema ?? S.Any,\n    handler: params.handler,\n  };\n};\n\n//\n// Subscription utils.\n//\n\nexport type RawSubscriptionData = {\n  spaceKey?: string;\n  objects?: string[];\n};\n\nexport type SubscriptionData = {\n  space?: Space;\n  objects?: ReactiveEchoObject<any>[];\n};\n\n/**\n * Handler wrapper for subscription events; extracts space and objects.\n *\n * To test:\n * ```\n * curl -s -X POST -H \"Content-Type: application/json\" --data '{\"space\": \"0446...1cbb\"}' http://localhost:7100/dev/email-extractor\n * ```\n *\n * NOTE: Get space key from devtools or `dx space list --json`\n */\n// TODO(burdon): Evolve into plugin definition like Composer.\nexport const subscriptionHandler = <TMeta>(\n  handler: FunctionHandler<SubscriptionData, TMeta>,\n  types?: S.Schema<any>[],\n): FunctionHandler<RawSubscriptionData, TMeta> => {\n  return async ({ event: { data }, context, response, ...rest }) => {\n    const { client } = context;\n    const space = data.spaceKey ? client.spaces.get(PublicKey.from(data.spaceKey)) : undefined;\n    if (!space) {\n      log.error('Invalid space');\n      return response.status(500);\n    }\n\n    registerTypes(space, types);\n    const objects = space\n      ? data.objects\n          ?.map<ReactiveEchoObject<any> | undefined>((id) => space!.db.getObjectById(id))\n          .filter(isNonNullable)\n      : [];\n\n    if (!!data.spaceKey && !space) {\n      log.warn('invalid space', { data });\n    } else {\n      log.info('handler', { space: space?.key.truncate(), objects: objects?.length });\n    }\n\n    return handler({ event: { data: { ...data, space, objects } }, context, response, ...rest });\n  };\n};\n\n// TODO(burdon): Evolve types as part of function metadata.\nconst registerTypes = (space: Space, types: S.Schema<any>[] = []) => {\n  const registry = space.db.graph.schemaRegistry;\n  for (const type of types) {\n    if (!registry.hasSchema(type)) {\n      registry.addSchema([type]);\n    }\n  }\n};\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAIA,SAASA,UAAUC,SAAS;AAG5B,SAAsBC,iBAAiB;AAKvC,SAASC,WAAW;AAEpB,SAASC,qBAAqB;;AAoHvB,IAAMC,iBAAiB,CAAOC,WAAAA;AACnC,MAAI,CAACC,EAAEC,SAASF,OAAOG,WAAW,GAAG;AACnC,UAAM,IAAIC,MAAM,qCAAA;EAClB;AACA,MAAI,OAAOJ,OAAOK,YAAY,YAAY;AACxC,UAAM,IAAID,MAAM,4BAAA;EAClB;AAEA,SAAO;IACLE,aAAaN,OAAOM;IACpBH,aAAaH,OAAOG;IACpBI,cAAcP,OAAOO,gBAAgBN,EAAEO;IACvCH,SAASL,OAAOK;EAClB;AACF;AA2BO,IAAMI,sBAAsB,CACjCJ,SACAK,UAAAA;AAEA,SAAO,OAAO,EAAEC,OAAO,EAAEC,KAAI,GAAIC,SAASC,UAAU,GAAGC,KAAAA,MAAM;AAC3D,UAAM,EAAEC,OAAM,IAAKH;AACnB,UAAMI,QAAQL,KAAKM,WAAWF,OAAOG,OAAOC,IAAIC,UAAUC,KAAKV,KAAKM,QAAQ,CAAA,IAAKK;AACjF,QAAI,CAACN,OAAO;AACVO,UAAIC,MAAM,iBAAA,QAAA;;;;;;AACV,aAAOX,SAASY,OAAO,GAAA;IACzB;AAEAC,kBAAcV,OAAOP,KAAAA;AACrB,UAAMkB,UAAUX,QACZL,KAAKgB,SACDC,IAAyC,CAACC,OAAOb,MAAOc,GAAGC,cAAcF,EAAAA,CAAAA,EAC1EG,OAAOC,aAAAA,IACV,CAAA;AAEJ,QAAI,CAAC,CAACtB,KAAKM,YAAY,CAACD,OAAO;AAC7BO,UAAIW,KAAK,iBAAiB;QAAEvB;MAAK,GAAA;;;;;;IACnC,OAAO;AACLY,UAAIY,KAAK,WAAW;QAAEnB,OAAOA,OAAOoB,IAAIC,SAAAA;QAAYV,SAASA,SAASW;MAAO,GAAA;;;;;;IAC/E;AAEA,WAAOlC,QAAQ;MAAEM,OAAO;QAAEC,MAAM;UAAE,GAAGA;UAAMK;UAAOW;QAAQ;MAAE;MAAGf;MAASC;MAAU,GAAGC;IAAK,CAAA;EAC5F;AACF;AAGA,IAAMY,gBAAgB,CAACV,OAAcP,QAAyB,CAAA,MAAE;AAC9D,QAAM8B,WAAWvB,MAAMc,GAAGU,MAAMC;AAChC,aAAWC,QAAQjC,OAAO;AACxB,QAAI,CAAC8B,SAASI,UAAUD,IAAAA,GAAO;AAC7BH,eAASK,UAAU;QAACF;OAAK;IAC3B;EACF;AACF;",
+  "names": ["Schema", "S", "PublicKey", "log", "isNonNullable", "defineFunction", "params", "S", "isSchema", "inputSchema", "Error", "handler", "description", "outputSchema", "Any", "subscriptionHandler", "types", "event", "data", "context", "response", "rest", "client", "space", "spaceKey", "spaces", "get", "PublicKey", "from", "undefined", "log", "error", "status", "registerTypes", "objects", "map", "id", "db", "getObjectById", "filter", "isNonNullable", "warn", "info", "key", "truncate", "length", "registry", "graph", "schemaRegistry", "type", "hasSchema", "addSchema"]
 }