@tailor-platform/sdk 2.0.0-next.1 → 2.0.0-next.2

package/dist/file-_oUZo76X.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"file-_oUZo76X.mjs","names":[],"sources":["../src/runtime/file.ts"],"sourcesContent":["/**\n * TailorDB file (BLOB) utilities.\n *\n * Thin typed wrapper around the platform-provided `tailordb.file` runtime API.\n * At runtime this delegates to `globalThis.tailordb.file`. Use `mockFile` from\n * `@tailor-platform/sdk/vitest` to mock these calls in unit tests.\n * @example\n * import { file } from \"@tailor-platform/sdk/runtime\";\n *\n * const { metadata } = await file.upload(\n *   \"my-namespace\",\n *   \"Document\",\n *   \"attachment\",\n *   recordId,\n *   bytes,\n * );\n */\n\n/** Upload response metadata. */\nexport interface UploadMetadata {\n  fileSize: number;\n  sha256sum: string;\n}\n\n/** Download response metadata. */\nexport interface DownloadMetadata {\n  contentType: string;\n  fileSize: number;\n  sha256sum: string;\n  lastUploadedAt: string;\n}\n\n/** File metadata (for {@link getMetadata}). */\nexport interface FileMetadata {\n  contentType: string;\n  fileSize: number;\n  sha256sum: string;\n  urlPath: string;\n  lastUploadedAt?: string;\n}\n\n/** Stream metadata (first chunk emitted by {@link openDownloadStream}). */\nexport interface StreamMetadata {\n  contentType: string;\n  fileSize: number;\n  sha256sum: string;\n}\n\n/** Upload options. */\nexport interface FileUploadOptions {\n  contentType?: string;\n}\n\n/** Upload stream options. */\nexport interface FileUploadStreamOptions {\n  contentType?: string;\n  fileSize?: number;\n}\n\n/** Upload response. */\nexport interface FileUploadResponse {\n  metadata: UploadMetadata;\n}\n\n/** Download response. */\nexport interface FileDownloadResponse {\n  data: Uint8Array;\n  metadata: DownloadMetadata;\n}\n\n/** Download-as-Base64 response. */\nexport interface FileDownloadAsBase64Response {\n  data: string;\n  metadata: DownloadMetadata;\n}\n\n/** Download stream response. */\nexport interface FileDownloadStreamResponse {\n  body: ReadableStream<Uint8Array>;\n  metadata: DownloadMetadata;\n}\n\n/** Stream chunk types emitted by {@link FileStreamIterator}. */\nexport type StreamValue =\n  | { type: \"metadata\"; metadata: StreamMetadata }\n  | { type: \"chunk\"; data: Uint8Array; position: number }\n  | { type: \"complete\" };\n\n/** Stream iterator returned by {@link openDownloadStream}. */\nexport interface FileStreamIterator extends AsyncIterableIterator<StreamValue> {\n  next(): Promise<IteratorResult<StreamValue>>;\n  close(): Promise<void>;\n}\n\n/** Error code emitted by {@link TailorDBFileError}. */\nexport type TailorDBFileErrorCode =\n  | \"INVALID_PARAMS\"\n  | \"INVALID_DATA_TYPE\"\n  | \"OPERATION_FAILED\"\n  | \"DELETE_FAILED\"\n  | \"STREAM_OPEN_FAILED\"\n  | \"STREAM_READ_ERROR\"\n  | \"STREAM_ERROR\"\n  | \"FILE_TOO_LARGE\";\n\n/**\n * Type-only shape of the `TailorDBFileError` runtime class. The class itself\n * is provided by the platform runtime (and by `injectMocks` in tests); this\n * interface mirrors it so callers can `import type { TailorDBFileError }` from\n * the wrapper module without depending on any ambient declaration.\n */\nexport interface TailorDBFileError extends Error {\n  name: \"TailorDBFileError\";\n  code?: TailorDBFileErrorCode;\n  cause?: unknown;\n}\n\n/**\n * Platform API surface for `tailordb.file`. Describes the shape the platform\n * runtime injects on `globalThis.tailordb.file`.\n *\n * Each method below is also re-exported as a top-level named export from this\n * module (e.g. `upload`, `download`, `deleteFile`) so callers can either\n * `import * as file from \"@tailor-platform/sdk/runtime/file\"` or pick\n * individual methods.\n */\nexport interface TailorDBFileAPI {\n  /**\n   * Upload a file to TailorDB.\n   * @param namespace - TailorDB namespace\n   * @param typeName - TailorDB type name\n   * @param fieldName - File field name on the type\n   * @param recordId - Record ID owning the field\n   * @param data - File contents\n   * @param options - Upload options (e.g. `contentType`)\n   * @returns Upload response containing the file metadata\n   */\n  upload(\n    namespace: string,\n    typeName: string,\n    fieldName: string,\n    recordId: string,\n    data: string | ArrayBuffer | Uint8Array | number[],\n    options?: FileUploadOptions,\n  ): Promise<FileUploadResponse>;\n\n  /**\n   * Download a file from TailorDB.\n   *\n   * Throws `TailorDBFileError` with code `FILE_TOO_LARGE` when the file\n   * exceeds 10MB — use {@link downloadStream} for large files.\n   * @param namespace - TailorDB namespace\n   * @param typeName - TailorDB type name\n   * @param fieldName - File field name on the type\n   * @param recordId - Record ID owning the field\n   * @returns Bytes and metadata for the file\n   */\n  download(\n    namespace: string,\n    typeName: string,\n    fieldName: string,\n    recordId: string,\n  ): Promise<FileDownloadResponse>;\n\n  /**\n   * Download a file from TailorDB as a Base64-encoded string.\n   *\n   * Throws `TailorDBFileError` with code `FILE_TOO_LARGE` when the file\n   * exceeds 10MB — use {@link downloadStream} for large files.\n   * @param namespace - TailorDB namespace\n   * @param typeName - TailorDB type name\n   * @param fieldName - File field name on the type\n   * @param recordId - Record ID owning the field\n   * @returns Base64-encoded contents and metadata for the file\n   */\n  downloadAsBase64(\n    namespace: string,\n    typeName: string,\n    fieldName: string,\n    recordId: string,\n  ): Promise<FileDownloadAsBase64Response>;\n\n  /**\n   * Delete a file from TailorDB. Exported as `deleteFile` (and aliased as\n   * `delete`) so it can be used both with named and namespace imports.\n   * @param namespace - TailorDB namespace\n   * @param typeName - TailorDB type name\n   * @param fieldName - File field name on the type\n   * @param recordId - Record ID owning the field\n   * @returns Resolves once the file has been deleted\n   */\n  delete(namespace: string, typeName: string, fieldName: string, recordId: string): Promise<void>;\n\n  /**\n   * Get file metadata from TailorDB.\n   * @param namespace - TailorDB namespace\n   * @param typeName - TailorDB type name\n   * @param fieldName - File field name on the type\n   * @param recordId - Record ID owning the field\n   * @returns Metadata for the stored file\n   */\n  getMetadata(\n    namespace: string,\n    typeName: string,\n    fieldName: string,\n    recordId: string,\n  ): Promise<FileMetadata>;\n\n  /**\n   * Open a download stream for large files.\n   * @deprecated Use {@link downloadStream} instead.\n   * @param namespace - TailorDB namespace\n   * @param typeName - TailorDB type name\n   * @param fieldName - File field name on the type\n   * @param recordId - Record ID owning the field\n   * @returns Async iterator yielding file chunks; call `close()` to release resources\n   */\n  openDownloadStream(\n    namespace: string,\n    typeName: string,\n    fieldName: string,\n    recordId: string,\n  ): Promise<FileStreamIterator>;\n\n  /**\n   * Download a file as a ReadableStream.\n   * @param namespace - TailorDB namespace\n   * @param typeName - TailorDB type name\n   * @param fieldName - File field name on the type\n   * @param recordId - Record ID owning the field\n   * @returns ReadableStream body and metadata for the file\n   */\n  downloadStream(\n    namespace: string,\n    typeName: string,\n    fieldName: string,\n    recordId: string,\n  ): Promise<FileDownloadStreamResponse>;\n\n  /**\n   * Upload a file using a ReadableStream.\n   * @param namespace - TailorDB namespace\n   * @param typeName - TailorDB type name\n   * @param fieldName - File field name on the type\n   * @param recordId - Record ID owning the field\n   * @param readableStream - ReadableStream providing the file data\n   * @param options - Upload stream options (e.g. `contentType`, `fileSize`)\n   * @returns Upload response containing the file metadata\n   */\n  uploadStream(\n    namespace: string,\n    typeName: string,\n    fieldName: string,\n    recordId: string,\n    readableStream: ReadableStream<Uint8Array | ArrayBuffer>,\n    options?: FileUploadStreamOptions,\n  ): Promise<FileUploadResponse>;\n}\n\nconst api = (): TailorDBFileAPI =>\n  (globalThis as { tailordb: { file: TailorDBFileAPI } }).tailordb.file;\n\n/**\n * See {@link TailorDBFileAPI.upload}.\n * @param args - Forwarded to {@link TailorDBFileAPI.upload}\n * @returns Upload response containing the file metadata\n */\nexport const upload: TailorDBFileAPI[\"upload\"] = (...args) => api().upload(...args);\n\n/**\n * See {@link TailorDBFileAPI.download}.\n * @param args - Forwarded to {@link TailorDBFileAPI.download}\n * @returns Bytes and metadata for the file\n */\nexport const download: TailorDBFileAPI[\"download\"] = (...args) => api().download(...args);\n\n/**\n * See {@link TailorDBFileAPI.downloadAsBase64}.\n * @param args - Forwarded to {@link TailorDBFileAPI.downloadAsBase64}\n * @returns Base64-encoded contents and metadata for the file\n */\nexport const downloadAsBase64: TailorDBFileAPI[\"downloadAsBase64\"] = (...args) =>\n  api().downloadAsBase64(...args);\n\n/**\n * See {@link TailorDBFileAPI.delete}.\n * @param args - Forwarded to {@link TailorDBFileAPI.delete}\n * @returns Resolves once the file has been deleted\n */\nexport const deleteFile: TailorDBFileAPI[\"delete\"] = (...args) => api().delete(...args);\n\n/**\n * See {@link TailorDBFileAPI.getMetadata}.\n * @param args - Forwarded to {@link TailorDBFileAPI.getMetadata}\n * @returns Metadata for the stored file\n */\nexport const getMetadata: TailorDBFileAPI[\"getMetadata\"] = (...args) => api().getMetadata(...args);\n\n/**\n * See {@link TailorDBFileAPI.openDownloadStream}.\n * @deprecated Use {@link downloadStream} instead.\n * @param args - Forwarded to {@link TailorDBFileAPI.openDownloadStream}\n * @returns Async iterator yielding file chunks; call `close()` to release resources\n */\nexport const openDownloadStream: TailorDBFileAPI[\"openDownloadStream\"] = (...args) =>\n  api().openDownloadStream(...args);\n\n/**\n * See {@link TailorDBFileAPI.downloadStream}.\n * @param args - Forwarded to {@link TailorDBFileAPI.downloadStream}\n * @returns ReadableStream body and metadata for the file\n */\nexport const downloadStream: TailorDBFileAPI[\"downloadStream\"] = (...args) =>\n  api().downloadStream(...args);\n\n/**\n * See {@link TailorDBFileAPI.uploadStream}.\n * @param args - Forwarded to {@link TailorDBFileAPI.uploadStream}\n * @returns Upload response containing the file metadata\n */\nexport const uploadStream: TailorDBFileAPI[\"uploadStream\"] = (...args) =>\n  api().uploadStream(...args);\n\nexport { deleteFile as delete };\n"],"mappings":";;;;;;;;;;;;;;AAmQA,MAAM,YACH,WAAuD,SAAS;;;;;;AAOnE,MAAa,UAAqC,GAAG,SAAS,IAAI,CAAC,CAAC,OAAO,GAAG,IAAI;;;;;;AAOlF,MAAa,YAAyC,GAAG,SAAS,IAAI,CAAC,CAAC,SAAS,GAAG,IAAI;;;;;;AAOxF,MAAa,oBAAyD,GAAG,SACvE,IAAI,CAAC,CAAC,iBAAiB,GAAG,IAAI;;;;;;AAOhC,MAAa,cAAyC,GAAG,SAAS,IAAI,CAAC,CAAC,OAAO,GAAG,IAAI;;;;;;AAOtF,MAAa,eAA+C,GAAG,SAAS,IAAI,CAAC,CAAC,YAAY,GAAG,IAAI;;;;;;;AAQjG,MAAa,sBAA6D,GAAG,SAC3E,IAAI,CAAC,CAAC,mBAAmB,GAAG,IAAI;;;;;;AAOlC,MAAa,kBAAqD,GAAG,SACnE,IAAI,CAAC,CAAC,eAAe,GAAG,IAAI;;;;;;AAO9B,MAAa,gBAAiD,GAAG,SAC/D,IAAI,CAAC,CAAC,aAAa,GAAG,IAAI"}

