workerstack 0.1.0-beta.0

package/dist/manifest.js

@@ -0,0 +1,237 @@
+import { getTableName, isTable } from 'drizzle-orm';
+import * as v from 'valibot';
+import { workerstackMessageEvents, workerstackMessages, workerstackFiles, workerstackIdempotency, workerstackJobs, } from './internal-tables.js';
+import { parseCron } from './jobs/cron.js';
+import { isMessagingDescriptor } from './messaging/types.js';
+import { StandardSchemaValidationError, validateStandardSchema, } from './standard-schema.js';
+const MAX_ENV_DESCRIPTION = 200;
+const nonEmpty = v.pipe(v.string(), v.minLength(1));
+const migrationDirectory = v.pipe(nonEmpty, v.check((value) => value.startsWith('/') ||
+    (!value.includes('\\') &&
+        value.split('/').every((part) => part !== '..' && part !== '')), 'migrationsDirectory must be an absolute path or a relative path without traversal'));
+const cronSchedule = v.pipe(nonEmpty, v.check((value) => {
+    try {
+        parseCron(value);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}, 'invalid cron schedule'));
+const manifestSchema = v.strictObject({
+    version: v.literal(4),
+    database: v.strictObject({
+        dialect: v.picklist(['sqlite']),
+        migrationsDirectory: migrationDirectory,
+        tables: v.array(v.strictObject({
+            exportName: nonEmpty,
+            physicalName: nonEmpty,
+            system: v.boolean(),
+        })),
+    }),
+    storage: v.strictObject({
+        defaultBucket: nonEmpty,
+        buckets: v.array(v.strictObject({
+            name: nonEmpty,
+            visibility: v.picklist(['public', 'private']),
+        })),
+    }),
+    realtime: v.strictObject({ required: v.boolean() }),
+    messaging: v.strictObject({
+        channels: v.array(v.strictObject({ name: nonEmpty, kind: nonEmpty, provider: nonEmpty })),
+    }),
+    environment: v.array(v.strictObject({
+        key: nonEmpty,
+        required: v.boolean(),
+        scope: v.picklist(['server', 'client']),
+        sensitive: v.boolean(),
+        description: v.optional(v.pipe(nonEmpty, v.maxLength(MAX_ENV_DESCRIPTION))),
+    })),
+    api: v.strictObject({
+        operations: v.array(v.strictObject({
+            handle: nonEmpty,
+            operationId: nonEmpty,
+            effect: v.picklist(['read', 'mutation', 'unknown']),
+            method: v.optional(nonEmpty),
+            path: v.optional(nonEmpty),
+            summary: v.optional(v.pipe(nonEmpty, v.maxLength(200))),
+        })),
+    }),
+    background: v.strictObject({
+        jobs: v.array(v.strictObject({ name: nonEmpty })),
+        cron: v.array(v.strictObject({
+            name: nonEmpty,
+            schedule: cronSchedule,
+            timezone: v.literal('UTC'),
+        })),
+        maintenance: v.array(v.strictObject({
+            name: v.literal('storage-sweep'),
+            schedule: cronSchedule,
+            timezone: v.literal('UTC'),
+        })),
+    }),
+});
+function sortBy(entries, key) {
+    return [...entries].sort((left, right) => key(left).localeCompare(key(right)));
+}
+function rejectDuplicates(collection, values) {
+    const seen = new Set();
+    for (const value of values) {
+        if (seen.has(value))
+            throw new Error(`[workerstack] duplicate ${collection} "${value}"`);
+        seen.add(value);
+    }
+}
+function describeTables(schema) {
+    const systemNames = new Set(systemTables().map((table) => table.physicalName));
+    return sortBy(Object.entries(schema).flatMap(([exportName, value]) => isTable(value) && !systemNames.has(getTableName(value))
+        ? [{ exportName, physicalName: getTableName(value), system: false }]
+        : []), (entry) => entry.physicalName);
+}
+function envDescription(key, value) {
+    const description = value.trim().replace(/\s+/g, ' ');
+    if (!description)
+        throw new Error(`[workerstack] env.meta.${key}.description must not be empty`);
+    if (description.length > MAX_ENV_DESCRIPTION)
+        throw new Error(`[workerstack] env.meta.${key}.description must be at most ${MAX_ENV_DESCRIPTION} characters`);
+    return description;
+}
+function describeSection(section, scope, meta) {
+    return Object.entries(section ?? {}).map(([key, schema]) => {
+        let required = false;
+        try {
+            validateStandardSchema(schema, undefined, 'env');
+        }
+        catch (error) {
+            if (!(error instanceof StandardSchemaValidationError))
+                throw error;
+            required = true;
+        }
+        const entry = meta?.[key];
+        const sensitive = entry?.sensitive ?? scope === 'server';
+        if (scope === 'client' && sensitive) {
+            throw new Error(`[workerstack] env.meta.${key}.sensitive must be false: client values ship to the browser`);
+        }
+        return {
+            key,
+            required,
+            scope,
+            sensitive,
+            ...(entry?.description === undefined
+                ? {}
+                : { description: envDescription(key, entry.description) }),
+        };
+    });
+}
+function systemTables() {
+    return [
+        {
+            exportName: '_system.messageEvents',
+            physicalName: getTableName(workerstackMessageEvents),
+            system: true,
+        },
+        {
+            exportName: '_system.messages',
+            physicalName: getTableName(workerstackMessages),
+            system: true,
+        },
+        {
+            exportName: '_system.files',
+            physicalName: getTableName(workerstackFiles),
+            system: true,
+        },
+        {
+            exportName: '_system.idempotency',
+            physicalName: getTableName(workerstackIdempotency),
+            system: true,
+        },
+        {
+            exportName: '_system.jobs',
+            physicalName: getTableName(workerstackJobs),
+            system: true,
+        },
+    ];
+}
+export function parseManifest(value) {
+    const manifest = validateStandardSchema(manifestSchema, value, 'manifest');
+    rejectDuplicates('database physical table', manifest.database.tables.map((entry) => entry.physicalName));
+    rejectDuplicates('database export table', manifest.database.tables.map((entry) => entry.exportName));
+    rejectDuplicates('storage bucket', manifest.storage.buckets.map((entry) => entry.name));
+    rejectDuplicates('environment key', manifest.environment.map((entry) => entry.key));
+    rejectDuplicates('messaging channel', manifest.messaging.channels.map((entry) => entry.name));
+    rejectDuplicates('api operation', manifest.api.operations.map((entry) => entry.handle));
+    rejectDuplicates('background job', manifest.background.jobs.map((entry) => entry.name));
+    rejectDuplicates('background cron', manifest.background.cron.map((entry) => entry.name));
+    rejectDuplicates('background maintenance', manifest.background.maintenance.map((entry) => entry.name));
+    return manifest;
+}
+export function buildManifest(args) {
+    for (const [name, descriptor] of Object.entries(args.messaging ?? {})) {
+        if (!name.trim()) {
+            throw new Error('[workerstack] messaging channel names cannot be empty');
+        }
+        if (!isMessagingDescriptor(descriptor)) {
+            throw new Error(`[workerstack] messaging.${name} is not a provider descriptor`);
+        }
+    }
+    const declaredKeys = new Set([
+        ...Object.keys(args.envConfig?.server ?? {}),
+        ...Object.keys(args.envConfig?.client ?? {}),
+    ]);
+    for (const key of Object.keys(args.envConfig?.meta ?? {})) {
+        if (!declaredKeys.has(key))
+            throw new Error(`[workerstack] env.meta references undeclared key "${key}"`);
+    }
+    const environment = [
+        ...describeSection(args.envConfig?.server, 'server', args.envConfig?.meta),
+        ...describeSection(args.envConfig?.client, 'client', args.envConfig?.meta),
+    ];
+    rejectDuplicates('environment key', environment.map((entry) => entry.key));
+    return parseManifest({
+        version: 4,
+        database: {
+            dialect: args.dialect,
+            migrationsDirectory: args.migrationsDirectory,
+            tables: sortBy([...systemTables(), ...describeTables(args.schema)], (entry) => entry.physicalName),
+        },
+        storage: {
+            defaultBucket: args.storage.defaultBucket,
+            buckets: sortBy([...args.storage.buckets.values()].map((bucket) => ({
+                name: bucket.name,
+                visibility: bucket.visibility,
+            })), (bucket) => bucket.name),
+        },
+        realtime: { required: args.realtime },
+        messaging: {
+            channels: sortBy(Object.entries(args.messaging ?? {}).map(([name, descriptor]) => ({
+                name,
+                kind: descriptor.kind,
+                provider: descriptor.provider,
+            })), (entry) => entry.name),
+        },
+        environment: sortBy(environment, (entry) => entry.key),
+        api: {
+            operations: [...args.api].sort((left, right) => left.handle.localeCompare(right.handle)),
+        },
+        background: {
+            jobs: sortBy(Object.entries(args.jobs ?? {})
+                .filter(([, def]) => def.kind === 'job')
+                .map(([name]) => ({ name })), (entry) => entry.name),
+            cron: sortBy(Object.entries(args.jobs ?? {})
+                .filter(([, def]) => def.kind === 'cron')
+                .map(([name, def]) => ({
+                name,
+                schedule: def.kind === 'cron' ? def.schedule : '',
+                timezone: 'UTC',
+            })), (entry) => entry.name),
+            maintenance: [
+                {
+                    name: 'storage-sweep',
+                    schedule: '0 4 * * *',
+                    timezone: 'UTC',
+                },
+            ],
+        },
+    });
+}
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"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","sourcesContent":["import type { StandardSchemaV1 } from '@standard-schema/spec'\n\nimport { getTableName, isTable } from 'drizzle-orm'\nimport * as v from 'valibot'\n\nimport type { Dialect } from './dialect'\nimport type { EnvConfigInput, EnvVarMeta } from './env'\nimport type { JobsDefs } from './jobs/define'\nimport type { MessagingConfig } from './messaging'\nimport type { ResolvedBucket, ResolvedStorageBuckets } from './storage/buckets'\n\nimport {\n  workerstackMessageEvents,\n  workerstackMessages,\n  workerstackFiles,\n  workerstackIdempotency,\n  workerstackJobs,\n} from './internal-tables'\nimport { parseCron } from './jobs/cron'\nimport { isMessagingDescriptor } from './messaging/types'\nimport {\n  StandardSchemaValidationError,\n  validateStandardSchema,\n} from './standard-schema'\n\nexport type ManifestEnvVar = {\n  key: string\n  required: boolean\n  scope: 'server' | 'client'\n  sensitive: boolean\n  description?: string\n}\n\nexport type ApiOperationEffect = 'read' | 'mutation' | 'unknown'\n\n/**\n * One application-declared procedure. `effect` is derived from the declared\n * HTTP method; `unknown` means the application declared no route, and a host\n * must treat it as at least as dangerous as a mutation.\n */\nexport type ApiOperation = {\n  handle: string\n  operationId: string\n  effect: ApiOperationEffect\n  method?: string\n  path?: string\n  summary?: string\n}\n\nexport type WorkerstackManifest = {\n  version: 4\n  database: {\n    dialect: Dialect\n    migrationsDirectory: string\n    tables: { exportName: string; physicalName: string; system: boolean }[]\n  }\n  storage: {\n    defaultBucket: string\n    buckets: { name: string; visibility: ResolvedBucket['visibility'] }[]\n  }\n  realtime: { required: boolean }\n  messaging: {\n    channels: { name: string; kind: string; provider: string }[]\n  }\n  environment: ManifestEnvVar[]\n  api: { operations: ApiOperation[] }\n  background: {\n    jobs: { name: string }[]\n    cron: { name: string; schedule: string; timezone: 'UTC' }[]\n    maintenance: {\n      name: 'storage-sweep'\n      schedule: string\n      timezone: 'UTC'\n    }[]\n  }\n}\n\nconst MAX_ENV_DESCRIPTION = 200\n\nconst nonEmpty = v.pipe(v.string(), v.minLength(1))\nconst migrationDirectory = v.pipe(\n  nonEmpty,\n  v.check(\n    (value) =>\n      value.startsWith('/') ||\n      (!value.includes('\\\\') &&\n        value.split('/').every((part) => part !== '..' && part !== '')),\n    'migrationsDirectory must be an absolute path or a relative path without traversal',\n  ),\n)\nconst cronSchedule = v.pipe(\n  nonEmpty,\n  v.check((value) => {\n    try {\n      parseCron(value)\n      return true\n    } catch {\n      return false\n    }\n  }, 'invalid cron schedule'),\n)\n\nconst manifestSchema = v.strictObject({\n  version: v.literal(4),\n  database: v.strictObject({\n    dialect: v.picklist(['sqlite']),\n    migrationsDirectory: migrationDirectory,\n    tables: v.array(\n      v.strictObject({\n        exportName: nonEmpty,\n        physicalName: nonEmpty,\n        system: v.boolean(),\n      }),\n    ),\n  }),\n  storage: v.strictObject({\n    defaultBucket: nonEmpty,\n    buckets: v.array(\n      v.strictObject({\n        name: nonEmpty,\n        visibility: v.picklist(['public', 'private']),\n      }),\n    ),\n  }),\n  realtime: v.strictObject({ required: v.boolean() }),\n  messaging: v.strictObject({\n    channels: v.array(\n      v.strictObject({ name: nonEmpty, kind: nonEmpty, provider: nonEmpty }),\n    ),\n  }),\n  environment: v.array(\n    v.strictObject({\n      key: nonEmpty,\n      required: v.boolean(),\n      scope: v.picklist(['server', 'client']),\n      sensitive: v.boolean(),\n      description: v.optional(\n        v.pipe(nonEmpty, v.maxLength(MAX_ENV_DESCRIPTION)),\n      ),\n    }),\n  ),\n  api: v.strictObject({\n    operations: v.array(\n      v.strictObject({\n        handle: nonEmpty,\n        operationId: nonEmpty,\n        effect: v.picklist(['read', 'mutation', 'unknown']),\n        method: v.optional(nonEmpty),\n        path: v.optional(nonEmpty),\n        summary: v.optional(v.pipe(nonEmpty, v.maxLength(200))),\n      }),\n    ),\n  }),\n  background: v.strictObject({\n    jobs: v.array(v.strictObject({ name: nonEmpty })),\n    cron: v.array(\n      v.strictObject({\n        name: nonEmpty,\n        schedule: cronSchedule,\n        timezone: v.literal('UTC'),\n      }),\n    ),\n    maintenance: v.array(\n      v.strictObject({\n        name: v.literal('storage-sweep'),\n        schedule: cronSchedule,\n        timezone: v.literal('UTC'),\n      }),\n    ),\n  }),\n})\n\nfunction sortBy<T>(entries: readonly T[], key: (entry: T) => string): T[] {\n  return [...entries].sort((left, right) => key(left).localeCompare(key(right)))\n}\n\nfunction rejectDuplicates(collection: string, values: readonly string[]): void {\n  const seen = new Set<string>()\n  for (const value of values) {\n    if (seen.has(value))\n      throw new Error(`[workerstack] duplicate ${collection} \"${value}\"`)\n    seen.add(value)\n  }\n}\n\nfunction describeTables(schema: Record<string, unknown>) {\n  const systemNames = new Set<string>(\n    systemTables().map((table) => table.physicalName),\n  )\n  return sortBy(\n    Object.entries(schema).flatMap(([exportName, value]) =>\n      isTable(value) && !systemNames.has(getTableName(value))\n        ? [{ exportName, physicalName: getTableName(value), system: false }]\n        : [],\n    ),\n    (entry) => entry.physicalName,\n  )\n}\n\nfunction envDescription(key: string, value: string): string {\n  const description = value.trim().replace(/\\s+/g, ' ')\n  if (!description)\n    throw new Error(\n      `[workerstack] env.meta.${key}.description must not be empty`,\n    )\n  if (description.length > MAX_ENV_DESCRIPTION)\n    throw new Error(\n      `[workerstack] env.meta.${key}.description must be at most ${MAX_ENV_DESCRIPTION} characters`,\n    )\n  return description\n}\n\nfunction describeSection(\n  section: Record<string, StandardSchemaV1> | undefined,\n  scope: ManifestEnvVar['scope'],\n  meta: Record<string, EnvVarMeta> | undefined,\n): ManifestEnvVar[] {\n  return Object.entries(section ?? {}).map(([key, schema]) => {\n    let required = false\n    try {\n      validateStandardSchema(schema, undefined, 'env')\n    } catch (error) {\n      if (!(error instanceof StandardSchemaValidationError)) throw error\n      required = true\n    }\n    const entry = meta?.[key]\n    const sensitive = entry?.sensitive ?? scope === 'server'\n    if (scope === 'client' && sensitive) {\n      throw new Error(\n        `[workerstack] env.meta.${key}.sensitive must be false: client values ship to the browser`,\n      )\n    }\n    return {\n      key,\n      required,\n      scope,\n      sensitive,\n      ...(entry?.description === undefined\n        ? {}\n        : { description: envDescription(key, entry.description) }),\n    }\n  })\n}\n\nfunction systemTables() {\n  return [\n    {\n      exportName: '_system.messageEvents',\n      physicalName: getTableName(workerstackMessageEvents),\n      system: true,\n    },\n    {\n      exportName: '_system.messages',\n      physicalName: getTableName(workerstackMessages),\n      system: true,\n    },\n    {\n      exportName: '_system.files',\n      physicalName: getTableName(workerstackFiles),\n      system: true,\n    },\n    {\n      exportName: '_system.idempotency',\n      physicalName: getTableName(workerstackIdempotency),\n      system: true,\n    },\n    {\n      exportName: '_system.jobs',\n      physicalName: getTableName(workerstackJobs),\n      system: true,\n    },\n  ]\n}\n\nexport function parseManifest(value: unknown): WorkerstackManifest {\n  const manifest = validateStandardSchema(\n    manifestSchema,\n    value,\n    'manifest',\n  ) as WorkerstackManifest\n  rejectDuplicates(\n    'database physical table',\n    manifest.database.tables.map((entry) => entry.physicalName),\n  )\n  rejectDuplicates(\n    'database export table',\n    manifest.database.tables.map((entry) => entry.exportName),\n  )\n  rejectDuplicates(\n    'storage bucket',\n    manifest.storage.buckets.map((entry) => entry.name),\n  )\n  rejectDuplicates(\n    'environment key',\n    manifest.environment.map((entry) => entry.key),\n  )\n  rejectDuplicates(\n    'messaging channel',\n    manifest.messaging.channels.map((entry) => entry.name),\n  )\n  rejectDuplicates(\n    'api operation',\n    manifest.api.operations.map((entry) => entry.handle),\n  )\n  rejectDuplicates(\n    'background job',\n    manifest.background.jobs.map((entry) => entry.name),\n  )\n  rejectDuplicates(\n    'background cron',\n    manifest.background.cron.map((entry) => entry.name),\n  )\n  rejectDuplicates(\n    'background maintenance',\n    manifest.background.maintenance.map((entry) => entry.name),\n  )\n  return manifest\n}\n\nexport function buildManifest(args: {\n  schema: Record<string, unknown>\n  dialect: Dialect\n  migrationsDirectory: string\n  storage: ResolvedStorageBuckets\n  envConfig: EnvConfigInput | undefined\n  messaging: MessagingConfig | undefined\n  realtime: boolean\n  jobs: JobsDefs | undefined\n  api: ApiOperation[]\n}): WorkerstackManifest {\n  for (const [name, descriptor] of Object.entries(args.messaging ?? {})) {\n    if (!name.trim()) {\n      throw new Error('[workerstack] messaging channel names cannot be empty')\n    }\n    if (!isMessagingDescriptor(descriptor)) {\n      throw new Error(\n        `[workerstack] messaging.${name} is not a provider descriptor`,\n      )\n    }\n  }\n  const declaredKeys = new Set([\n    ...Object.keys(args.envConfig?.server ?? {}),\n    ...Object.keys(args.envConfig?.client ?? {}),\n  ])\n  for (const key of Object.keys(args.envConfig?.meta ?? {})) {\n    if (!declaredKeys.has(key))\n      throw new Error(\n        `[workerstack] env.meta references undeclared key \"${key}\"`,\n      )\n  }\n  const environment = [\n    ...describeSection(args.envConfig?.server, 'server', args.envConfig?.meta),\n    ...describeSection(args.envConfig?.client, 'client', args.envConfig?.meta),\n  ]\n  rejectDuplicates(\n    'environment key',\n    environment.map((entry) => entry.key),\n  )\n\n  return parseManifest({\n    version: 4,\n    database: {\n      dialect: args.dialect,\n      migrationsDirectory: args.migrationsDirectory,\n      tables: sortBy(\n        [...systemTables(), ...describeTables(args.schema)],\n        (entry) => entry.physicalName,\n      ),\n    },\n    storage: {\n      defaultBucket: args.storage.defaultBucket,\n      buckets: sortBy(\n        [...args.storage.buckets.values()].map((bucket) => ({\n          name: bucket.name,\n          visibility: bucket.visibility,\n        })),\n        (bucket) => bucket.name,\n      ),\n    },\n    realtime: { required: args.realtime },\n    messaging: {\n      channels: sortBy(\n        Object.entries(args.messaging ?? {}).map(([name, descriptor]) => ({\n          name,\n          kind: descriptor.kind,\n          provider: descriptor.provider,\n        })),\n        (entry) => entry.name,\n      ),\n    },\n    environment: sortBy(environment, (entry) => entry.key),\n    api: {\n      operations: [...args.api].sort((left, right) =>\n        left.handle.localeCompare(right.handle),\n      ),\n    },\n    background: {\n      jobs: sortBy(\n        Object.entries(args.jobs ?? {})\n          .filter(([, def]) => def.kind === 'job')\n          .map(([name]) => ({ name })),\n        (entry) => entry.name,\n      ),\n      cron: sortBy(\n        Object.entries(args.jobs ?? {})\n          .filter(([, def]) => def.kind === 'cron')\n          .map(([name, def]) => ({\n            name,\n            schedule: def.kind === 'cron' ? def.schedule : '',\n            timezone: 'UTC' as const,\n          })),\n        (entry) => entry.name,\n      ),\n      maintenance: [\n        {\n          name: 'storage-sweep',\n          schedule: '0 4 * * *',\n          timezone: 'UTC' as const,\n        },\n      ],\n    },\n  })\n}\n"]}

