@happyvertical/smrt-core 0.30.0

package/dist/dispatch/collections/Dispatches.js

@@ -0,0 +1,358 @@
+import { Dispatch } from "../models/Dispatch.js";
+function pushTenantPredicate(conditions, params, scope, placeholder) {
+  if (!scope?.enforced) {
+    return false;
+  }
+  if (scope.tenantId !== null) {
+    conditions.push(`(tenant_id = ${placeholder} OR tenant_id IS NULL)`);
+    params.push(scope.tenantId);
+    return true;
+  }
+  conditions.push("tenant_id IS NULL");
+  return false;
+}
+class DispatchCollection {
+  /**
+   * Insert a new dispatch
+   */
+  static async insert(db, dispatch) {
+    const row = dispatch.toRow();
+    await db.query(
+      `INSERT INTO _smrt_dispatch
+        (id, type, source, source_id, payload, status, attempts, last_error,
+         processed_at, processed_by, target_subscriber, correlation_id, tenant_id, metadata, created_at, updated_at)
+       VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11, $12, $13, $14, $15, $16)`,
+      row.id,
+      row.type,
+      row.source,
+      row.source_id,
+      row.payload,
+      row.status,
+      row.attempts,
+      row.last_error,
+      row.processed_at,
+      row.processed_by,
+      row.target_subscriber,
+      row.correlation_id,
+      row.tenant_id,
+      row.metadata,
+      row.created_at,
+      row.updated_at
+    );
+  }
+  /**
+   * Update an existing dispatch
+   */
+  static async update(db, dispatch) {
+    const row = dispatch.toRow();
+    await db.query(
+      `UPDATE _smrt_dispatch SET
+        type = $1, source = $2, source_id = $3, payload = $4, status = $5,
+        attempts = $6, last_error = $7, processed_at = $8, processed_by = $9,
+        target_subscriber = $10, correlation_id = $11, metadata = $12, updated_at = $13
+       WHERE id = $14`,
+      row.type,
+      row.source,
+      row.source_id,
+      row.payload,
+      row.status,
+      row.attempts,
+      row.last_error,
+      row.processed_at,
+      row.processed_by,
+      row.target_subscriber,
+      row.correlation_id,
+      row.metadata,
+      row.updated_at,
+      row.id
+    );
+  }
+  /**
+   * Get a dispatch by ID (unscoped).
+   *
+   * Internal/system use only — applies no tenant filter. Public reads go
+   * through the DispatchBus, which uses {@link getScoped} so a caller cannot
+   * fetch another tenant's dispatch by id (S5 #1398).
+   */
+  static async get(db, id) {
+    const result = await db.single`
+      SELECT * FROM _smrt_dispatch WHERE id = ${id}
+    `;
+    if (!result) return null;
+    return Dispatch.fromRow(result);
+  }
+  /**
+   * Get a dispatch by ID, enforcing the active tenant scope (S5 #1398).
+   *
+   * Applies the same tenant predicate as {@link list}/{@link findPending}, so a
+   * cross-tenant or out-of-scope id lookup returns `null` rather than leaking
+   * the row. The scope is derived server-side by the DispatchBus.
+   */
+  static async getScoped(db, id, tenantScope) {
+    const conditions = ["id = $1"];
+    const params = [id];
+    pushTenantPredicate(conditions, params, tenantScope, "$2");
+    const { rows } = await db.query(
+      `SELECT * FROM _smrt_dispatch WHERE ${conditions.join(" AND ")} LIMIT 1`,
+      ...params
+    );
+    if (rows.length === 0) return null;
+    return Dispatch.fromRow(rows[0]);
+  }
+  /**
+   * List dispatches with filtering
+   */
+  static async list(db, options = {}) {
+    const conditions = [];
+    const params = [];
+    let paramIndex = 1;
+    if (options.status) {
+      conditions.push(`status = $${paramIndex++}`);
+      params.push(options.status);
+    }
+    if (options.source) {
+      conditions.push(`source = $${paramIndex++}`);
+      params.push(options.source);
+    }
+    if (options.type) {
+      conditions.push(`type = $${paramIndex++}`);
+      params.push(options.type);
+    }
+    if (options.targetSubscriber) {
+      conditions.push(`target_subscriber = $${paramIndex++}`);
+      params.push(options.targetSubscriber);
+    }
+    if (options.correlationId !== void 0) {
+      conditions.push(`correlation_id = $${paramIndex++}`);
+      params.push(options.correlationId);
+    }
+    if (pushTenantPredicate(
+      conditions,
+      params,
+      options.tenantScope,
+      `$${paramIndex}`
+    )) {
+      paramIndex++;
+    }
+    let sql = "SELECT * FROM _smrt_dispatch";
+    if (conditions.length > 0) {
+      sql += ` WHERE ${conditions.join(" AND ")}`;
+    }
+    const allowedOrderBy = [
+      "created_at DESC",
+      "created_at ASC",
+      "updated_at DESC",
+      "updated_at ASC",
+      "type",
+      "type DESC",
+      "type ASC",
+      "status",
+      "status DESC",
+      "status ASC",
+      "source",
+      "source DESC",
+      "source ASC"
+    ];
+    const safeOrderBy = options.orderBy && allowedOrderBy.includes(options.orderBy) ? options.orderBy : "created_at DESC";
+    sql += ` ORDER BY ${safeOrderBy}`;
+    if (options.limit !== void 0) {
+      sql += ` LIMIT $${paramIndex++}`;
+      params.push(options.limit);
+    }
+    if (options.offset !== void 0) {
+      sql += ` OFFSET $${paramIndex++}`;
+      params.push(options.offset);
+    }
+    const { rows } = await db.query(sql, ...params);
+    return rows.map(
+      (row) => Dispatch.fromRow(row)
+    );
+  }
+  /**
+   * Find pending dispatches for a set of signal types
+   *
+   * @param subscriber - When provided, filters to dispatches with no target
+   *   or targeted specifically at this subscriber (for fan-out delivery)
+   * @param tenantScope - Active tenant scope (S5 #1398). Derived server-side by
+   *   the bus; restricts results so a subscriber in one tenant cannot see
+   *   another tenant's dispatch. See {@link pushTenantPredicate} for the exact
+   *   semantics (off → no filter; active tenant → that tenant + global; on but
+   *   no tenant → global only).
+   */
+  static async findPending(db, signalTypes, limit = 100, subscriber, tenantScope) {
+    if (signalTypes.length === 0) {
+      return [];
+    }
+    let paramIndex = 1;
+    const placeholders = signalTypes.map(() => `$${paramIndex++}`).join(", ");
+    const conditions = [
+      "status = 'pending'",
+      `type IN (${placeholders})`
+    ];
+    const params = [...signalTypes];
+    if (subscriber) {
+      conditions.push(
+        `(target_subscriber IS NULL OR target_subscriber = $${paramIndex++})`
+      );
+      params.push(subscriber);
+    }
+    if (pushTenantPredicate(conditions, params, tenantScope, `$${paramIndex}`)) {
+      paramIndex++;
+    }
+    const sql = `SELECT * FROM _smrt_dispatch
+       WHERE ${conditions.join(" AND ")}
+       ORDER BY created_at ASC LIMIT $${paramIndex}`;
+    params.push(limit);
+    const { rows } = await db.query(sql, ...params);
+    return rows.map(
+      (row) => Dispatch.fromRow(row)
+    );
+  }
+  /**
+   * Atomically claim a pending dispatch for processing (S5 #1398).
+   *
+   * Performs a conditional `UPDATE ... WHERE id = ? AND status = 'pending'`
+   * (plus the tenant predicate for the active scope) and reports whether the
+   * row was claimed by THIS call. Only the caller whose update affected a row
+   * may run the handler, which closes the claim TOCTOU window where a `process`
+   * filter-then-update could let two workers (or a tenant-scoped and a
+   * system-scoped processor) both pick up the same compete/global dispatch.
+   *
+   * On a successful claim the dispatch's status/attempts/updated_at are
+   * advanced in the DB; the in-memory `dispatch` instance is updated to match
+   * so the caller can proceed to `update()` it to completed/failed.
+   *
+   * @returns `true` if this call claimed the dispatch, `false` if another
+   *   worker already moved it out of `pending` (or it is not visible in scope).
+   */
+  static async claim(db, dispatch, tenantScope) {
+    dispatch.markProcessing();
+    const row = dispatch.toRow();
+    const conditions = ["id = $4", "status = 'pending'"];
+    const params = [
+      row.status,
+      row.attempts,
+      row.updated_at,
+      row.id
+    ];
+    let paramIndex = 5;
+    if (pushTenantPredicate(conditions, params, tenantScope, `$${paramIndex}`)) {
+      paramIndex++;
+    }
+    const { rowCount } = await db.query(
+      `UPDATE _smrt_dispatch
+         SET status = $1, attempts = $2, updated_at = $3
+       WHERE ${conditions.join(" AND ")}`,
+      ...params
+    );
+    return (rowCount ?? 0) > 0;
+  }
+  /**
+   * Find failed dispatches eligible for retry.
+   *
+   * @param tenantScope - Active tenant scope (S5 #1398). Derived server-side by
+   *   the bus; restricts retryable rows to the active tenant (plus global) so a
+   *   tenant's `retry()` cannot reset another tenant's failed dispatches. See
+   *   {@link pushTenantPredicate} for the exact semantics.
+   */
+  static async findRetryable(db, options = {}, tenantScope) {
+    const conditions = ["status = 'failed'"];
+    const params = [];
+    let paramIndex = 1;
+    if (options.maxAttempts) {
+      conditions.push(`attempts < $${paramIndex++}`);
+      params.push(options.maxAttempts);
+    }
+    if (options.olderThan) {
+      conditions.push(`created_at < $${paramIndex++}`);
+      params.push(options.olderThan.toISOString());
+    }
+    if (options.signalTypes && options.signalTypes.length > 0) {
+      const placeholders = options.signalTypes.map(() => `$${paramIndex++}`).join(", ");
+      conditions.push(`type IN (${placeholders})`);
+      params.push(...options.signalTypes);
+    }
+    if (pushTenantPredicate(conditions, params, tenantScope, `$${paramIndex}`)) {
+      paramIndex++;
+    }
+    const { rows } = await db.query(
+      `SELECT * FROM _smrt_dispatch WHERE ${conditions.join(" AND ")} ORDER BY created_at ASC`,
+      ...params
+    );
+    return rows.map(
+      (row) => Dispatch.fromRow(row)
+    );
+  }
+  /**
+   * Count dispatches by status
+   */
+  static async countByStatus(db, status) {
+    const result = await db.single`
+      SELECT COUNT(*) as count FROM _smrt_dispatch WHERE status = ${status}
+    `;
+    return result?.count || 0;
+  }
+  /**
+   * Delete a dispatch
+   */
+  static async delete(db, id) {
+    await db.query(`DELETE FROM _smrt_dispatch WHERE id = $1`, id);
+  }
+  /**
+   * Cleanup old dispatches.
+   *
+   * @param tenantScope - Active tenant scope (S5 #1398). Derived server-side by
+   *   the bus; restricts deletions to the active tenant (plus global) so a
+   *   tenant's `cleanup()` cannot delete another tenant's dispatches. See
+   *   {@link pushTenantPredicate} for the exact semantics.
+   */
+  static async cleanup(db, options = {}, tenantScope) {
+    const result = {
+      completedDeleted: 0,
+      failedDeleted: 0
+    };
+    if (options.completedOlderThanDays) {
+      const cutoff = /* @__PURE__ */ new Date();
+      cutoff.setDate(cutoff.getDate() - options.completedOlderThanDays);
+      const conditions = [
+        "status = 'completed'",
+        "processed_at < $1"
+      ];
+      const params = [cutoff.toISOString()];
+      pushTenantPredicate(conditions, params, tenantScope, "$2");
+      const { rowCount } = await db.query(
+        `DELETE FROM _smrt_dispatch WHERE ${conditions.join(" AND ")}`,
+        ...params
+      );
+      result.completedDeleted = rowCount || 0;
+    }
+    if (options.failedOlderThanDays) {
+      const cutoff = /* @__PURE__ */ new Date();
+      cutoff.setDate(cutoff.getDate() - options.failedOlderThanDays);
+      const conditions = ["status = 'failed'", "updated_at < $1"];
+      const params = [cutoff.toISOString()];
+      pushTenantPredicate(conditions, params, tenantScope, "$2");
+      const { rowCount } = await db.query(
+        `DELETE FROM _smrt_dispatch WHERE ${conditions.join(" AND ")}`,
+        ...params
+      );
+      result.failedDeleted = rowCount || 0;
+    }
+    return result;
+  }
+  /**
+   * Check if dispatch table exists
+   */
+  static async tableExists(db) {
+    try {
+      await db.query(`SELECT 1 FROM _smrt_dispatch LIMIT 1`);
+      return true;
+    } catch {
+      return false;
+    }
+  }
+}
+export {
+  DispatchCollection
+};
+//# sourceMappingURL=Dispatches.js.map