package/dist/file-utils-DcyIPFQh.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"file-utils-DcyIPFQh.mjs","names":[],"sources":["../src/plugin/builtin/file-utils/generate-file-utils.ts","../src/plugin/builtin/file-utils/process-file-type.ts","../src/plugin/builtin/file-utils/index.ts"],"sourcesContent":["import multiline from \"@/utils/multiline\";\nimport type { FileUtilMetadata } from \"./types\";\n\n/**\n * Generate unified file utility functions from collected metadata.\n * @param namespaceData - Namespace data with file utility metadata\n * @returns Generated file utility code\n */\nexport function generateUnifiedFileUtils(\n  namespaceData: { namespace: string; types: FileUtilMetadata[] }[],\n): string {\n  if (namespaceData.length === 0) {\n    return \"\";\n  }\n\n  // Collect all types with their namespace\n  const typeNamespaceMap = new Map<string, string>();\n  const typeFieldsMap = new Map<string, string[]>();\n\n  for (const { namespace, types } of namespaceData) {\n    for (const type of types) {\n      typeNamespaceMap.set(type.name, namespace);\n      typeFieldsMap.set(type.name, type.fileFields);\n    }\n  }\n\n  if (typeNamespaceMap.size === 0) {\n    return \"\";\n  }\n\n  // Generate interface fields\n  const interfaceFields = Array.from(typeFieldsMap.entries())\n    .map(([typeName, fields]) => {\n      const fieldNamesUnion = fields.map((field) => `\"${field}\"`).join(\" | \");\n      return `  ${typeName}: {\\n    fields: ${fieldNamesUnion};\\n  };`;\n    })\n    .join(\"\\n\");\n\n  const importStatement =\n    multiline /* ts */ `\n      import * as file from \"@tailor-platform/sdk/runtime/file\";\n      import type {\n        FileUploadOptions,\n        FileUploadResponse,\n        FileMetadata,\n        FileStreamIterator,\n      } from \"@tailor-platform/sdk/runtime/file\";\n    ` + \"\\n\";\n\n  const interfaceDefinition =\n    multiline /* ts */ `\n      export interface TypeWithFiles {\n      ${interfaceFields}\n      }\n    ` + \"\\n\";\n\n  // Generate namespaces object\n  const namespaceEntries = Array.from(typeNamespaceMap.entries())\n    .map(([typeName, namespace]) => `  ${typeName}: \"${namespace}\"`)\n    .join(\",\\n\");\n\n  const namespacesDefinition =\n    multiline /* ts */ `\n      const namespaces: Record<keyof TypeWithFiles, string> = {\n      ${namespaceEntries},\n      };\n    ` + \"\\n\";\n\n  // Generate downloadFile helper function\n  const downloadFunction =\n    multiline /* ts */ `\n      export async function downloadFile<T extends keyof TypeWithFiles>(\n        type: T,\n        field: TypeWithFiles[T][\"fields\"],\n        recordId: string,\n      ) {\n        return await file.download(namespaces[type], type, field, recordId);\n      }\n    ` + \"\\n\";\n\n  // Generate uploadFile helper function\n  const uploadFunction =\n    multiline /* ts */ `\n      export async function uploadFile<T extends keyof TypeWithFiles>(\n        type: T,\n        field: TypeWithFiles[T][\"fields\"],\n        recordId: string,\n        data: string | ArrayBuffer | Uint8Array<ArrayBufferLike> | number[],\n        options?: FileUploadOptions,\n      ): Promise<FileUploadResponse> {\n        return await file.upload(namespaces[type], type, field, recordId, data, options);\n      }\n    ` + \"\\n\";\n\n  // Generate deleteFile helper function\n  const deleteFunction =\n    multiline /* ts */ `\n      export async function deleteFile<T extends keyof TypeWithFiles>(\n        type: T,\n        field: TypeWithFiles[T][\"fields\"],\n        recordId: string,\n      ): Promise<void> {\n        return await file.delete(namespaces[type], type, field, recordId);\n      }\n    ` + \"\\n\";\n\n  // Generate getFileMetadata helper function\n  const getMetadataFunction =\n    multiline /* ts */ `\n      export async function getFileMetadata<T extends keyof TypeWithFiles>(\n        type: T,\n        field: TypeWithFiles[T][\"fields\"],\n        recordId: string,\n      ): Promise<FileMetadata> {\n        return await file.getMetadata(namespaces[type], type, field, recordId);\n      }\n    ` + \"\\n\";\n\n  // Generate openFileDownloadStream helper function\n  const openDownloadStreamFunction =\n    multiline /* ts */ `\n      export async function openFileDownloadStream<T extends keyof TypeWithFiles>(\n        type: T,\n        field: TypeWithFiles[T][\"fields\"],\n        recordId: string,\n      ): Promise<FileStreamIterator> {\n        return await file.openDownloadStream(namespaces[type], type, field, recordId);\n      }\n    ` + \"\\n\";\n\n  return [\n    importStatement,\n    interfaceDefinition,\n    namespacesDefinition,\n    downloadFunction,\n    uploadFunction,\n    deleteFunction,\n    getMetadataFunction,\n    openDownloadStreamFunction,\n  ].join(\"\\n\");\n}\n","import type { FileUtilMetadata } from \"./types\";\nimport type { TailorDBType } from \"@/parser/service/tailordb/types\";\n\n/**\n * Process a TailorDB type and extract file field metadata.\n * @param type - The parsed TailorDB type to process\n * @returns File utility metadata for the type\n */\nexport async function processFileType(type: TailorDBType): Promise<FileUtilMetadata> {\n  const fileFields: string[] = [];\n\n  if (type.files) {\n    for (const fileFieldName of Object.keys(type.files)) {\n      fileFields.push(fileFieldName);\n    }\n  }\n\n  return {\n    name: type.name,\n    fileFields,\n  };\n}\n","import { generateUnifiedFileUtils } from \"./generate-file-utils\";\nimport { processFileType } from \"./process-file-type\";\nimport type { FileUtilMetadata } from \"./types\";\nimport type { Plugin, GeneratorResult, TailorDBReadyContext } from \"@/plugin/types\";\n\n/** Unique identifier for the file utilities generator plugin. */\nexport const FileUtilsGeneratorID = \"@tailor-platform/file-utils\";\n\ntype FileUtilsPluginOptions = {\n  distPath: string;\n};\n\n/**\n * Plugin that generates TypeWithFiles interface from TailorDB type definitions.\n * @param options - Plugin options\n * @param options.distPath - Output file path for generated file utilities\n * @returns Plugin instance with onTailorDBReady hook\n */\nexport function fileUtilsPlugin(\n  options: FileUtilsPluginOptions,\n): Plugin<unknown, FileUtilsPluginOptions> {\n  return {\n    id: FileUtilsGeneratorID,\n    description: \"Generates TypeWithFiles interface from TailorDB type definitions\",\n    pluginConfig: options,\n\n    async onTailorDBReady(\n      ctx: TailorDBReadyContext<FileUtilsPluginOptions>,\n    ): Promise<GeneratorResult> {\n      const namespaceData: { namespace: string; types: FileUtilMetadata[] }[] = [];\n\n      for (const ns of ctx.tailordb) {\n        const typesWithFiles: FileUtilMetadata[] = [];\n\n        for (const type of Object.values(ns.types)) {\n          const metadata = await processFileType(type);\n          if (metadata.fileFields.length > 0) {\n            typesWithFiles.push(metadata);\n          }\n        }\n\n        if (typesWithFiles.length > 0) {\n          namespaceData.push({\n            namespace: ns.namespace,\n            types: typesWithFiles,\n          });\n        }\n      }\n\n      const files: GeneratorResult[\"files\"] = [];\n      if (namespaceData.length > 0) {\n        const content = generateUnifiedFileUtils(namespaceData);\n        if (content) {\n          files.push({\n            path: ctx.pluginConfig.distPath,\n            content,\n          });\n        }\n      }\n\n      return { files };\n    },\n  };\n}\n"],"mappings":";;;;;;;;AAQA,SAAgB,yBACd,eACQ;CACR,IAAI,cAAc,WAAW,GAC3B,OAAO;CAIT,MAAM,mCAAmB,IAAI,IAAoB;CACjD,MAAM,gCAAgB,IAAI,IAAsB;CAEhD,KAAK,MAAM,EAAE,WAAW,WAAW,eACjC,KAAK,MAAM,QAAQ,OAAO;EACxB,iBAAiB,IAAI,KAAK,MAAM,SAAS;EACzC,cAAc,IAAI,KAAK,MAAM,KAAK,UAAU;CAC9C;CAGF,IAAI,iBAAiB,SAAS,GAC5B,OAAO;CAIT,MAAM,kBAAkB,MAAM,KAAK,cAAc,QAAQ,CAAC,CAAC,CACxD,KAAK,CAAC,UAAU,YAAY;EAE3B,OAAO,KAAK,SAAS,mBADG,OAAO,KAAK,UAAU,IAAI,MAAM,EAAE,CAAC,CAAC,KAAK,KACX,EAAE;CAC1D,CAAC,CAAC,CACD,KAAK,IAAI;CA8FZ,OAAO;EA3FL,SAAmB;;;;;;;;QAQf;EAGJ,SAAmB;;QAEf,gBAAgB;;QAEhB;EAQJ,SAAmB;;QALI,MAAM,KAAK,iBAAiB,QAAQ,CAAC,CAAC,CAC5D,KAAK,CAAC,UAAU,eAAe,KAAK,SAAS,KAAK,UAAU,EAAE,CAAC,CAC/D,KAAK,KAKa,EAAE;;QAEjB;EAIJ,SAAmB;;;;;;;;QAQf;EAIJ,SAAmB;;;;;;;;;;QAUf;EAIJ,SAAmB;;;;;;;;QAQf;EAIJ,SAAmB;;;;;;;;QAQf;EAIJ,SAAmB;;;;;;;;QAQf;CAWN,CAAC,CAAC,KAAK,IAAI;AACb;;;;;;;;;ACpIA,eAAsB,gBAAgB,MAA+C;CACnF,MAAM,aAAuB,CAAC;CAE9B,IAAI,KAAK,OACP,KAAK,MAAM,iBAAiB,OAAO,KAAK,KAAK,KAAK,GAChD,WAAW,KAAK,aAAa;CAIjC,OAAO;EACL,MAAM,KAAK;EACX;CACF;AACF;;;;;ACfA,MAAa,uBAAuB;;;;;;;AAYpC,SAAgB,gBACd,SACyC;CACzC,OAAO;EACL,IAAI;EACJ,aAAa;EACb,cAAc;EAEd,MAAM,gBACJ,KAC0B;GAC1B,MAAM,gBAAoE,CAAC;GAE3E,KAAK,MAAM,MAAM,IAAI,UAAU;IAC7B,MAAM,iBAAqC,CAAC;IAE5C,KAAK,MAAM,QAAQ,OAAO,OAAO,GAAG,KAAK,GAAG;KAC1C,MAAM,WAAW,MAAM,gBAAgB,IAAI;KAC3C,IAAI,SAAS,WAAW,SAAS,GAC/B,eAAe,KAAK,QAAQ;IAEhC;IAEA,IAAI,eAAe,SAAS,GAC1B,cAAc,KAAK;KACjB,WAAW,GAAG;KACd,OAAO;IACT,CAAC;GAEL;GAEA,MAAM,QAAkC,CAAC;GACzC,IAAI,cAAc,SAAS,GAAG;IAC5B,MAAM,UAAU,yBAAyB,aAAa;IACtD,IAAI,SACF,MAAM,KAAK;KACT,MAAM,IAAI,aAAa;KACvB;IACF,CAAC;GAEL;GAEA,OAAO,EAAE,MAAM;EACjB;CACF;AACF"}