package/dist/messaging/email.d.ts

@@ -0,0 +1,16 @@
+import type { EmailAdapter, EmailMessage, SentEmail } from '../email.js';
+import { type MessagingDescriptor } from './types.js';
+export type ResendConfig = {
+    apiKey?: string;
+    from?: string;
+};
+export type ResendDescriptor = MessagingDescriptor<'email', 'resend', EmailMessage, SentEmail, ResendConfig>;
+export declare function resend(config?: ResendConfig): ResendDescriptor;
+export type CustomEmailConfig = {
+    adapter?: EmailAdapter | EmailAdapter['send'];
+    from?: string;
+    provider?: string;
+};
+export type CustomEmailDescriptor = MessagingDescriptor<'email', 'custom', EmailMessage, SentEmail, CustomEmailConfig>;
+export declare function customEmail(config?: CustomEmailConfig): CustomEmailDescriptor;
+//# sourceMappingURL=email.d.ts.map

package/dist/messaging/email.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.d.ts","sourceRoot":"","sources":["../../src/messaging/email.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAErE,OAAO,EAAc,KAAK,mBAAmB,EAAE,MAAM,SAAS,CAAA;AAE9D,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG,mBAAmB,CAChD,OAAO,EACP,QAAQ,EACR,YAAY,EACZ,SAAS,EACT,YAAY,CACb,CAAA;AAED,wBAAgB,MAAM,CAAC,MAAM,GAAE,YAAiB,GAAG,gBAAgB,CAElE;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,CAAC,EAAE,YAAY,GAAG,YAAY,CAAC,MAAM,CAAC,CAAA;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,qBAAqB,GAAG,mBAAmB,CACrD,OAAO,EACP,QAAQ,EACR,YAAY,EACZ,SAAS,EACT,iBAAiB,CAClB,CAAA;AAED,wBAAgB,WAAW,CACzB,MAAM,GAAE,iBAAsB,GAC7B,qBAAqB,CAEvB"}

