appos 0.2.1 → 0.2.2-0

package/dist/exports/api/workflows/config.d.mts

@@ -0,0 +1,18 @@
+import { z } from "zod";
+
+//#region src/api/config.d.ts
+
+/**
+ * The config base schema.
+ */
+declare const baseSchema: z.ZodObject<{
+  APP_NAME: z.ZodDefault<z.ZodString>;
+  APP_DESC: z.ZodDefault<z.ZodString>;
+  APP_VERSION: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * The configuration type inferred from the merged schema.
+ */
+type Config<T extends z.ZodRawShape = {}> = z.infer<ReturnType<typeof baseSchema.extend<T>>>;
+//#endregion
+export { Config };

package/dist/exports/api/workflows/container.d.mts

@@ -0,0 +1,167 @@
+import { Logger } from "./logger.mjs";
+import { Database } from "./database.mjs";
+import { Auth } from "./auth.mjs";
+import { Cache } from "./cache.mjs";
+import { Config } from "./config.mjs";
+import { EventBus } from "./event.mjs";
+import { Mailer } from "./mailer.mjs";
+import { Storage } from "./storage.mjs";
+import { CorsOptions } from "cors";
+import { Options } from "express-rate-limit";
+import { HelmetOptions } from "helmet";
+import { i18n } from "i18next";
+
+//#region src/api/container.d.ts
+
+/**
+ * Server configuration for the HTTP server.
+ */
+interface ServerConfig {
+  /**
+   * The host address the server will bind to.
+   *
+   * @default "0.0.0.0"
+   */
+  host?: string;
+  /**
+   * The port number the server will listen on.
+   */
+  port: number;
+  /**
+   * Request timeout in milliseconds. Requests exceeding this duration
+   * will receive a 408 Request Timeout response.
+   *
+   * @default 30000
+   */
+  timeout?: number;
+  /**
+   * Maximum request body size for JSON and URL-encoded payloads.
+   * Supports bytes.js format strings (e.g., "1mb", "500kb", "10mb").
+   *
+   * @default "1mb"
+   */
+  bodyLimit?: string;
+  /**
+   * The path for the health check endpoint.
+   *
+   * @default "/health"
+   */
+  healthPath?: string;
+  /**
+   * CORS configuration. Omit or set to undefined to disable.
+   *
+   * @example
+   * cors: { origin: "https://example.com", credentials: true }
+   */
+  cors?: CorsOptions;
+  /**
+   * Security headers configuration (via helmet). Omit or set to undefined to disable.
+   * Recommended for production deployments.
+   *
+   * @example
+   * helmet: { contentSecurityPolicy: false }  // Enable with CSP disabled
+   * helmet: {}  // Enable with all defaults
+   */
+  helmet?: HelmetOptions;
+  /**
+   * Rate limiting configuration. Array of express-rate-limit options.
+   * Each config is applied as a separate middleware - use `skip` function for path-specific limits.
+   * Redis store is automatically configured if `redisUrl` is provided.
+   *
+   * @example
+   * // Global rate limit
+   * rateLimit: [{ windowMs: 60000, limit: 100 }]
+   *
+   * @example
+   * // Path-specific rate limits
+   * rateLimit: [
+   *   { windowMs: 900000, limit: 5, skip: (req) => !req.path.startsWith("/api/auth") },
+   *   { windowMs: 60000, limit: 100 },  // Default for all other routes
+   * ]
+   */
+  rateLimit?: Options[];
+  /**
+   * Redis URL for rate limiting store (for multi-instance deployments).
+   * Server auto-connects and cleans up on shutdown.
+   * If omitted, uses in-memory store (not suitable for production clusters).
+   *
+   * @example
+   * redisUrl: "redis://localhost:6379"
+   */
+  redisUrl?: string;
+}
+/**
+ * Worker configuration for the DBOS workflow worker.
+ */
+interface WorkerConfig {
+  /**
+   * The system database URL for DBOS.
+   */
+  dbUrl: string;
+}
+/**
+ * The base application container type that holds required services like
+ * config, databases, and caches.
+ */
+interface AppContainer<TDb extends Record<"primary", Database> & Record<string, Database> = Record<"primary", Database> & Record<string, Database>> {
+  /**
+   * The application auth configuration.
+   */
+  auth: Auth<TDb>;
+  /**
+   * A map of caches available in the application.
+   */
+  cache: Record<string, Cache>;
+  /**
+   * The application configuration.
+   */
+  config: Config;
+  /**
+   * A map of databases available in the application.
+   */
+  db: TDb;
+  /**
+   * The i18n instance for internationalization.
+   */
+  i18n: i18n;
+  /**
+   * The logger instance for logging messages.
+   */
+  logger: Logger;
+  /**
+   * The event bus for in-memory and Redis pub/sub messaging.
+   */
+  eventBus: EventBus;
+  /**
+   * The mailer instance for sending emails.
+   */
+  mailer: Mailer;
+  /**
+   * Server configuration for the HTTP server.
+   */
+  server: ServerConfig;
+  /**
+   * A map of storage services available in the application.
+   */
+  storage: Record<"primary", Storage> & Record<string, Storage>;
+  /**
+   * Worker configuration for the DBOS workflow worker.
+   */
+  worker: WorkerConfig;
+}
+/**
+ * Global namespace for user container augmentation.
+ * Users can extend Container interface in their container.ts file.
+ */
+declare global {
+  namespace AppOS {
+    interface Container {}
+  }
+}
+/**
+ * The container type used throughout the application.
+ * Merges base AppContainer with user's custom Container augmentations.
+ */
+type Container = AppContainer & AppOS.Container;
+//#endregion
+export { Container };

package/dist/exports/api/workflows/database.d.mts

@@ -0,0 +1,46 @@
+import { Logger } from "./logger.mjs";
+import { AnyRelations, EmptyRelations } from "drizzle-orm";
+import "drizzle-orm/pg-core";
+import * as drizzle_orm_node_postgres0 from "drizzle-orm/node-postgres";
+import { Pool, PoolConfig } from "pg";
+
+//#region src/api/database.d.ts
+
+/**
+ * Extract qualified table names from db object.
+ */
+type QualifiedTableNames<TDb> = { [K in keyof TDb]: TDb[K] extends {
+  _: {
+    fullSchema: infer S;
+  };
+} ? `${K & string}.${keyof S & string}` : never }[keyof TDb];
+/**
+ * Options for defining the database.
+ */
+interface DefineDatabaseOptions<TSchema extends Record<string, unknown> = Record<string, never>, TRelations extends AnyRelations = EmptyRelations> {
+  logger: Logger;
+  poolConfig: PoolConfig;
+  relations?: TRelations;
+  schema?: TSchema;
+}
+/**
+ * The database type.
+ */
+type Database = Awaited<ReturnType<typeof defineDatabase>>;
+/**
+ * Define the database with the provided options.
+ *
+ * Algorithm:
+ * 1. Create a connection pool with sensible defaults
+ * 2. Initialize drizzle ORM with schema and relations
+ *
+ * @param opts The options for defining the database, including pool configuration, relations, and schema.
+ * @template TSchema The schema type for the database.
+ * @template TRelations The relations type for the database.
+ * @returns The defined database instance.
+ */
+declare function defineDatabase<TSchema extends Record<string, unknown> = Record<string, never>, TRelations extends AnyRelations = EmptyRelations>(opts: DefineDatabaseOptions<TSchema, TRelations>): Promise<drizzle_orm_node_postgres0.NodePgDatabase<TSchema, TRelations> & {
+  $client: Pool;
+}>;
+//#endregion
+export { Database, QualifiedTableNames };

package/dist/exports/api/workflows/event.d.mts

@@ -0,0 +1,68 @@
+import { Logger } from "./logger.mjs";
+import "./container.mjs";
+import { z } from "zod";
+
+//#region src/api/event.d.ts
+
+/**
+ * Options for defining an event bus.
+ */
+interface DefineEventBusOptions {
+  /**
+   * Redis URL for pub/sub.
+   */
+  dbUrl: string;
+  /**
+   * Logger instance for error reporting.
+   */
+  logger: Logger;
+}
+/**
+ * The event bus type for container.
+ */
+type EventBus = ReturnType<typeof defineEventBus>;
+/**
+ * Defines the event bus for pub/sub messaging.
+ * Uses Redis for cross-server communication.
+ *
+ * Algorithm:
+ * 1. Create lazy Redis publisher client
+ * 2. Create lazy Redis subscriber client
+ * 3. Manage subscriptions via callback registry
+ * 4. Provide publish/subscribe/close methods
+ *
+ * @param opts - Event bus configuration
+ * @returns Event bus instance
+ */
+declare function defineEventBus(opts: DefineEventBusOptions): {
+  /**
+   * Publish a message to a channel.
+   * Auto-connects on first call if not already connected.
+   *
+   * @param channel - Channel name
+   * @param message - Message payload (will be JSON stringified)
+   */
+  publish(channel: string, message: unknown): Promise<void>;
+  /**
+   * Subscribe to a channel. Returns unsubscribe function.
+   * Uses single connection with callback management.
+   *
+   * @param channel - Channel name
+   * @param callback - Callback for received messages
+   * @returns Unsubscribe function
+   */
+  subscribe(channel: string, callback: (message: unknown) => void): Promise<() => void>;
+  /**
+   * Check if a channel has any subscribers.
+   *
+   * @param channel - Channel name
+   * @returns true if channel has subscribers
+   */
+  hasSubscribers(channel: string): boolean;
+  /**
+   * Close the Redis connections.
+   */
+  close(): Promise<void>;
+};
+//#endregion
+export { EventBus };

package/dist/exports/api/workflows/event.mjs

@@ -0,0 +1 @@
+import"./redis.mjs";import{z as e}from"zod";import{join as t}from"node:path";import"es-toolkit";function n(e){let t=null,n=null;return{inputSchema:e.input,get name(){return n},register(e,r){t=e,n=r},async emit(r){if(!t||!n)throw Error(`Event not registered. Ensure the worker is started before emitting events.`);let i=e.input.parse(r),a={container:t,input:i};await e.run(a),t.eventBus.publish(n,i).catch(e=>{t.logger.error({err:e,event:n},`Redis publish failed`)})},async subscribe(r){if(!t||!n)throw Error(`Event not registered. Ensure the worker is started before subscribing.`);return t.eventBus.subscribe(n,async i=>{let a=e.input.parse(i),o={container:t,input:a};try{await r(o)}catch(e){t.logger.error({err:e,event:n},`Event subscription handler error`)}})}}}const r=n({input:e.object({action:e.enum([`INSERT`,`UPDATE`,`DELETE`]),newData:e.record(e.string(),e.unknown()).nullable(),oldData:e.record(e.string(),e.unknown()).nullable(),organizationId:e.string().nullable(),tableName:e.string(),timestamp:e.string(),userId:e.string().nullable()}),async run(){}});export{r as dbChangesEvent};

package/dist/exports/api/workflows/extract-blob-metadata.mjs

@@ -0,0 +1 @@
+import{defineWorkflow as e}from"../workflow.mjs";import t from"zod";import{join as n}from"node:path";import{ALL_FORMATS as r,BlobSource as i,Input as a}from"mediabunny";import o from"sharp";const s=e({input:t.object({blobId:t.string()}),async run({container:e,input:{blobId:t},step:s}){let c=await s(`fetch-blob`,async()=>e.storage.primary.getBlob(t));if(!c)throw Error(`Blob ${t} not found`);let l=await s(`download-blob`,async()=>e.storage.primary.downloadBlob(t));if(!l)throw Error(`Failed to download blob ${t}`);let u={};return c.contentType?.startsWith(`image/`)?u=await s(`extract-image-metadata`,async()=>{let e=await o(l).metadata();return{width:e.width,height:e.height,format:e.format,hasAlpha:e.hasAlpha,space:e.space}}):c.contentType?.startsWith(`video/`)||c.contentType?.startsWith(`audio/`)?u=await s(`extract-media-metadata`,async()=>{let e=new Uint8Array(l),t=new a({source:new i(new Blob([e],{type:c.contentType||`video/mp4`})),formats:r}),n=await t.computeDuration(),o=await t.getMetadataTags(),s={},u={},d=!1,f=!1;try{let e=await t.getPrimaryVideoTrack();if(e){d=!0;let t=e.displayWidth&&e.displayHeight?e.displayWidth/e.displayHeight:null;s={width:e.displayWidth,height:e.displayHeight,rotation:e.rotation,angle:e.rotation,displayAspectRatio:t}}}catch{}try{let e=await t.getPrimaryAudioTrack();e&&(f=!0,u={sampleRate:e.sampleRate,channels:e.numberOfChannels})}catch{}return{duration:n,video:d,audio:f,...s,...u,tags:o}}):c.contentType===`application/pdf`&&(u=await s(`extract-pdf-metadata`,async()=>{try{let e=await import(`pdfjs-dist/legacy/build/pdf.mjs`),t=`${n(process.cwd(),`node_modules/pdfjs-dist/standard_fonts`)}/`,r=await e.getDocument({data:new Uint8Array(l),standardFontDataUrl:t}).promise,i=await r.getMetadata(),a=(await r.getPage(1)).getViewport({scale:1}),o=i.info;return{pageCount:r.numPages,width:a.width,height:a.height,title:o?.Title||null,author:o?.Author||null,subject:o?.Subject||null,keywords:o?.Keywords||null,creator:o?.Creator||null,producer:o?.Producer||null,creationDate:o?.CreationDate||null,modificationDate:o?.ModDate||null,pdfVersion:o?.PDFFormatVersion||null}}catch(n){return e.logger.error({error:n,errorMessage:n instanceof Error?n.message:String(n),errorStack:n instanceof Error?n.stack:void 0,errorCode:n?.code,blobId:t},`Failed to extract PDF metadata`),{error:`Failed to extract PDF metadata`,errorMessage:n instanceof Error?n.message:String(n)}}})),await s(`save-metadata`,async()=>{await e.storage.primary.updateBlobMetadata(t,{...u,analyzed:!0})}),e.logger.info({blobId:t,metadata:u},`Metadata extracted`),{...u,analyzed:!0}}});export{s as extractBlobMetadata};

package/dist/exports/api/workflows/generate-image-variant.d.mts

@@ -0,0 +1,99 @@
+import "../workflow.mjs";
+import "../index.mjs";
+import { z } from "zod";
+
+//#region src/api/workflows/generate-image-variant.d.ts
+/**
+ * Resize options schema for image transformations.
+ */
+declare const resizeSchema: z.ZodObject<{
+  width: z.ZodOptional<z.ZodNumber>;
+  height: z.ZodOptional<z.ZodNumber>;
+  fit: z.ZodOptional<z.ZodEnum<{
+    fill: "fill";
+    cover: "cover";
+    contain: "contain";
+    inside: "inside";
+    outside: "outside";
+  }>>;
+  position: z.ZodOptional<z.ZodEnum<{
+    left: "left";
+    right: "right";
+    top: "top";
+    "right top": "right top";
+    "right bottom": "right bottom";
+    bottom: "bottom";
+    "left bottom": "left bottom";
+    "left top": "left top";
+    centre: "centre";
+  }>>;
+  kernel: z.ZodOptional<z.ZodEnum<{
+    nearest: "nearest";
+    linear: "linear";
+    cubic: "cubic";
+    mitchell: "mitchell";
+    lanczos2: "lanczos2";
+    lanczos3: "lanczos3";
+  }>>;
+}, z.core.$strip>;
+/**
+ * Image transformations schema.
+ * Supports resize, rotate, flip, flop, sharpen, blur, grayscale, format conversion.
+ */
+declare const transformationsSchema: z.ZodObject<{
+  resize: z.ZodOptional<z.ZodObject<{
+    width: z.ZodOptional<z.ZodNumber>;
+    height: z.ZodOptional<z.ZodNumber>;
+    fit: z.ZodOptional<z.ZodEnum<{
+      fill: "fill";
+      cover: "cover";
+      contain: "contain";
+      inside: "inside";
+      outside: "outside";
+    }>>;
+    position: z.ZodOptional<z.ZodEnum<{
+      left: "left";
+      right: "right";
+      top: "top";
+      "right top": "right top";
+      "right bottom": "right bottom";
+      bottom: "bottom";
+      "left bottom": "left bottom";
+      "left top": "left top";
+      centre: "centre";
+    }>>;
+    kernel: z.ZodOptional<z.ZodEnum<{
+      nearest: "nearest";
+      linear: "linear";
+      cubic: "cubic";
+      mitchell: "mitchell";
+      lanczos2: "lanczos2";
+      lanczos3: "lanczos3";
+    }>>;
+  }, z.core.$strip>>;
+  rotate: z.ZodOptional<z.ZodNumber>;
+  flip: z.ZodOptional<z.ZodBoolean>;
+  flop: z.ZodOptional<z.ZodBoolean>;
+  sharpen: z.ZodOptional<z.ZodBoolean>;
+  blur: z.ZodOptional<z.ZodNumber>;
+  grayscale: z.ZodOptional<z.ZodBoolean>;
+  format: z.ZodOptional<z.ZodEnum<{
+    jpeg: "jpeg";
+    png: "png";
+    webp: "webp";
+    avif: "avif";
+    gif: "gif";
+  }>>;
+  quality: z.ZodOptional<z.ZodNumber>;
+  preview: z.ZodOptional<z.ZodLiteral<true>>;
+}, z.core.$strip>;
+/**
+ * Types for image transformations.
+ */
+type ImageTransformations = z.infer<typeof transformationsSchema>;
+/**
+ * Types for resize options.
+ */
+type ResizeOptions = z.infer<typeof resizeSchema>;
+//#endregion
+export { ImageTransformations, ResizeOptions, resizeSchema, transformationsSchema };

package/dist/exports/api/workflows/generate-image-variant.mjs

@@ -0,0 +1 @@
+import{defineWorkflow as e}from"../workflow.mjs";import{z as t}from"zod";import n from"sharp";const r=t.object({width:t.number().optional(),height:t.number().optional(),fit:t.enum([`cover`,`contain`,`fill`,`inside`,`outside`]).optional(),position:t.enum([`top`,`right top`,`right`,`right bottom`,`bottom`,`left bottom`,`left`,`left top`,`centre`]).optional(),kernel:t.enum([`nearest`,`linear`,`cubic`,`mitchell`,`lanczos2`,`lanczos3`]).optional()}),i=t.object({resize:r.optional(),rotate:t.number().optional(),flip:t.boolean().optional(),flop:t.boolean().optional(),sharpen:t.boolean().optional(),blur:t.number().optional(),grayscale:t.boolean().optional(),format:t.enum([`jpeg`,`png`,`webp`,`avif`,`gif`]).optional(),quality:t.number().min(1).max(100).optional(),preview:t.literal(!0).optional()}),a=e({input:t.object({blobId:t.string(),transformations:i}),async run({container:e,input:{blobId:t,transformations:r},step:i}){if(!await i(`fetch-blob`,async()=>e.storage.primary.getBlob(t)))throw Error(`Blob ${t} not found`);let a=await i(`download-blob`,async()=>e.storage.primary.downloadBlob(t));if(!a)throw Error(`Failed to download blob ${t}`);let o=await i(`apply-transformations`,async()=>{let e=n(a);return r.resize&&(e=e.resize({width:r.resize.width,height:r.resize.height,fit:r.resize.fit,position:r.resize.position,kernel:r.resize.kernel})),r.rotate!==void 0&&(e=e.rotate(r.rotate)),r.flip&&(e=e.flip()),r.flop&&(e=e.flop()),r.sharpen&&(e=e.sharpen()),r.blur!==void 0&&(e=e.blur(r.blur)),r.grayscale&&(e=e.grayscale()),r.format&&(e=e.toFormat(r.format,{quality:r.quality})),e.toBuffer()}),s=await i(`store-variant`,async()=>e.storage.primary.createVariant(t,r,o));return e.logger.info({blobId:t,variantId:s.id},`Image variant generated`),s}});export{a as generateImageVariant,r as resizeSchema,i as transformationsSchema};

package/dist/exports/api/workflows/generate-preview.mjs

@@ -0,0 +1 @@
+import{defineWorkflow as e}from"../workflow.mjs";import t from"zod";import{join as n}from"node:path";import r from"sharp";import{spawn as i}from"node:child_process";import{createCanvas as a}from"canvas";const o=e({input:t.object({blobId:t.string(),timeInSeconds:t.number().optional()}),async run({container:e,input:{blobId:t,timeInSeconds:o=1},step:s}){let c=await s(`fetch-blob`,async()=>e.storage.primary.getBlob(t));if(!c)throw Error(`Blob ${t} not found`);let l=await s(`download-blob`,async()=>e.storage.primary.downloadBlob(t));if(!l)throw Error(`Failed to download blob ${t}`);let u=null;if(c.contentType?.startsWith(`video/`))u=await s(`generate-video-preview`,async()=>new Promise((n,a)=>{try{let s=i(`ffmpeg`,[`-i`,`pipe:0`,`-ss`,o.toString(),`-frames:v`,`1`,`-f`,`image2pipe`,`-c:v`,`png`,`pipe:1`]),c=[],u=[];s.stdout.on(`data`,e=>{c.push(e)}),s.stderr.on(`data`,e=>{u.push(e)}),s.on(`close`,async i=>{if(i===0)try{n(await r(Buffer.concat(c)).jpeg({quality:80}).toBuffer())}catch(n){e.logger.error({error:n,blobId:t},`Failed to convert video frame to JPEG`),a(n)}else{let n=Buffer.concat(u).toString(),r=Error(`FFmpeg exited with code ${i}: ${n}`);e.logger.error({error:r,blobId:t,code:i,stderr:n},`Failed to generate video preview`),a(r)}}),s.on(`error`,n=>{e.logger.error({error:n,blobId:t},`Failed to spawn FFmpeg process`),a(n)}),s.stdin.on(`error`,n=>{n.code!==`EPIPE`&&e.logger.error({error:n,blobId:t},`Failed to write to FFmpeg stdin`)}),s.stdin.write(l),s.stdin.end()}catch(n){e.logger.error({error:n,blobId:t},`Failed to generate video preview`),a(n)}}));else if(c.contentType===`application/pdf`)u=await s(`generate-pdf-preview`,async()=>{try{let e=await import(`pdfjs-dist/legacy/build/pdf.mjs`),t=`${n(process.cwd(),`node_modules/pdfjs-dist/standard_fonts`)}/`,i=await(await e.getDocument({data:new Uint8Array(l),standardFontDataUrl:t}).promise).getPage(1),o=i.getViewport({scale:2}),s=a(o.width,o.height),c=s.getContext(`2d`);return await i.render({canvasContext:c,viewport:o,canvas:s}).promise,await r(s.toBuffer(`image/png`)).resize(800,800,{fit:`inside`,withoutEnlargement:!0}).jpeg({quality:85}).toBuffer()}catch(n){throw e.logger.error({error:n,errorMessage:n instanceof Error?n.message:String(n),errorStack:n instanceof Error?n.stack:void 0,errorCode:n?.code,blobId:t},`Failed to generate PDF preview`),n}});else if(c.contentType?.startsWith(`image/`))u=await s(`generate-image-preview`,async()=>await r(l).resize(800,800,{fit:`inside`,withoutEnlargement:!0}).jpeg({quality:85}).toBuffer());else throw Error(`Preview generation not supported for content type: ${c.contentType}`);let d=await s(`store-preview`,async()=>await e.storage.primary.createVariant(t,{preview:!0},u));return e.logger.info({blobId:t,previewId:d.id,contentType:c.contentType},`Preview generated`),d}});export{o as generatePreview};

package/dist/exports/api/workflows/index.d.mts

@@ -0,0 +1,2 @@
+import { TrackDbChangesInput, trackDbChanges } from "./track-db-changes.mjs";
+export { TrackDbChangesInput, trackDbChanges };

package/dist/exports/api/workflows/index.mjs

@@ -0,0 +1 @@
+import{trackDbChanges as e}from"./track-db-changes.mjs";export{e as trackDbChanges};

package/dist/exports/api/workflows/logger.d.mts

@@ -0,0 +1,21 @@
+import pino, { LoggerOptions } from "pino";
+
+//#region src/api/logger.d.ts
+
+/**
+ * Extended logger options with OpenTelemetry support.
+ */
+interface DefineLoggerOptions extends LoggerOptions {}
+/**
+ * The logger instance type.
+ */
+type Logger = Awaited<ReturnType<typeof defineLogger>>;
+/**
+ * Define the logger instance.
+ *
+ * @param opts - The options.
+ * @returns The logger.
+ */
+declare function defineLogger(opts: DefineLoggerOptions): Promise<pino.Logger<never, boolean>>;
+//#endregion
+export { Logger };

package/dist/exports/api/workflows/mailer.d.mts

@@ -0,0 +1,70 @@
+import Mail from "nodemailer/lib/mailer/index.ts";
+import { JSX } from "react";
+
+//#region src/api/mailer.d.ts
+
+/**
+ * The mailer type.
+ */
+type Mailer = ReturnType<typeof defineMailer>;
+/**
+ * The mailer payload type with React component.
+ */
+type MailerPayloadReact = Omit<Mail.Options, "from" | "html" | "text"> & {
+  /**
+   * The email address to send the email from.
+   */
+  from?: string;
+  /**
+   * The React component to render as the email body.
+   */
+  react: JSX.Element;
+};
+/**
+ * The mailer payload type with direct HTML and text.
+ */
+type MailerPayloadHtml = Omit<Mail.Options, "from"> & {
+  /**
+   * The email address to send the email from.
+   */
+  from?: string;
+  /**
+   * The HTML content of the email.
+   */
+  html: string;
+  /**
+   * The plain text content of the email.
+   */
+  text: string;
+};
+/**
+ * The mailer payload type - supports either React component or direct HTML+text.
+ */
+type MailerPayload = MailerPayloadReact | MailerPayloadHtml;
+/**
+ * Define the options for the mailer.
+ */
+interface DefineMailerOptions {
+  /**
+   * The default email address to use as the sender.
+   */
+  from: string;
+  /**
+   * The SMTP URL to use for sending emails.
+   */
+  smtpUrl: string;
+}
+/**
+ * Define the mailer.
+ *
+ * @param env - The environment variables.
+ * @returns The mailer.
+ */
+declare function defineMailer({
+  from,
+  smtpUrl
+}: DefineMailerOptions): {
+  send(payload: MailerPayload): Promise<void>;
+};
+//#endregion
+export { Mailer };

package/dist/exports/api/workflows/orm.d.mts

@@ -0,0 +1,13 @@
+import { __export, __reExport } from "./_virtual/rolldown_runtime.mjs";
+import { index, isPgEnum, isPgMaterializedView, isPgSchema, isPgSequence, isPgView, numeric, parsePgArray, parsePgNestedArray, pgEnum, pgMaterializedView, pgPolicy, pgRole, pgSchema, pgSequence, pgTable as pgTable$1, pgTableCreator, pgView, serial, smallint, smallserial, sparsevec, unique, uniqueIndex, uniqueKeyName, withReplicas } from "drizzle-orm/pg-core";
+export * from "drizzle-orm";
+export * from "drizzle-seed";
+
+//#region src/api/orm.d.ts
+declare namespace orm_d_exports {
+  export { index, isPgEnum, isPgMaterializedView, isPgSchema, isPgSequence, isPgView, numeric, parsePgArray, parsePgNestedArray, pgEnum, pgMaterializedView, pgPolicy, pgRole, pgSchema, pgSequence, pgTable$1 as pgTable, pgTableCreator, pgView, serial, smallint, smallserial, sparsevec, unique, uniqueIndex, uniqueKeyName, withReplicas };
+}
+import * as import_drizzle_orm from "drizzle-orm";
+import * as import_drizzle_seed from "drizzle-seed";
+//#endregion
+export { import_drizzle_seed as orm_d_exports };

package/dist/exports/api/workflows/purge-attachment.mjs

@@ -0,0 +1 @@
+import{defineWorkflow as e}from"../workflow.mjs";import t from"zod";const n=e({input:t.object({attachmentIds:t.array(t.string()).min(1)}),async run({container:e,input:{attachmentIds:t},step:n}){let r=await n(`fetch-attachments`,async()=>(await e.storage.primary.getAttachmentsByIds(t)).filter(e=>e.blob!==null).map(e=>({attachmentId:e.id,blobId:e.blob.id})));return await n(`delete-attachments`,async()=>{for(let{attachmentId:t}of r)await e.storage.primary.deleteAttachment(t)}),await n(`delete-blobs`,async()=>{for(let{blobId:t}of r)await e.storage.primary.deleteBlob(t)}),e.logger.info({attachmentIds:t,blobCount:r.length},`Attachments and blobs purged`),{purgedCount:r.length}}});export{n as purgeAttachment};

package/dist/exports/api/workflows/purge-audit-logs.mjs

@@ -0,0 +1 @@
+import{defineAuthSchema as e}from"../auth-schema.mjs";import{defineScheduledWorkflow as t}from"../workflow.mjs";import{lt as n}from"drizzle-orm";const r=e();function i(e=`0 0 * * *`){return t({crontab:e,async run({container:e,step:t,scheduledTime:i}){let a=e.auth.auditLog?.retentionDays??90,o=new Date(i);o.setDate(o.getDate()-a);let s=o.toISOString(),c=await t(`delete-old-logs`,async()=>{let{auditLogs:t}=r.tables;return(await e.db.primary.delete(t).where(n(t.createdAt,s)).returning({id:t.id})).length});e.logger.info({deletedCount:c,retentionDays:a,cutoffDate:s},`Audit log purge completed`)}})}export{i as definePurgeAuditLogs};

package/dist/exports/api/workflows/purge-unattached-blobs.mjs

@@ -0,0 +1 @@
+import{defineScheduledWorkflow as e}from"../workflow.mjs";function t(t=`0 0 * * *`){return e({crontab:t,async run({container:e,step:t}){let n=new Date(Date.now()-2880*60*1e3).toISOString(),r=await t(`fetch-unattached-blobs`,async()=>e.storage.primary.getUnattachedBlobs({olderThan:n})),i=await t(`fetch-pending-blobs`,async()=>e.storage.primary.getPendingBlobs(n)),a=[...r,...i],o=0;for(let n of a)await t(`delete-blob`,async()=>{await e.storage.primary.deleteBlob(n.id),o++});e.logger.info({purgedCount:o,unattachedCount:r.length,pendingCount:i.length},`Orphaned blobs purged`)}})}export{t as definePurgeUnattachedBlobs};

package/dist/exports/api/workflows/redis.mjs

@@ -0,0 +1 @@
+import"redis";export{};