package/dist/job-fuc3j1Ma.mjs

@@ -1,53 +0,0 @@
-import { t as brandValue } from "./brand-Eo4pLXPJ.mjs";
-import { a as registerJob, n as dispatchTriggerJob } from "./registry-DdsYlL_P.mjs";
-
-//#region src/configure/services/workflow/job.ts
-/**
-* Create a workflow job definition.
-*
-* All jobs must be named exports from the workflow file.
-* Job names must be unique across the entire project.
-*
-* Input and output must be JsonValue-compatible (primitives, plain objects, arrays).
-* Functions and objects with a `toJSON` method are rejected at the type level;
-* class instances exposing methods are rejected via the property walk.
-* @param config - Job configuration with name and body function.
-* @param config.name - Unique job name across the project.
-* @param config.body - Function that processes the job input.
-* @returns A WorkflowJob that can be triggered from other jobs.
-* @example
-* // Simple job with async body:
-* export const fetchData = createWorkflowJob({
-*   name: "fetch-data",
-*   body: async (input: { id: string }) => {
-*     const db = getDB("tailordb");
-*     return await db.selectFrom("Table").selectAll().where("id", "=", input.id).executeTakeFirst();
-*   },
-* });
-* @example
-* // Orchestrator job that fans out to other jobs.
-* export const orchestrate = createWorkflowJob({
-*   name: "orchestrate",
-*   body: (input: { orderId: string }) => {
-*     const inventory = checkInventory.trigger({ orderId: input.orderId });
-*     const payment = processPayment.trigger({ orderId: input.orderId });
-*     return { inventory, payment };
-*   },
-* });
-*/
-function createWorkflowJob(config) {
-	const body = config.body;
-	if (!process.env.TAILOR_PLATFORM_BUNDLE) registerJob(config.name, body);
-	const trigger = process.env.TAILOR_PLATFORM_BUNDLE ? () => {
-		throw new Error("This workflow job's .trigger() is rewritten at build time and is unavailable in the bundle");
-	} : (args) => dispatchTriggerJob(config.name, args);
-	return brandValue({
-		name: config.name,
-		trigger,
-		body
-	}, "workflow-job");
-}
-
-//#endregion
-export { createWorkflowJob as t };
-//# sourceMappingURL=job-fuc3j1Ma.mjs.map