package/dist/messaging/email.js

@@ -0,0 +1,8 @@
+import { descriptor } from './types.js';
+export function resend(config = {}) {
+    return descriptor('email', 'resend', config);
+}
+export function customEmail(config = {}) {
+    return descriptor('email', 'custom', config);
+}
+//# sourceMappingURL=email.js.map

package/dist/messaging/email.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.js","sourceRoot":"","sources":["../../src/messaging/email.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAA4B,MAAM,SAAS,CAAA;AAe9D,MAAM,UAAU,MAAM,CAAC,SAAuB,EAAE;IAC9C,OAAO,UAAU,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAA;AAC9C,CAAC;AAgBD,MAAM,UAAU,WAAW,CACzB,SAA4B,EAAE;IAE9B,OAAO,UAAU,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAA;AAC9C,CAAC","sourcesContent":["import type { EmailAdapter, EmailMessage, SentEmail } from '../email'\n\nimport { descriptor, type MessagingDescriptor } from './types'\n\nexport type ResendConfig = {\n  apiKey?: string\n  from?: string\n}\n\nexport type ResendDescriptor = MessagingDescriptor<\n  'email',\n  'resend',\n  EmailMessage,\n  SentEmail,\n  ResendConfig\n>\n\nexport function resend(config: ResendConfig = {}): ResendDescriptor {\n  return descriptor('email', 'resend', config)\n}\n\nexport type CustomEmailConfig = {\n  adapter?: EmailAdapter | EmailAdapter['send']\n  from?: string\n  provider?: string\n}\n\nexport type CustomEmailDescriptor = MessagingDescriptor<\n  'email',\n  'custom',\n  EmailMessage,\n  SentEmail,\n  CustomEmailConfig\n>\n\nexport function customEmail(\n  config: CustomEmailConfig = {},\n): CustomEmailDescriptor {\n  return descriptor('email', 'custom', config)\n}\n"]}

