@sixb/pg 0.1.0 → 0.1.2

package/src/run-list-query.ts

@@ -12,7 +12,10 @@ type PgRunListTable =
 
 /** Column projection — `sync_runs` needs the derived `checkpoint_present` flag. */
 type PgRunListSelectList = "*" | "*, checkpoint IS NOT NULL AS checkpoint_present"
-type StartedAtExpression = "started_at" | "COALESCE(started_at, created_at)"
+type StartedAtExpression =
+  | "started_at"
+  | "COALESCE(started_at, created_at)"
+  | "COALESCE(started_at, queued_at)"
 
 export function hasEmptyStatuses(input: { readonly statuses?: readonly unknown[] }): boolean {
   return input.statuses !== undefined && input.statuses.length === 0
@@ -78,9 +81,11 @@ export async function queryRunList<TRow>(input: {
   const orderColumn =
     input.tableName === "agent_runs"
       ? "COALESCE(started_at, created_at)"
-      : input.tableName === "workflow_agent_node_runs"
-        ? "created_at"
-        : "started_at"
+      : input.tableName === "sync_runs" || input.tableName === "pipeline_runs"
+        ? "COALESCE(started_at, queued_at)"
+        : input.tableName === "workflow_agent_node_runs"
+          ? "created_at"
+          : "started_at"
   const idColumn = input.tableName === "workflow_agent_node_runs" ? "node_run_id" : "id"
   let query = `
     SELECT ${input.selectList ?? "*"} FROM ${input.tableName}

package/src/testing.ts

@@ -0,0 +1,18 @@
+export interface PostgresStorageTestingAdapter {
+  advanceConnectorConnectionTime(durationMs: number): void
+}
+
+const adapters = new WeakMap<object, PostgresStorageTestingAdapter>()
+
+export function registerPostgresStorageTestingAdapter(
+  storage: object,
+  advanceConnectorConnectionTime: (durationMs: number) => void
+): void {
+  adapters.set(storage, { advanceConnectorConnectionTime })
+}
+
+export function getPostgresStorageTestingAdapter(storage: object): PostgresStorageTestingAdapter {
+  const adapter = adapters.get(storage)
+  if (!adapter) throw new Error("[SixbPg] Storage testing adapter is unavailable.")
+  return adapter
+}

package/dist/pg-webhook-delivery-storage.d.ts

@@ -1,17 +0,0 @@
-import type { WebhookDeliveryClaimRecord, WebhookDeliveryKey, WebhookDeliveryRecord, WebhookDeliveryStorage } from "@sixb/core/storage";
-import { type PgStoreClient } from "./transactions";
-export declare class PgWebhookDeliveryStorage implements WebhookDeliveryStorage {
-    private readonly sql;
-    constructor(sql: PgStoreClient);
-    claim(input: WebhookDeliveryKey & {
-        receivedAt: string;
-    }): Promise<WebhookDeliveryClaimRecord>;
-    complete(input: WebhookDeliveryKey & {
-        completedAt: string;
-    }): Promise<WebhookDeliveryRecord>;
-    fail(input: WebhookDeliveryKey & {
-        failedAt: string;
-        error: string;
-    }): Promise<WebhookDeliveryRecord>;
-}
-//# sourceMappingURL=pg-webhook-delivery-storage.d.ts.map

package/dist/pg-webhook-delivery-storage.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"pg-webhook-delivery-storage.d.ts","sourceRoot":"","sources":["../src/pg-webhook-delivery-storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,0BAA0B,EAE1B,kBAAkB,EAClB,qBAAqB,EACrB,sBAAsB,EACvB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,KAAK,aAAa,EAAoB,MAAM,gBAAgB,CAAA;AAErE,qBAAa,wBAAyB,YAAW,sBAAsB;IACzD,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,aAAa;IAEzC,KAAK,CACT,KAAK,EAAE,kBAAkB,GAAG;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,GACjD,OAAO,CAAC,0BAA0B,CAAC;IAyEhC,QAAQ,CACZ,KAAK,EAAE,kBAAkB,GAAG;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,GAClD,OAAO,CAAC,qBAAqB,CAAC;IAuB3B,IAAI,CACR,KAAK,EAAE,kBAAkB,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAC9D,OAAO,CAAC,qBAAqB,CAAC;CAqBlC"}

package/src/pg-webhook-delivery-storage.ts

@@ -1,180 +0,0 @@
-import type {
-  WebhookDeliveryClaimRecord,
-  WebhookDeliveryClaimResult,
-  WebhookDeliveryKey,
-  WebhookDeliveryRecord,
-  WebhookDeliveryStorage,
-} from "@sixb/core/storage"
-import { type PgStoreClient, runPgTransaction } from "./transactions"
-
-export class PgWebhookDeliveryStorage implements WebhookDeliveryStorage {
-  constructor(private readonly sql: PgStoreClient) {}
-
-  async claim(
-    input: WebhookDeliveryKey & { receivedAt: string }
-  ): Promise<WebhookDeliveryClaimRecord> {
-    return runPgTransaction(this.sql, async (tx) => {
-      // Atomic first claim: only one transaction can insert this scoped delivery key.
-      const [inserted] = await tx<WebhookDeliveryRow[]>`
-        INSERT INTO webhook_deliveries (
-          project_id,
-          connector_id,
-          webhook_id,
-          idempotency_key,
-          status,
-          received_at
-        ) VALUES (
-          ${input.projectId},
-          ${input.connectorId},
-          ${input.webhookId},
-          ${input.idempotencyKey},
-          ${"in_progress"},
-          ${input.receivedAt}
-        )
-        ON CONFLICT (project_id, connector_id, webhook_id, idempotency_key) DO NOTHING
-        RETURNING *
-      `
-
-      if (inserted) {
-        return toWebhookDeliveryClaimRecord(inserted, "claimed")
-      }
-
-      const [existing] = await tx<WebhookDeliveryRow[]>`
-        SELECT * FROM webhook_deliveries
-        WHERE project_id = ${input.projectId}
-          AND connector_id = ${input.connectorId}
-          AND webhook_id = ${input.webhookId}
-          AND idempotency_key = ${input.idempotencyKey}
-        FOR UPDATE
-      `
-
-      if (existing?.status === "completed") {
-        return toWebhookDeliveryClaimRecord(existing, "duplicate")
-      }
-
-      if (existing?.status === "in_progress") {
-        return toWebhookDeliveryClaimRecord(existing, "in_progress")
-      }
-
-      if (existing?.status !== "failed") {
-        throw new Error("[SixbPg] Webhook delivery row disappeared during claim.")
-      }
-
-      // Failed deliveries are intentionally claimable so provider retries can run again.
-      const [updated] = await tx<WebhookDeliveryRow[]>`
-        UPDATE webhook_deliveries
-        SET status = ${"in_progress"},
-            received_at = ${input.receivedAt},
-            completed_at = ${null},
-            failed_at = ${null},
-            error = ${null}
-        WHERE project_id = ${input.projectId}
-          AND connector_id = ${input.connectorId}
-          AND webhook_id = ${input.webhookId}
-          AND idempotency_key = ${input.idempotencyKey}
-        RETURNING *
-      `
-
-      if (!updated) {
-        throw new Error(
-          `[SixbPg] Missing webhook delivery row after claim for ${serializeKey(input)}.`
-        )
-      }
-
-      return toWebhookDeliveryClaimRecord(updated, "claimed")
-    })
-  }
-
-  async complete(
-    input: WebhookDeliveryKey & { completedAt: string }
-  ): Promise<WebhookDeliveryRecord> {
-    const [updated] = await this.sql<WebhookDeliveryRow[]>`
-      UPDATE webhook_deliveries
-      SET status = ${"completed"},
-          completed_at = ${input.completedAt},
-          failed_at = ${null},
-          error = ${null}
-      WHERE project_id = ${input.projectId}
-        AND connector_id = ${input.connectorId}
-        AND webhook_id = ${input.webhookId}
-        AND idempotency_key = ${input.idempotencyKey}
-      RETURNING *
-    `
-
-    if (!updated) {
-      throw new Error(
-        `[SixbPg] Missing webhook delivery row after complete for ${serializeKey(input)}.`
-      )
-    }
-
-    return toWebhookDeliveryRecord(updated)
-  }
-
-  async fail(
-    input: WebhookDeliveryKey & { failedAt: string; error: string }
-  ): Promise<WebhookDeliveryRecord> {
-    const [updated] = await this.sql<WebhookDeliveryRow[]>`
-      UPDATE webhook_deliveries
-      SET status = ${"failed"},
-          failed_at = ${input.failedAt},
-          error = ${input.error}
-      WHERE project_id = ${input.projectId}
-        AND connector_id = ${input.connectorId}
-        AND webhook_id = ${input.webhookId}
-        AND idempotency_key = ${input.idempotencyKey}
-      RETURNING *
-    `
-
-    if (!updated) {
-      throw new Error(
-        `[SixbPg] Missing webhook delivery row after fail for ${serializeKey(input)}.`
-      )
-    }
-
-    return toWebhookDeliveryRecord(updated)
-  }
-}
-
-function toWebhookDeliveryClaimRecord(
-  row: WebhookDeliveryRow,
-  claimResult: WebhookDeliveryClaimResult
-): WebhookDeliveryClaimRecord {
-  return {
-    ...toWebhookDeliveryRecord(row),
-    claimResult,
-  }
-}
-
-function toWebhookDeliveryRecord(row: WebhookDeliveryRow): WebhookDeliveryRecord {
-  return {
-    projectId: row.project_id,
-    connectorId: row.connector_id,
-    webhookId: row.webhook_id,
-    idempotencyKey: row.idempotency_key,
-    status: row.status,
-    receivedAt: toIsoString(row.received_at),
-    completedAt: row.completed_at ? toIsoString(row.completed_at) : undefined,
-    failedAt: row.failed_at ? toIsoString(row.failed_at) : undefined,
-    error: row.error ?? undefined,
-  }
-}
-
-function toIsoString(value: Date | string): string {
-  return value instanceof Date ? value.toISOString() : new Date(value).toISOString()
-}
-
-function serializeKey(key: WebhookDeliveryKey): string {
-  return JSON.stringify([key.projectId, key.connectorId, key.webhookId, key.idempotencyKey])
-}
-
-interface WebhookDeliveryRow {
-  readonly project_id: string
-  readonly connector_id: string
-  readonly webhook_id: string
-  readonly idempotency_key: string
-  readonly status: WebhookDeliveryRecord["status"]
-  readonly received_at: Date | string
-  readonly completed_at: Date | string | null
-  readonly failed_at: Date | string | null
-  readonly error: string | null
-}