package/dist/job-fuc3j1Ma.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"job-fuc3j1Ma.mjs","names":[],"sources":["../src/configure/services/workflow/job.ts"],"sourcesContent":["import { brandValue } from \"@/utils/brand\";\nimport { dispatchTriggerJob, registerJob, type RegisteredJobBody } from \"./registry\";\nimport type { TailorEnv, TailorInvoker } from \"@/runtime/types\";\nimport type { JsonCompatible } from \"@/types/helpers\";\n\n/**\n * Context object passed as the second argument to workflow job body functions.\n */\nexport type WorkflowJobContext = {\n  env: TailorEnv;\n  invoker?: TailorInvoker;\n};\n\n/**\n * The body function type for a workflow job.\n * Resolves to the callable signature when `I` / `O` are JsonValue-compatible,\n * or to a template-literal error string that surfaces at the `body:` property.\n */\ntype JobBody<I, O> = [null] extends [I]\n  ? \"ERROR: Input cannot be null at the top level\"\n  : [I] extends [undefined]\n    ? [O] extends [JsonCompatible<O> | undefined | void]\n      ? (input: I, context: WorkflowJobContext) => O | Promise<O>\n      : \"ERROR: Output must be JsonValue-compatible (plain objects/arrays; no class instances or functions)\"\n    : [undefined] extends [I]\n      ? \"ERROR: Input cannot include undefined at the top level\"\n      : [I] extends [JsonCompatible<I>]\n        ? [O] extends [JsonCompatible<O> | undefined | void]\n          ? (input: I, context: WorkflowJobContext) => O | Promise<O>\n          : \"ERROR: Output must be JsonValue-compatible (plain objects/arrays; no class instances or functions)\"\n        : \"ERROR: Input must be JsonValue-compatible (plain objects/arrays; no class instances or functions)\";\n\n/**\n * WorkflowJob represents a job that can be triggered in a workflow.\n *\n * Type constraints:\n * - Input: Must be JsonValue-compatible (plain objects/arrays; no class instances or functions) or undefined.\n * - Output: Must be JsonValue-compatible (plain objects/arrays; no class instances or functions), undefined, or void.\n * - Trigger returns `Awaited<Output>` as-is (no Promise or Jsonify transformation).\n */\nexport interface WorkflowJob<Name extends string = string, Input = undefined, Output = undefined> {\n  name: Name;\n  /**\n   * Trigger this job with the given input and return the job's output value.\n   * @example\n   * body: async (input) => {\n   *   const a = jobA.trigger({ id: input.id });\n   *   const b = jobB.trigger({ id: input.id });\n   *   return { a, b };\n   * }\n   */\n  trigger: [Input] extends [undefined] ? () => Awaited<Output> : (input: Input) => Awaited<Output>;\n  body: (input: Input, context: WorkflowJobContext) => Output | Promise<Output>;\n}\n\nexport { WORKFLOW_TEST_ENV_KEY } from \"./test-env-key\";\n\ninterface CreateWorkflowJobConfig<Name extends string, I, O> {\n  readonly name: Name;\n  readonly body: JobBody<I, O>;\n}\n\n/**\n * Create a workflow job definition.\n *\n * All jobs must be named exports from the workflow file.\n * Job names must be unique across the entire project.\n *\n * Input and output must be JsonValue-compatible (primitives, plain objects, arrays).\n * Functions and objects with a `toJSON` method are rejected at the type level;\n * class instances exposing methods are rejected via the property walk.\n * @param config - Job configuration with name and body function.\n * @param config.name - Unique job name across the project.\n * @param config.body - Function that processes the job input.\n * @returns A WorkflowJob that can be triggered from other jobs.\n * @example\n * // Simple job with async body:\n * export const fetchData = createWorkflowJob({\n *   name: \"fetch-data\",\n *   body: async (input: { id: string }) => {\n *     const db = getDB(\"tailordb\");\n *     return await db.selectFrom(\"Table\").selectAll().where(\"id\", \"=\", input.id).executeTakeFirst();\n *   },\n * });\n * @example\n * // Orchestrator job that fans out to other jobs.\n * export const orchestrate = createWorkflowJob({\n *   name: \"orchestrate\",\n *   body: (input: { orderId: string }) => {\n *     const inventory = checkInventory.trigger({ orderId: input.orderId });\n *     const payment = processPayment.trigger({ orderId: input.orderId });\n *     return { inventory, payment };\n *   },\n * });\n */\nexport function createWorkflowJob<const Name extends string, I = undefined, O = undefined>(\n  config: CreateWorkflowJobConfig<Name, I, O>,\n): WorkflowJob<Name, I, Awaited<O>> {\n  const body = config.body as (input: I, context: WorkflowJobContext) => O | Promise<O>;\n\n  // Test-only local runner registry; the platform bundle sets the flag so it is DCE'd.\n  if (!process.env.TAILOR_PLATFORM_BUNDLE) {\n    registerJob(config.name, body as RegisteredJobBody);\n  }\n\n  const trigger = process.env.TAILOR_PLATFORM_BUNDLE\n    ? () => {\n        throw new Error(\n          \"This workflow job's .trigger() is rewritten at build time and is unavailable in the bundle\",\n        );\n      }\n    : (args?: unknown) => dispatchTriggerJob(config.name, args) as Awaited<O>;\n\n  return brandValue(\n    { name: config.name, trigger, body } as WorkflowJob<Name, I, Awaited<O>>,\n    \"workflow-job\",\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+FA,SAAgB,kBACd,QACkC;CAClC,MAAM,OAAO,OAAO;CAGpB,IAAI,CAAC,QAAQ,IAAI,wBACf,YAAY,OAAO,MAAM,IAAyB;CAGpD,MAAM,UAAU,QAAQ,IAAI,+BAClB;EACJ,MAAM,IAAI,MACR,4FACF;CACF,KACC,SAAmB,mBAAmB,OAAO,MAAM,IAAI;CAE5D,OAAO,WACL;EAAE,MAAM,OAAO;EAAM;EAAS;CAAK,GACnC,cACF;AACF"}