package/dist/dispatch/collections/Dispatches.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Dispatches.js","sources":["../../../src/dispatch/collections/Dispatches.ts"],"sourcesContent":["/**\n * DispatchCollection - Storage operations for dispatch messages\n *\n * CRUD operations for the _smrt_dispatch system table.\n */\n\nimport type { DatabaseInterface } from '@happyvertical/sql';\nimport { Dispatch, type DispatchData } from '../models/Dispatch.js';\nimport type { DispatchTenantScope } from '../tenant-resolver.js';\nimport type {\n  DispatchCleanupOptions,\n  DispatchCleanupResult,\n  DispatchListOptions,\n  DispatchRetryOptions,\n  DispatchStatus,\n} from '../types.js';\n\n/**\n * Build the SQL tenant predicate for the active scope (S5 #1398).\n *\n * Appends a parameterized condition to `conditions` (and the corresponding\n * value to `params`) based on the resolved {@link DispatchTenantScope}:\n *\n *  - tenancy off / no scope → no predicate (pre-tenancy behavior)\n *  - `enforced` + active tenant T → `(tenant_id = ? OR tenant_id IS NULL)`\n *  - `enforced` + no active tenant → `tenant_id IS NULL` (fail-closed global)\n *\n * @param placeholder - Engine-specific positional placeholder (e.g. `$3`) used\n *   when a tenant id value is bound. Ignored for the no-value branches.\n * @returns `true` when a value placeholder was consumed (so the caller can\n *   advance its param index), `false` otherwise.\n */\nfunction pushTenantPredicate(\n  conditions: string[],\n  params: unknown[],\n  scope: DispatchTenantScope | undefined,\n  placeholder: string,\n): boolean {\n  if (!scope?.enforced) {\n    return false;\n  }\n  if (scope.tenantId !== null) {\n    conditions.push(`(tenant_id = ${placeholder} OR tenant_id IS NULL)`);\n    params.push(scope.tenantId);\n    return true;\n  }\n  conditions.push('tenant_id IS NULL');\n  return false;\n}\n\n/**\n * Storage operations for dispatches in _smrt_dispatch table\n */\nexport class DispatchCollection {\n  /**\n   * Insert a new dispatch\n   */\n  static async insert(\n    db: DatabaseInterface,\n    dispatch: Dispatch,\n  ): Promise<void> {\n    const row = dispatch.toRow();\n    await db.query(\n      `INSERT INTO _smrt_dispatch\n        (id, type, source, source_id, payload, status, attempts, last_error,\n         processed_at, processed_by, target_subscriber, correlation_id, tenant_id, metadata, created_at, updated_at)\n       VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11, $12, $13, $14, $15, $16)`,\n      row.id,\n      row.type,\n      row.source,\n      row.source_id,\n      row.payload,\n      row.status,\n      row.attempts,\n      row.last_error,\n      row.processed_at,\n      row.processed_by,\n      row.target_subscriber,\n      row.correlation_id,\n      row.tenant_id,\n      row.metadata,\n      row.created_at,\n      row.updated_at,\n    );\n  }\n\n  /**\n   * Update an existing dispatch\n   */\n  static async update(\n    db: DatabaseInterface,\n    dispatch: Dispatch,\n  ): Promise<void> {\n    const row = dispatch.toRow();\n    await db.query(\n      `UPDATE _smrt_dispatch SET\n        type = $1, source = $2, source_id = $3, payload = $4, status = $5,\n        attempts = $6, last_error = $7, processed_at = $8, processed_by = $9,\n        target_subscriber = $10, correlation_id = $11, metadata = $12, updated_at = $13\n       WHERE id = $14`,\n      row.type,\n      row.source,\n      row.source_id,\n      row.payload,\n      row.status,\n      row.attempts,\n      row.last_error,\n      row.processed_at,\n      row.processed_by,\n      row.target_subscriber,\n      row.correlation_id,\n      row.metadata,\n      row.updated_at,\n      row.id,\n    );\n  }\n\n  /**\n   * Get a dispatch by ID (unscoped).\n   *\n   * Internal/system use only — applies no tenant filter. Public reads go\n   * through the DispatchBus, which uses {@link getScoped} so a caller cannot\n   * fetch another tenant's dispatch by id (S5 #1398).\n   */\n  static async get(\n    db: DatabaseInterface,\n    id: string,\n  ): Promise<Dispatch | null> {\n    const result = await db.single`\n      SELECT * FROM _smrt_dispatch WHERE id = ${id}\n    `;\n\n    if (!result) return null;\n    return Dispatch.fromRow(result as DispatchData);\n  }\n\n  /**\n   * Get a dispatch by ID, enforcing the active tenant scope (S5 #1398).\n   *\n   * Applies the same tenant predicate as {@link list}/{@link findPending}, so a\n   * cross-tenant or out-of-scope id lookup returns `null` rather than leaking\n   * the row. The scope is derived server-side by the DispatchBus.\n   */\n  static async getScoped(\n    db: DatabaseInterface,\n    id: string,\n    tenantScope?: DispatchTenantScope,\n  ): Promise<Dispatch | null> {\n    const conditions: string[] = ['id = $1'];\n    const params: unknown[] = [id];\n\n    pushTenantPredicate(conditions, params, tenantScope, '$2');\n\n    const { rows } = await db.query(\n      `SELECT * FROM _smrt_dispatch WHERE ${conditions.join(' AND ')} LIMIT 1`,\n      ...params,\n    );\n\n    if (rows.length === 0) return null;\n    return Dispatch.fromRow(rows[0] as unknown as DispatchData);\n  }\n\n  /**\n   * List dispatches with filtering\n   */\n  static async list(\n    db: DatabaseInterface,\n    options: DispatchListOptions = {},\n  ): Promise<Dispatch[]> {\n    const conditions: string[] = [];\n    const params: unknown[] = [];\n    let paramIndex = 1;\n\n    if (options.status) {\n      conditions.push(`status = $${paramIndex++}`);\n      params.push(options.status);\n    }\n\n    if (options.source) {\n      conditions.push(`source = $${paramIndex++}`);\n      params.push(options.source);\n    }\n\n    if (options.type) {\n      conditions.push(`type = $${paramIndex++}`);\n      params.push(options.type);\n    }\n\n    if (options.targetSubscriber) {\n      conditions.push(`target_subscriber = $${paramIndex++}`);\n      params.push(options.targetSubscriber);\n    }\n\n    if (options.correlationId !== undefined) {\n      conditions.push(`correlation_id = $${paramIndex++}`);\n      params.push(options.correlationId);\n    }\n\n    // Tenant isolation (S5 #1398). Scope is derived server-side by the bus;\n    // callers cannot widen it. See DispatchListOptions.tenantScope.\n    if (\n      pushTenantPredicate(\n        conditions,\n        params,\n        options.tenantScope,\n        `$${paramIndex}`,\n      )\n    ) {\n      paramIndex++;\n    }\n\n    let sql = 'SELECT * FROM _smrt_dispatch';\n    if (conditions.length > 0) {\n      sql += ` WHERE ${conditions.join(' AND ')}`;\n    }\n\n    // Whitelist allowed orderBy values to prevent SQL injection\n    const allowedOrderBy = [\n      'created_at DESC',\n      'created_at ASC',\n      'updated_at DESC',\n      'updated_at ASC',\n      'type',\n      'type DESC',\n      'type ASC',\n      'status',\n      'status DESC',\n      'status ASC',\n      'source',\n      'source DESC',\n      'source ASC',\n    ];\n    const safeOrderBy =\n      options.orderBy && allowedOrderBy.includes(options.orderBy)\n        ? options.orderBy\n        : 'created_at DESC';\n    sql += ` ORDER BY ${safeOrderBy}`;\n\n    // Use parameterized queries for limit/offset\n    if (options.limit !== undefined) {\n      sql += ` LIMIT $${paramIndex++}`;\n      params.push(options.limit);\n    }\n\n    if (options.offset !== undefined) {\n      sql += ` OFFSET $${paramIndex++}`;\n      params.push(options.offset);\n    }\n\n    const { rows } = await db.query(sql, ...params);\n    return rows.map((row: Record<string, unknown>) =>\n      Dispatch.fromRow(row as unknown as DispatchData),\n    );\n  }\n\n  /**\n   * Find pending dispatches for a set of signal types\n   *\n   * @param subscriber - When provided, filters to dispatches with no target\n   *   or targeted specifically at this subscriber (for fan-out delivery)\n   * @param tenantScope - Active tenant scope (S5 #1398). Derived server-side by\n   *   the bus; restricts results so a subscriber in one tenant cannot see\n   *   another tenant's dispatch. See {@link pushTenantPredicate} for the exact\n   *   semantics (off → no filter; active tenant → that tenant + global; on but\n   *   no tenant → global only).\n   */\n  static async findPending(\n    db: DatabaseInterface,\n    signalTypes: string[],\n    limit: number = 100,\n    subscriber?: string,\n    tenantScope?: DispatchTenantScope,\n  ): Promise<Dispatch[]> {\n    if (signalTypes.length === 0) {\n      return [];\n    }\n\n    let paramIndex = 1;\n    const placeholders = signalTypes.map(() => `$${paramIndex++}`).join(', ');\n    const conditions: string[] = [\n      \"status = 'pending'\",\n      `type IN (${placeholders})`,\n    ];\n    const params: unknown[] = [...signalTypes];\n\n    if (subscriber) {\n      conditions.push(\n        `(target_subscriber IS NULL OR target_subscriber = $${paramIndex++})`,\n      );\n      params.push(subscriber);\n    }\n\n    if (\n      pushTenantPredicate(conditions, params, tenantScope, `$${paramIndex}`)\n    ) {\n      paramIndex++;\n    }\n\n    const sql = `SELECT * FROM _smrt_dispatch\n       WHERE ${conditions.join(' AND ')}\n       ORDER BY created_at ASC LIMIT $${paramIndex}`;\n    params.push(limit);\n\n    const { rows } = await db.query(sql, ...params);\n\n    return rows.map((row: Record<string, unknown>) =>\n      Dispatch.fromRow(row as unknown as DispatchData),\n    );\n  }\n\n  /**\n   * Atomically claim a pending dispatch for processing (S5 #1398).\n   *\n   * Performs a conditional `UPDATE ... WHERE id = ? AND status = 'pending'`\n   * (plus the tenant predicate for the active scope) and reports whether the\n   * row was claimed by THIS call. Only the caller whose update affected a row\n   * may run the handler, which closes the claim TOCTOU window where a `process`\n   * filter-then-update could let two workers (or a tenant-scoped and a\n   * system-scoped processor) both pick up the same compete/global dispatch.\n   *\n   * On a successful claim the dispatch's status/attempts/updated_at are\n   * advanced in the DB; the in-memory `dispatch` instance is updated to match\n   * so the caller can proceed to `update()` it to completed/failed.\n   *\n   * @returns `true` if this call claimed the dispatch, `false` if another\n   *   worker already moved it out of `pending` (or it is not visible in scope).\n   */\n  static async claim(\n    db: DatabaseInterface,\n    dispatch: Dispatch,\n    tenantScope?: DispatchTenantScope,\n  ): Promise<boolean> {\n    dispatch.markProcessing();\n    const row = dispatch.toRow();\n\n    const conditions: string[] = ['id = $4', \"status = 'pending'\"];\n    const params: unknown[] = [\n      row.status,\n      row.attempts,\n      row.updated_at,\n      row.id,\n    ];\n    let paramIndex = 5;\n\n    if (\n      pushTenantPredicate(conditions, params, tenantScope, `$${paramIndex}`)\n    ) {\n      paramIndex++;\n    }\n\n    const { rowCount } = await db.query(\n      `UPDATE _smrt_dispatch\n         SET status = $1, attempts = $2, updated_at = $3\n       WHERE ${conditions.join(' AND ')}`,\n      ...params,\n    );\n\n    return (rowCount ?? 0) > 0;\n  }\n\n  /**\n   * Find failed dispatches eligible for retry.\n   *\n   * @param tenantScope - Active tenant scope (S5 #1398). Derived server-side by\n   *   the bus; restricts retryable rows to the active tenant (plus global) so a\n   *   tenant's `retry()` cannot reset another tenant's failed dispatches. See\n   *   {@link pushTenantPredicate} for the exact semantics.\n   */\n  static async findRetryable(\n    db: DatabaseInterface,\n    options: DispatchRetryOptions = {},\n    tenantScope?: DispatchTenantScope,\n  ): Promise<Dispatch[]> {\n    const conditions: string[] = [\"status = 'failed'\"];\n    const params: unknown[] = [];\n    let paramIndex = 1;\n\n    if (options.maxAttempts) {\n      conditions.push(`attempts < $${paramIndex++}`);\n      params.push(options.maxAttempts);\n    }\n\n    if (options.olderThan) {\n      conditions.push(`created_at < $${paramIndex++}`);\n      params.push(options.olderThan.toISOString());\n    }\n\n    if (options.signalTypes && options.signalTypes.length > 0) {\n      const placeholders = options.signalTypes\n        .map(() => `$${paramIndex++}`)\n        .join(', ');\n      conditions.push(`type IN (${placeholders})`);\n      params.push(...options.signalTypes);\n    }\n\n    if (\n      pushTenantPredicate(conditions, params, tenantScope, `$${paramIndex}`)\n    ) {\n      paramIndex++;\n    }\n\n    const { rows } = await db.query(\n      `SELECT * FROM _smrt_dispatch WHERE ${conditions.join(' AND ')} ORDER BY created_at ASC`,\n      ...params,\n    );\n\n    return rows.map((row: Record<string, unknown>) =>\n      Dispatch.fromRow(row as unknown as DispatchData),\n    );\n  }\n\n  /**\n   * Count dispatches by status\n   */\n  static async countByStatus(\n    db: DatabaseInterface,\n    status: DispatchStatus,\n  ): Promise<number> {\n    const result = await db.single`\n      SELECT COUNT(*) as count FROM _smrt_dispatch WHERE status = ${status}\n    `;\n    return (result as { count: number })?.count || 0;\n  }\n\n  /**\n   * Delete a dispatch\n   */\n  static async delete(db: DatabaseInterface, id: string): Promise<void> {\n    await db.query(`DELETE FROM _smrt_dispatch WHERE id = $1`, id);\n  }\n\n  /**\n   * Cleanup old dispatches.\n   *\n   * @param tenantScope - Active tenant scope (S5 #1398). Derived server-side by\n   *   the bus; restricts deletions to the active tenant (plus global) so a\n   *   tenant's `cleanup()` cannot delete another tenant's dispatches. See\n   *   {@link pushTenantPredicate} for the exact semantics.\n   */\n  static async cleanup(\n    db: DatabaseInterface,\n    options: DispatchCleanupOptions = {},\n    tenantScope?: DispatchTenantScope,\n  ): Promise<DispatchCleanupResult> {\n    const result: DispatchCleanupResult = {\n      completedDeleted: 0,\n      failedDeleted: 0,\n    };\n\n    if (options.completedOlderThanDays) {\n      const cutoff = new Date();\n      cutoff.setDate(cutoff.getDate() - options.completedOlderThanDays);\n\n      const conditions: string[] = [\n        \"status = 'completed'\",\n        'processed_at < $1',\n      ];\n      const params: unknown[] = [cutoff.toISOString()];\n      pushTenantPredicate(conditions, params, tenantScope, '$2');\n\n      const { rowCount } = await db.query(\n        `DELETE FROM _smrt_dispatch WHERE ${conditions.join(' AND ')}`,\n        ...params,\n      );\n      result.completedDeleted = rowCount || 0;\n    }\n\n    if (options.failedOlderThanDays) {\n      const cutoff = new Date();\n      cutoff.setDate(cutoff.getDate() - options.failedOlderThanDays);\n\n      const conditions: string[] = [\"status = 'failed'\", 'updated_at < $1'];\n      const params: unknown[] = [cutoff.toISOString()];\n      pushTenantPredicate(conditions, params, tenantScope, '$2');\n\n      const { rowCount } = await db.query(\n        `DELETE FROM _smrt_dispatch WHERE ${conditions.join(' AND ')}`,\n        ...params,\n      );\n      result.failedDeleted = rowCount || 0;\n    }\n\n    return result;\n  }\n\n  /**\n   * Check if dispatch table exists\n   */\n  static async tableExists(db: DatabaseInterface): Promise<boolean> {\n    try {\n      await db.query(`SELECT 1 FROM _smrt_dispatch LIMIT 1`);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n}\n"],"names":[],"mappings":";AAgCA,SAAS,oBACP,YACA,QACA,OACA,aACS;AACT,MAAI,CAAC,OAAO,UAAU;AACpB,WAAO;AAAA,EACT;AACA,MAAI,MAAM,aAAa,MAAM;AAC3B,eAAW,KAAK,gBAAgB,WAAW,wBAAwB;AACnE,WAAO,KAAK,MAAM,QAAQ;AAC1B,WAAO;AAAA,EACT;AACA,aAAW,KAAK,mBAAmB;AACnC,SAAO;AACT;AAKO,MAAM,mBAAmB;AAAA;AAAA;AAAA;AAAA,EAI9B,aAAa,OACX,IACA,UACe;AACf,UAAM,MAAM,SAAS,MAAA;AACrB,UAAM,GAAG;AAAA,MACP;AAAA;AAAA;AAAA;AAAA,MAIA,IAAI;AAAA,MACJ,IAAI;AAAA,MACJ,IAAI;AAAA,MACJ,IAAI;AAAA,MACJ,IAAI;AAAA,MACJ,IAAI;AAAA,MACJ,IAAI;AAAA,MACJ,IAAI;AAAA,MACJ,IAAI;AAAA,MACJ,IAAI;AAAA,MACJ,IAAI;AAAA,MACJ,IAAI;AAAA,MACJ,IAAI;AAAA,MACJ,IAAI;AAAA,MACJ,IAAI;AAAA,MACJ,IAAI;AAAA,IAAA;AAAA,EAER;AAAA;AAAA;AAAA;AAAA,EAKA,aAAa,OACX,IACA,UACe;AACf,UAAM,MAAM,SAAS,MAAA;AACrB,UAAM,GAAG;AAAA,MACP;AAAA;AAAA;AAAA;AAAA;AAAA,MAKA,IAAI;AAAA,MACJ,IAAI;AAAA,MACJ,IAAI;AAAA,MACJ,IAAI;AAAA,MACJ,IAAI;AAAA,MACJ,IAAI;AAAA,MACJ,IAAI;AAAA,MACJ,IAAI;AAAA,MACJ,IAAI;AAAA,MACJ,IAAI;AAAA,MACJ,IAAI;AAAA,MACJ,IAAI;AAAA,MACJ,IAAI;AAAA,MACJ,IAAI;AAAA,IAAA;AAAA,EAER;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,aAAa,IACX,IACA,IAC0B;AAC1B,UAAM,SAAS,MAAM,GAAG;AAAA,gDACoB,EAAE;AAAA;AAG9C,QAAI,CAAC,OAAQ,QAAO;AACpB,WAAO,SAAS,QAAQ,MAAsB;AAAA,EAChD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,aAAa,UACX,IACA,IACA,aAC0B;AAC1B,UAAM,aAAuB,CAAC,SAAS;AACvC,UAAM,SAAoB,CAAC,EAAE;AAE7B,wBAAoB,YAAY,QAAQ,aAAa,IAAI;AAEzD,UAAM,EAAE,KAAA,IAAS,MAAM,GAAG;AAAA,MACxB,sCAAsC,WAAW,KAAK,OAAO,CAAC;AAAA,MAC9D,GAAG;AAAA,IAAA;AAGL,QAAI,KAAK,WAAW,EAAG,QAAO;AAC9B,WAAO,SAAS,QAAQ,KAAK,CAAC,CAA4B;AAAA,EAC5D;AAAA;AAAA;AAAA;AAAA,EAKA,aAAa,KACX,IACA,UAA+B,IACV;AACrB,UAAM,aAAuB,CAAA;AAC7B,UAAM,SAAoB,CAAA;AAC1B,QAAI,aAAa;AAEjB,QAAI,QAAQ,QAAQ;AAClB,iBAAW,KAAK,aAAa,YAAY,EAAE;AAC3C,aAAO,KAAK,QAAQ,MAAM;AAAA,IAC5B;AAEA,QAAI,QAAQ,QAAQ;AAClB,iBAAW,KAAK,aAAa,YAAY,EAAE;AAC3C,aAAO,KAAK,QAAQ,MAAM;AAAA,IAC5B;AAEA,QAAI,QAAQ,MAAM;AAChB,iBAAW,KAAK,WAAW,YAAY,EAAE;AACzC,aAAO,KAAK,QAAQ,IAAI;AAAA,IAC1B;AAEA,QAAI,QAAQ,kBAAkB;AAC5B,iBAAW,KAAK,wBAAwB,YAAY,EAAE;AACtD,aAAO,KAAK,QAAQ,gBAAgB;AAAA,IACtC;AAEA,QAAI,QAAQ,kBAAkB,QAAW;AACvC,iBAAW,KAAK,qBAAqB,YAAY,EAAE;AACnD,aAAO,KAAK,QAAQ,aAAa;AAAA,IACnC;AAIA,QACE;AAAA,MACE;AAAA,MACA;AAAA,MACA,QAAQ;AAAA,MACR,IAAI,UAAU;AAAA,IAAA,GAEhB;AACA;AAAA,IACF;AAEA,QAAI,MAAM;AACV,QAAI,WAAW,SAAS,GAAG;AACzB,aAAO,UAAU,WAAW,KAAK,OAAO,CAAC;AAAA,IAC3C;AAGA,UAAM,iBAAiB;AAAA,MACrB;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IAAA;AAEF,UAAM,cACJ,QAAQ,WAAW,eAAe,SAAS,QAAQ,OAAO,IACtD,QAAQ,UACR;AACN,WAAO,aAAa,WAAW;AAG/B,QAAI,QAAQ,UAAU,QAAW;AAC/B,aAAO,WAAW,YAAY;AAC9B,aAAO,KAAK,QAAQ,KAAK;AAAA,IAC3B;AAEA,QAAI,QAAQ,WAAW,QAAW;AAChC,aAAO,YAAY,YAAY;AAC/B,aAAO,KAAK,QAAQ,MAAM;AAAA,IAC5B;AAEA,UAAM,EAAE,SAAS,MAAM,GAAG,MAAM,KAAK,GAAG,MAAM;AAC9C,WAAO,KAAK;AAAA,MAAI,CAAC,QACf,SAAS,QAAQ,GAA8B;AAAA,IAAA;AAAA,EAEnD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAaA,aAAa,YACX,IACA,aACA,QAAgB,KAChB,YACA,aACqB;AACrB,QAAI,YAAY,WAAW,GAAG;AAC5B,aAAO,CAAA;AAAA,IACT;AAEA,QAAI,aAAa;AACjB,UAAM,eAAe,YAAY,IAAI,MAAM,IAAI,YAAY,EAAE,EAAE,KAAK,IAAI;AACxE,UAAM,aAAuB;AAAA,MAC3B;AAAA,MACA,YAAY,YAAY;AAAA,IAAA;AAE1B,UAAM,SAAoB,CAAC,GAAG,WAAW;AAEzC,QAAI,YAAY;AACd,iBAAW;AAAA,QACT,sDAAsD,YAAY;AAAA,MAAA;AAEpE,aAAO,KAAK,UAAU;AAAA,IACxB;AAEA,QACE,oBAAoB,YAAY,QAAQ,aAAa,IAAI,UAAU,EAAE,GACrE;AACA;AAAA,IACF;AAEA,UAAM,MAAM;AAAA,eACD,WAAW,KAAK,OAAO,CAAC;AAAA,wCACC,UAAU;AAC9C,WAAO,KAAK,KAAK;AAEjB,UAAM,EAAE,SAAS,MAAM,GAAG,MAAM,KAAK,GAAG,MAAM;AAE9C,WAAO,KAAK;AAAA,MAAI,CAAC,QACf,SAAS,QAAQ,GAA8B;AAAA,IAAA;AAAA,EAEnD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAmBA,aAAa,MACX,IACA,UACA,aACkB;AAClB,aAAS,eAAA;AACT,UAAM,MAAM,SAAS,MAAA;AAErB,UAAM,aAAuB,CAAC,WAAW,oBAAoB;AAC7D,UAAM,SAAoB;AAAA,MACxB,IAAI;AAAA,MACJ,IAAI;AAAA,MACJ,IAAI;AAAA,MACJ,IAAI;AAAA,IAAA;AAEN,QAAI,aAAa;AAEjB,QACE,oBAAoB,YAAY,QAAQ,aAAa,IAAI,UAAU,EAAE,GACrE;AACA;AAAA,IACF;AAEA,UAAM,EAAE,SAAA,IAAa,MAAM,GAAG;AAAA,MAC5B;AAAA;AAAA,eAES,WAAW,KAAK,OAAO,CAAC;AAAA,MACjC,GAAG;AAAA,IAAA;AAGL,YAAQ,YAAY,KAAK;AAAA,EAC3B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,aAAa,cACX,IACA,UAAgC,CAAA,GAChC,aACqB;AACrB,UAAM,aAAuB,CAAC,mBAAmB;AACjD,UAAM,SAAoB,CAAA;AAC1B,QAAI,aAAa;AAEjB,QAAI,QAAQ,aAAa;AACvB,iBAAW,KAAK,eAAe,YAAY,EAAE;AAC7C,aAAO,KAAK,QAAQ,WAAW;AAAA,IACjC;AAEA,QAAI,QAAQ,WAAW;AACrB,iBAAW,KAAK,iBAAiB,YAAY,EAAE;AAC/C,aAAO,KAAK,QAAQ,UAAU,YAAA,CAAa;AAAA,IAC7C;AAEA,QAAI,QAAQ,eAAe,QAAQ,YAAY,SAAS,GAAG;AACzD,YAAM,eAAe,QAAQ,YAC1B,IAAI,MAAM,IAAI,YAAY,EAAE,EAC5B,KAAK,IAAI;AACZ,iBAAW,KAAK,YAAY,YAAY,GAAG;AAC3C,aAAO,KAAK,GAAG,QAAQ,WAAW;AAAA,IACpC;AAEA,QACE,oBAAoB,YAAY,QAAQ,aAAa,IAAI,UAAU,EAAE,GACrE;AACA;AAAA,IACF;AAEA,UAAM,EAAE,KAAA,IAAS,MAAM,GAAG;AAAA,MACxB,sCAAsC,WAAW,KAAK,OAAO,CAAC;AAAA,MAC9D,GAAG;AAAA,IAAA;AAGL,WAAO,KAAK;AAAA,MAAI,CAAC,QACf,SAAS,QAAQ,GAA8B;AAAA,IAAA;AAAA,EAEnD;AAAA;AAAA;AAAA;AAAA,EAKA,aAAa,cACX,IACA,QACiB;AACjB,UAAM,SAAS,MAAM,GAAG;AAAA,oEACwC,MAAM;AAAA;AAEtE,WAAQ,QAA8B,SAAS;AAAA,EACjD;AAAA;AAAA;AAAA;AAAA,EAKA,aAAa,OAAO,IAAuB,IAA2B;AACpE,UAAM,GAAG,MAAM,4CAA4C,EAAE;AAAA,EAC/D;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,aAAa,QACX,IACA,UAAkC,CAAA,GAClC,aACgC;AAChC,UAAM,SAAgC;AAAA,MACpC,kBAAkB;AAAA,MAClB,eAAe;AAAA,IAAA;AAGjB,QAAI,QAAQ,wBAAwB;AAClC,YAAM,6BAAa,KAAA;AACnB,aAAO,QAAQ,OAAO,QAAA,IAAY,QAAQ,sBAAsB;AAEhE,YAAM,aAAuB;AAAA,QAC3B;AAAA,QACA;AAAA,MAAA;AAEF,YAAM,SAAoB,CAAC,OAAO,aAAa;AAC/C,0BAAoB,YAAY,QAAQ,aAAa,IAAI;AAEzD,YAAM,EAAE,SAAA,IAAa,MAAM,GAAG;AAAA,QAC5B,oCAAoC,WAAW,KAAK,OAAO,CAAC;AAAA,QAC5D,GAAG;AAAA,MAAA;AAEL,aAAO,mBAAmB,YAAY;AAAA,IACxC;AAEA,QAAI,QAAQ,qBAAqB;AAC/B,YAAM,6BAAa,KAAA;AACnB,aAAO,QAAQ,OAAO,QAAA,IAAY,QAAQ,mBAAmB;AAE7D,YAAM,aAAuB,CAAC,qBAAqB,iBAAiB;AACpE,YAAM,SAAoB,CAAC,OAAO,aAAa;AAC/C,0BAAoB,YAAY,QAAQ,aAAa,IAAI;AAEzD,YAAM,EAAE,SAAA,IAAa,MAAM,GAAG;AAAA,QAC5B,oCAAoC,WAAW,KAAK,OAAO,CAAC;AAAA,QAC5D,GAAG;AAAA,MAAA;AAEL,aAAO,gBAAgB,YAAY;AAAA,IACrC;AAEA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,aAAa,YAAY,IAAyC;AAChE,QAAI;AACF,YAAM,GAAG,MAAM,sCAAsC;AACrD,aAAO;AAAA,IACT,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF;AACF;"}

package/dist/dispatch/index.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Dispatch Module - Inter-Agent Communication
+ *
+ * Provides the DispatchBus for asynchronous agent-to-agent messaging.
+ *
+ * ## Delivery modes
+ *
+ * - **compete** (default): At-most-once delivery. First subscriber to process
+ *   claims the dispatch. Other subscribers won't see it.
+ * - **fanout**: Each subscriber gets their own copy of the dispatch and
+ *   processes independently.
+ *
+ * @example
+ * ```typescript
+ * import { createDispatchBus } from '@happyvertical/smrt-core';
+ *
+ * const bus = await createDispatchBus({ db: { type: 'sqlite', url: 'app.db' } });
+ *
+ * // Emit a dispatch
+ * await bus.emit('campaign.completed', { campaignId: '123' }, { source: 'suasor' });
+ *
+ * // Subscribe with compete delivery (default — first-to-claim)
+ * await bus.subscribe({ signalType: 'campaign.*', subscriber: 'fiscus' });
+ *
+ * // Subscribe with fan-out delivery (each subscriber gets own copy)
+ * await bus.subscribe({
+ *   signalType: 'campaign.*',
+ *   subscriber: 'auditor',
+ *   delivery: 'fanout',
+ * });
+ *
+ * // Process pending dispatches
+ * await bus.process('fiscus', async (payload, metadata) => {
+ *   console.log(`Processing ${metadata.type} from ${metadata.source}`);
+ * });
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { createDispatchBus, DispatchBus } from './bus.js';
+export { DispatchCollection } from './collections/Dispatches.js';
+export { DispatchSubscriptionCollection } from './collections/DispatchSubscriptions.js';
+export { Dispatch, type DispatchData } from './models/Dispatch.js';
+export { DispatchSubscription, type DispatchSubscriptionData, } from './models/DispatchSubscription.js';
+export { type DispatchTenantResolver, type DispatchTenantScope, resolveDispatchTenantId, resolveDispatchTenantScope, setDispatchTenantResolver, } from './tenant-resolver.js';
+export type { DispatchBusOptions, DispatchCleanupOptions, DispatchCleanupResult, DispatchEmitOptions, DispatchHandler, DispatchListOptions, DispatchMetadata, DispatchProcessOptions, DispatchRetryOptions, DispatchStatus, DispatchSubscribeOptions, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/dispatch/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAGH,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,8BAA8B,EAAE,MAAM,wCAAwC,CAAC;AAExF,OAAO,EAAE,QAAQ,EAAE,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EACL,oBAAoB,EACpB,KAAK,wBAAwB,GAC9B,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EACL,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACxB,uBAAuB,EACvB,0BAA0B,EAC1B,yBAAyB,GAC1B,MAAM,sBAAsB,CAAC;AAG9B,YAAY,EACV,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,EACrB,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,sBAAsB,EACtB,oBAAoB,EACpB,cAAc,EACd,wBAAwB,GACzB,MAAM,YAAY,CAAC"}

package/dist/dispatch/models/Dispatch.d.ts

@@ -0,0 +1,101 @@
+import { DispatchMetadata, DispatchStatus } from '../types.js';
+/**
+ * Raw dispatch data as stored in the database
+ */
+export interface DispatchData {
+    id: string;
+    type: string;
+    source: string;
+    source_id: string | null;
+    payload: string | null;
+    status: DispatchStatus;
+    attempts: number;
+    last_error: string | null;
+    processed_at: string | null;
+    processed_by: string | null;
+    target_subscriber: string | null;
+    correlation_id: string | null;
+    tenant_id: string | null;
+    metadata: string | null;
+    created_at: string;
+    updated_at: string;
+}
+/**
+ * Dispatch model for inter-agent communication
+ */
+export declare class Dispatch {
+    /** Table name for this model */
+    static readonly tableName = "_smrt_dispatch";
+    /** Unique identifier */
+    id: string;
+    /** Signal type (e.g., 'campaign.completed') */
+    type: string;
+    /** Emitting agent name */
+    source: string;
+    /** Emitting agent instance ID */
+    sourceId: string;
+    /** Dispatch payload */
+    payload: Record<string, unknown>;
+    /** Current status */
+    status: DispatchStatus;
+    /** Number of processing attempts */
+    attempts: number;
+    /** Last error message if failed */
+    lastError: string;
+    /** When the dispatch was processed */
+    processedAt: Date | null;
+    /** Which subscriber processed it */
+    processedBy: string;
+    /** Target subscriber for fan-out delivery (null for compete mode) */
+    targetSubscriber: string | null;
+    /** Correlation ID for linking request/response dispatch pairs */
+    correlationId: string;
+    /**
+     * Tenant the dispatch was emitted in (server-derived, untrusted-input-proof).
+     *
+     * Stamped from the active tenant context at emit time — never from caller
+     * options — so it cannot be spoofed. `null` for global / non-tenant
+     * dispatches. Used to isolate reads/claims across tenants (S5 #1398).
+     */
+    tenantId: string | null;
+    /** Additional metadata */
+    metadata: Record<string, unknown>;
+    /** Creation timestamp */
+    createdAt: Date;
+    /** Last update timestamp */
+    updatedAt: Date;
+    constructor(data?: Partial<DispatchData>);
+    /**
+     * Create a Dispatch from a database row
+     */
+    static fromRow(row: DispatchData): Dispatch;
+    /**
+     * Convert to database row format
+     */
+    toRow(): DispatchData;
+    /**
+     * Get dispatch metadata for handlers
+     */
+    getMetadata(): DispatchMetadata;
+    /**
+     * Mark as processing
+     */
+    markProcessing(): void;
+    /**
+     * Mark as completed
+     */
+    markCompleted(processedBy: string): void;
+    /**
+     * Mark as failed
+     */
+    markFailed(error: string): void;
+    /**
+     * Reset to pending for retry
+     */
+    resetForRetry(): void;
+    /**
+     * Check if this dispatch can be retried
+     */
+    canRetry(maxAttempts: number): boolean;
+}
+//# sourceMappingURL=Dispatch.d.ts.map

package/dist/dispatch/models/Dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Dispatch.d.ts","sourceRoot":"","sources":["../../../src/dispatch/models/Dispatch.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAgCpE;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,cAAc,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,QAAQ;IACnB,gCAAgC;IAChC,MAAM,CAAC,QAAQ,CAAC,SAAS,oBAAoB;IAE7C,wBAAwB;IACxB,EAAE,EAAE,MAAM,CAAC;IAEX,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IAEb,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAC;IAEf,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;IAEjB,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEjC,qBAAqB;IACrB,MAAM,EAAE,cAAc,CAAC;IAEvB,oCAAoC;IACpC,QAAQ,EAAE,MAAM,CAAC;IAEjB,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAElB,sCAAsC;IACtC,WAAW,EAAE,IAAI,GAAG,IAAI,CAAC;IAEzB,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAC;IAEpB,qEAAqE;IACrE,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAEhC,iEAAiE;IACjE,aAAa,EAAE,MAAM,CAAC;IAEtB;;;;;;OAMG;IACH,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAElC,yBAAyB;IACzB,SAAS,EAAE,IAAI,CAAC;IAEhB,4BAA4B;IAC5B,SAAS,EAAE,IAAI,CAAC;gBAEJ,IAAI,GAAE,OAAO,CAAC,YAAY,CAAM;IA0B5C;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,YAAY,GAAG,QAAQ;IAI3C;;OAEG;IACH,KAAK,IAAI,YAAY;IAqBrB;;OAEG;IACH,WAAW,IAAI,gBAAgB;IAa/B;;OAEG;IACH,cAAc,IAAI,IAAI;IAMtB;;OAEG;IACH,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAQxC;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAM/B;;OAEG;IACH,aAAa,IAAI,IAAI;IAKrB;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;CAGvC"}