package/dist/messaging/index.d.ts

@@ -0,0 +1,8 @@
+export { resend, customEmail } from './email.js';
+export { createMessaging } from './standalone.js';
+export type { MessagingContext } from './standalone.js';
+export type { CustomEmailConfig, CustomEmailDescriptor, ResendConfig, ResendDescriptor, } from './email.js';
+export { telegram } from './telegram.js';
+export type { SentTelegramMessage, TelegramConfig, TelegramDescriptor, TelegramMessage, } from './telegram.js';
+export type { AnyMessagingDescriptor, MessagingConfig, MessagingDescriptor, MessagingFacade, MessagingFacades, MessagingFacadesFor, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/messaging/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/messaging/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAC9C,YAAY,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AACpD,YAAY,EACV,iBAAiB,EACjB,qBAAqB,EACrB,YAAY,EACZ,gBAAgB,GACjB,MAAM,SAAS,CAAA;AAChB,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AACrC,YAAY,EACV,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,eAAe,GAChB,MAAM,YAAY,CAAA;AACnB,YAAY,EACV,sBAAsB,EACtB,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,SAAS,CAAA"}

package/dist/messaging/index.js

@@ -0,0 +1,4 @@
+export { resend, customEmail } from './email.js';
+export { createMessaging } from './standalone.js';
+export { telegram } from './telegram.js';
+//# sourceMappingURL=index.js.map

package/dist/messaging/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/messaging/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAQ9C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA","sourcesContent":["export { resend, customEmail } from './email'\nexport { createMessaging } from './standalone'\nexport type { MessagingContext } from './standalone'\nexport type {\n  CustomEmailConfig,\n  CustomEmailDescriptor,\n  ResendConfig,\n  ResendDescriptor,\n} from './email'\nexport { telegram } from './telegram'\nexport type {\n  SentTelegramMessage,\n  TelegramConfig,\n  TelegramDescriptor,\n  TelegramMessage,\n} from './telegram'\nexport type {\n  AnyMessagingDescriptor,\n  MessagingConfig,\n  MessagingDescriptor,\n  MessagingFacade,\n  MessagingFacades,\n  MessagingFacadesFor,\n} from './types'\n"]}

package/dist/messaging/journal.d.ts

@@ -0,0 +1,4 @@
+import type { AnyDb } from '../dialect.js';
+export declare function insertMessage(db: AnyDb | undefined, value: Record<string, unknown>): Promise<void>;
+export declare function updateMessage(db: AnyDb | undefined, id: string, value: Record<string, unknown>, expectedStatus?: string): Promise<void>;
+//# sourceMappingURL=journal.d.ts.map

package/dist/messaging/journal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"journal.d.ts","sourceRoot":"","sources":["../../src/messaging/journal.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAIvC,wBAAsB,aAAa,CACjC,EAAE,EAAE,KAAK,GAAG,SAAS,EACrB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,iBAI/B;AAED,wBAAsB,aAAa,CACjC,EAAE,EAAE,KAAK,GAAG,SAAS,EACrB,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,cAAc,CAAC,EAAE,MAAM,iBAYxB"}

package/dist/messaging/journal.js

@@ -0,0 +1,19 @@
+import { and, eq } from 'drizzle-orm';
+import { workerstackMessages } from '../internal-tables.js';
+export async function insertMessage(db, value) {
+    if (!db)
+        return;
+    await db.insert(workerstackMessages).values(value);
+}
+export async function updateMessage(db, id, value, expectedStatus) {
+    if (!db)
+        return;
+    const table = workerstackMessages;
+    await db
+        .update(table)
+        .set(value)
+        .where(expectedStatus
+        ? and(eq(table.id, id), eq(table.status, expectedStatus))
+        : eq(table.id, id));
+}
+//# sourceMappingURL=journal.js.map

package/dist/messaging/journal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"journal.js","sourceRoot":"","sources":["../../src/messaging/journal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,aAAa,CAAA;AAIrC,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAExD,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,EAAqB,EACrB,KAA8B;IAE9B,IAAI,CAAC,EAAE;QAAE,OAAM;IACf,MAAM,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AACpD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,EAAqB,EACrB,EAAU,EACV,KAA8B,EAC9B,cAAuB;IAEvB,IAAI,CAAC,EAAE;QAAE,OAAM;IACf,MAAM,KAAK,GAAG,mBAAmB,CAAA;IACjC,MAAM,EAAE;SACL,MAAM,CAAC,KAAK,CAAC;SACb,GAAG,CAAC,KAAK,CAAC;SACV,KAAK,CACJ,cAAc;QACZ,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;QACzD,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CACrB,CAAA;AACL,CAAC","sourcesContent":["import { and, eq } from 'drizzle-orm'\n\nimport type { AnyDb } from '../dialect'\n\nimport { workerstackMessages } from '../internal-tables'\n\nexport async function insertMessage(\n  db: AnyDb | undefined,\n  value: Record<string, unknown>,\n) {\n  if (!db) return\n  await db.insert(workerstackMessages).values(value)\n}\n\nexport async function updateMessage(\n  db: AnyDb | undefined,\n  id: string,\n  value: Record<string, unknown>,\n  expectedStatus?: string,\n) {\n  if (!db) return\n  const table = workerstackMessages\n  await db\n    .update(table)\n    .set(value)\n    .where(\n      expectedStatus\n        ? and(eq(table.id, id), eq(table.status, expectedStatus))\n        : eq(table.id, id),\n    )\n}\n"]}

package/dist/messaging/runtime.d.ts

@@ -0,0 +1,16 @@
+import type { AnyDb } from '../dialect.js';
+import type { BaseEnv } from '../env.js';
+import type { MessagingConfig, MessagingFacades } from './types.js';
+export type MessagingAdapter = {
+    send(input: any): Promise<{
+        id?: string;
+    }>;
+};
+export type CreateMessagingOptions = {
+    env: BaseEnv;
+    db?: AnyDb;
+    fetchFn?: typeof fetch;
+    adapterOverrides?: Record<string, MessagingAdapter>;
+};
+export declare function createMessaging<const TConfig extends MessagingConfig>(config: TConfig, options: CreateMessagingOptions): MessagingFacades<TConfig>;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/messaging/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/messaging/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAEvC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAA;AAErC,OAAO,KAAK,EAEV,eAAe,EACf,gBAAgB,EACjB,MAAM,SAAS,CAAA;AAKhB,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC;QAAE,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAC3C,CAAA;AAED,MAAM,MAAM,sBAAsB,GAAG;IACnC,GAAG,EAAE,OAAO,CAAA;IACZ,EAAE,CAAC,EAAE,KAAK,CAAA;IACV,OAAO,CAAC,EAAE,OAAO,KAAK,CAAA;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAA;CACpD,CAAA;AA+ID,wBAAgB,eAAe,CAAC,KAAK,CAAC,OAAO,SAAS,eAAe,EACnE,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,sBAAsB,GAC9B,gBAAgB,CAAC,OAAO,CAAC,CA6H3B"}

package/dist/messaging/runtime.js

@@ -0,0 +1,213 @@
+import { insertMessage, updateMessage } from './journal.js';
+import { isMessagingDescriptor } from './types.js';
+const nonEmpty = (value) => typeof value === 'string' && value.trim().length > 0;
+const array = (value) => value === undefined ? [] : Array.isArray(value) ? value : [value];
+function managedConfig(raw) {
+    if (!nonEmpty(raw))
+        return {};
+    let value;
+    try {
+        value = JSON.parse(raw);
+    }
+    catch {
+        throw new Error('[workerstack] WORKERSTACK_MESSAGING_CONFIG must be valid JSON');
+    }
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error('[workerstack] WORKERSTACK_MESSAGING_CONFIG must be an object');
+    }
+    return value;
+}
+function consoleCapture(channel, kind, input) {
+    console.log(`\n${'─'.repeat(60)}\n` +
+        `💬 ${channel} (${kind}, captured — not sent)\n` +
+        `${'─'.repeat(60)}\n` +
+        `${JSON.stringify(input, null, 2)}\n` +
+        `${'─'.repeat(60)}`);
+}
+function emailContent(input, from) {
+    return {
+        recipients: {
+            to: array(input.to),
+            cc: array(input.cc),
+            bcc: array(input.bcc),
+        },
+        content: {
+            subject: input.subject,
+            html: input.html,
+            text: input.text,
+            from,
+            replyTo: input.replyTo,
+        },
+    };
+}
+function telegramContent(input) {
+    return {
+        recipients: { to: [String(input.to)] },
+        content: { text: input.text, parseMode: input.parseMode },
+    };
+}
+function createResendAdapter(apiKey, fetchFn) {
+    return {
+        async send(input) {
+            const response = await fetchFn('https://api.resend.com/emails', {
+                method: 'POST',
+                headers: {
+                    Authorization: `Bearer ${apiKey}`,
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify({
+                    from: input.from,
+                    to: array(input.to),
+                    subject: input.subject,
+                    html: input.html,
+                    text: input.text,
+                    reply_to: input.replyTo,
+                    cc: array(input.cc),
+                    bcc: array(input.bcc),
+                    tags: input.tags,
+                }),
+            });
+            if (!response.ok) {
+                throw new Error(`resend API error (${response.status}): ${await response.text()}`);
+            }
+            return (await response.json());
+        },
+    };
+}
+function createTelegramAdapter(token, fetchFn) {
+    return {
+        async send(input) {
+            const response = await fetchFn(`https://api.telegram.org/bot${token}/sendMessage`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    chat_id: input.to,
+                    text: input.text,
+                    parse_mode: input.parseMode,
+                }),
+            });
+            if (!response.ok) {
+                throw new Error(`telegram API error (${response.status}): ${await response.text()}`);
+            }
+            const body = (await response.json());
+            return { id: body.result?.message_id?.toString() };
+        },
+    };
+}
+function providerConfig(descriptor, managed) {
+    const merged = { ...managed[descriptor.provider] };
+    for (const [key, value] of Object.entries(descriptor.config)) {
+        if (typeof value === 'string' ? nonEmpty(value) : value !== undefined) {
+            merged[key] = value;
+        }
+    }
+    return merged;
+}
+export function createMessaging(config, options) {
+    const managed = managedConfig(options.env.WORKERSTACK_MESSAGING_CONFIG);
+    const entries = Object.entries(config).map(([channel, descriptor]) => {
+        if (!channel.trim())
+            throw new Error('[workerstack] messaging channel names cannot be empty');
+        if (!isMessagingDescriptor(descriptor)) {
+            throw new Error(`[workerstack] messaging.${channel} is not a provider descriptor`);
+        }
+        const merged = providerConfig(descriptor, managed);
+        const override = options.adapterOverrides?.[channel];
+        let adapter = override;
+        let source = override ? 'capture' : 'explicit';
+        let from;
+        if (!adapter &&
+            descriptor.kind === 'email' &&
+            descriptor.provider === 'resend') {
+            const own = descriptor.config;
+            const apiKey = merged.apiKey;
+            from = nonEmpty(merged.from) ? merged.from : undefined;
+            if (nonEmpty(apiKey) && from) {
+                source = nonEmpty(own.apiKey) ? 'explicit' : 'managed';
+                adapter = createResendAdapter(apiKey, options.fetchFn ?? fetch);
+            }
+        }
+        else if (!adapter && descriptor.kind === 'email') {
+            const own = descriptor.config;
+            from = nonEmpty(merged.from) ? merged.from : undefined;
+            if (own.adapter && from) {
+                adapter =
+                    typeof own.adapter === 'function'
+                        ? { send: own.adapter }
+                        : own.adapter;
+            }
+        }
+        else if (!adapter && descriptor.kind === 'telegram') {
+            const own = descriptor.config;
+            const token = merged.botToken;
+            if (nonEmpty(token)) {
+                source = nonEmpty(own.botToken) ? 'explicit' : 'managed';
+                adapter = createTelegramAdapter(token, options.fetchFn ?? fetch);
+            }
+        }
+        const capture = !adapter || Boolean(override);
+        if (capture)
+            source = 'capture';
+        return [
+            channel,
+            {
+                async send(input) {
+                    if (descriptor.kind === 'email' &&
+                        !input.html &&
+                        !input.text) {
+                        throw new Error('email message needs html or text content');
+                    }
+                    const resolvedFrom = descriptor.kind === 'email'
+                        ? (input.from ?? from ?? 'unknown@localhost')
+                        : undefined;
+                    const normalized = descriptor.kind === 'email'
+                        ? emailContent(input, resolvedFrom)
+                        : telegramContent(input);
+                    const id = `message_${crypto.randomUUID()}`;
+                    const now = Date.now();
+                    await insertMessage(options.db, {
+                        id,
+                        channel,
+                        kind: descriptor.kind,
+                        provider: descriptor.provider,
+                        credentialSource: source,
+                        status: capture ? 'captured' : 'sending',
+                        recipientsJson: JSON.stringify(normalized.recipients),
+                        contentJson: JSON.stringify(normalized.content),
+                        createdAt: now,
+                        updatedAt: now,
+                    });
+                    if (capture) {
+                        await adapter?.send(input);
+                        if (!override && !options.env.BUNDERHOST_ENVIRONMENT_ID) {
+                            consoleCapture(channel, descriptor.kind, input);
+                        }
+                        return { id };
+                    }
+                    try {
+                        const outgoing = descriptor.kind === 'email'
+                            ? { ...input, from: resolvedFrom }
+                            : input;
+                        const sent = await adapter.send(outgoing);
+                        await updateMessage(options.db, id, {
+                            providerId: sent.id || undefined,
+                            status: 'sent',
+                            updatedAt: Date.now(),
+                        }, 'sending');
+                        return { id, providerId: sent.id || undefined };
+                    }
+                    catch (error) {
+                        await updateMessage(options.db, id, {
+                            status: 'failed',
+                            error: error instanceof Error ? error.message : String(error),
+                            updatedAt: Date.now(),
+                        }, 'sending');
+                        throw error;
+                    }
+                },
+            },
+        ];
+    });
+    return Object.fromEntries(entries);
+}
+//# sourceMappingURL=runtime.js.map