package/dist/registry-DdsYlL_P.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"registry-DdsYlL_P.mjs","names":[],"sources":["../src/configure/services/workflow/registry.ts"],"sourcesContent":["import type { TailorEnv, TailorInvoker } from \"@/runtime/types\";\n\n/**\n * Body signature shared by workflow jobs at registry-write time.\n * The user's `createWorkflowJob`/`createWorkflow` body uses concrete types,\n * but the registry erases them for storage.\n */\nexport type RegisteredJobBody = (\n  args: unknown,\n  context: { env: TailorEnv; invoker?: TailorInvoker },\n) => unknown | Promise<unknown>;\n\nconst JOB_REGISTRY_KEY: unique symbol = Symbol.for(\"tailor-platform/sdk:job-registry\");\n\ntype PlatformWorkflow = {\n  triggerWorkflow: (name: string, args?: unknown, options?: unknown) => Promise<string>;\n  triggerJobFunction: (name: string, args?: unknown) => unknown;\n};\n\ntype GlobalWithRegistry = typeof globalThis & {\n  [JOB_REGISTRY_KEY]?: Map<string, RegisteredJobBody>;\n  tailor?: { workflow?: PlatformWorkflow };\n};\n\nfunction jobs(): Map<string, RegisteredJobBody> {\n  const g = globalThis as GlobalWithRegistry;\n  let map = g[JOB_REGISTRY_KEY];\n  if (!map) {\n    map = new Map();\n    g[JOB_REGISTRY_KEY] = map;\n  }\n  return map;\n}\n\n/**\n * Register a job body keyed by job name. Called as a side effect by\n * `createWorkflowJob` so `runWorkflowLocally()` can execute dependent job\n * bodies when `globalThis.tailor.workflow.triggerJobFunction(name, args)` is invoked.\n *\n * In production builds the bundler rewrites `.trigger()` calls so this registry\n * is never read; the gated write is dropped as dead code.\n * @param name - Job name\n * @param body - Job body function\n */\nexport function registerJob(name: string, body: RegisteredJobBody): void {\n  jobs().set(name, body);\n}\n\n/**\n * Look up a registered job body by name.\n * @param name - Job name\n * @returns The registered body, or undefined when no job is registered\n */\nexport function getRegisteredJob(name: string): RegisteredJobBody | undefined {\n  return jobs().get(name);\n}\n\nfunction currentPlatformWorkflow(): PlatformWorkflow | undefined {\n  // globalThis may not have the tailor property at runtime\n  // oxlint-disable-next-line typescript/no-unnecessary-condition\n  return (globalThis as GlobalWithRegistry).tailor?.workflow;\n}\n\nfunction requirePlatformWorkflow(): PlatformWorkflow {\n  const workflow = currentPlatformWorkflow();\n  if (!workflow) {\n    throw new Error(\n      \"tailor.workflow is not available. Run tests in the `tailor-runtime` Vitest environment and use mockWorkflow(), or use runWorkflowLocally() from @tailor-platform/sdk/vitest for local workflow execution.\",\n    );\n  }\n  return workflow;\n}\n\n// A valid placeholder UUID, so callers that validate the execution id behave the\n// same locally as against the platform.\nexport const TRIGGER_DEFAULT = \"00000000-0000-4000-8000-000000000000\";\n\n// `.trigger()` routes through the installed `tailor.workflow` shim. Local body\n// execution is intentionally available only through `runWorkflowLocally()`.\nexport function dispatchTriggerJob(name: string, args?: unknown): unknown {\n  return requirePlatformWorkflow().triggerJobFunction(name, args);\n}\n\nexport function dispatchTriggerWorkflow(\n  name: string,\n  args?: unknown,\n  options?: unknown,\n): Promise<string> {\n  return requirePlatformWorkflow().triggerWorkflow(name, args, options);\n}\n"],"mappings":";AAYA,MAAM,mBAAkC,OAAO,IAAI,kCAAkC;AAYrF,SAAS,OAAuC;CAC9C,MAAM,IAAI;CACV,IAAI,MAAM,EAAE;CACZ,IAAI,CAAC,KAAK;EACR,sBAAM,IAAI,IAAI;EACd,EAAE,oBAAoB;CACxB;CACA,OAAO;AACT;;;;;;;;;;;AAYA,SAAgB,YAAY,MAAc,MAA+B;CACvE,KAAK,CAAC,CAAC,IAAI,MAAM,IAAI;AACvB;;;;;;AAOA,SAAgB,iBAAiB,MAA6C;CAC5E,OAAO,KAAK,CAAC,CAAC,IAAI,IAAI;AACxB;AAEA,SAAS,0BAAwD;CAG/D,OAAQ,WAAkC,QAAQ;AACpD;AAEA,SAAS,0BAA4C;CACnD,MAAM,WAAW,wBAAwB;CACzC,IAAI,CAAC,UACH,MAAM,IAAI,MACR,2MACF;CAEF,OAAO;AACT;AAIA,MAAa,kBAAkB;AAI/B,SAAgB,mBAAmB,MAAc,MAAyB;CACxE,OAAO,wBAAwB,CAAC,CAAC,mBAAmB,MAAM,IAAI;AAChE;AAEA,SAAgB,wBACd,MACA,MACA,SACiB;CACjB,OAAO,wBAAwB,CAAC,CAAC,gBAAgB,MAAM,MAAM,OAAO;AACtE"}