@byok-sdk/cloud-dataplane 0.4.0 → 0.4.2

package/dist/sql/0007_approval_timeline.sql

@@ -0,0 +1,13 @@
+-- Bounded, lossy approval lifecycle observations for host-side projection.
+-- This is deliberately separate from activity_tail: approval envelopes have
+-- no authoritative order key shared with task.progress batches.
+CREATE TABLE approval_timeline_tail (
+  tenant_id     text    NOT NULL,
+  task_id       text    NOT NULL,
+  entries       jsonb   NOT NULL,
+  next_revision bigint  NOT NULL,
+  dropped       integer NOT NULL,
+  capacity      integer NOT NULL,
+  expires_at    text    NOT NULL,
+  PRIMARY KEY (tenant_id, task_id)
+);

package/dist/stores/activity.d.ts

@@ -0,0 +1,10 @@
+import { type ActivityAppendInput, type ActivityStore, type ActivityTail } from '@byok-sdk/cloud';
+import type { Clock, TenantId } from '@byok-sdk/core';
+import type { Pool } from 'pg';
+export declare class PostgresActivityStore implements ActivityStore {
+    private readonly pool;
+    private readonly clock;
+    constructor(pool: Pool, clock: Clock);
+    append(tenant: TenantId, input: ActivityAppendInput): Promise<ActivityTail>;
+    read(tenant: TenantId, taskId: string): Promise<ActivityTail | undefined>;
+}

package/dist/stores/approval-timeline.d.ts

@@ -0,0 +1,10 @@
+import { type ApprovalTimelineAppendInput, type ApprovalTimelineStore, type ApprovalTimelineTail } from '@byok-sdk/cloud';
+import type { Clock, TenantId } from '@byok-sdk/core';
+import type { Pool } from 'pg';
+export declare class PostgresApprovalTimelineStore implements ApprovalTimelineStore {
+    private readonly pool;
+    private readonly clock;
+    constructor(pool: Pool, clock: Clock);
+    append(tenant: TenantId, input: ApprovalTimelineAppendInput): Promise<ApprovalTimelineTail>;
+    read(tenant: TenantId, taskId: string): Promise<ApprovalTimelineTail | undefined>;
+}

package/dist/stores/core/index.d.ts

@@ -1,17 +1,17 @@
 /**
- * The Postgres composition of the eight `@byok-sdk/core` ports.
+ * The Postgres composition of the seven `@byok-sdk/core` ports.
  *
- * All eight, or none: `runCoreConformance`'s port-inventory dimension asserts a
+ * All seven, or none: `runCoreConformance`'s port-inventory dimension asserts a
  * composition supplies exactly `CORE_STORE_NAMES` and exactly the methods
  * `CORE_PORT_METHODS` declares, so there is no such thing as a partial core
  * composition to certify. The original seven landed in one slice (design §11);
- * `skillPacks` is the eighth, added in Phase 2 of `skill-pack-delivery-channel`
+ * `skillPacks` joined in Phase 2 of `skill-pack-delivery-channel`
  * when it graduated from a bridge port to a mandatory `CoreStores` member. This
  * function returns a full `CoreStores` where the cloud-local sibling returns a
  * named subset.
  *
  * Everything that reads time reads the injected clock. Nothing calls SQL
- * `now()` — presence expiry, activity expiry and reservation expiry are all
+ * `now()` — presence expiry and reservation expiry are both
  * contract behavior the suite asserts by moving a test clock, and a store that
  * asked the database for the time would make every one of those assertions
  * either a sleep or a flake.
@@ -21,7 +21,7 @@ import type { Pool } from 'pg';
 export { PostgresMailboxStore } from './mailbox';
 export { PostgresBoardStore } from './board';
 export { PostgresTruthStore } from './truth';
-export { PostgresPresenceStore, PostgresActivityStore } from './presence';
+export { PostgresPresenceStore } from './presence';
 export { PostgresObjectStore } from './objects';
 export { PostgresQuotaStore } from './quota';
 export { PostgresSkillPackStore } from './skill-pack';

package/dist/stores/core/presence.d.ts

@@ -1,8 +1,8 @@
 /**
- * Postgres {@link PresenceStore} and {@link ActivityStore} (§12.3).
+ * Postgres {@link PresenceStore} (§12.3).
  *
- * Both are lossy, TTL-bounded, unsigned, and never authoritative, and both are
- * bounded upserts: one row per device, one row per task. Nothing here may be
+ * Presence is lossy, TTL-bounded, unsigned, and never authoritative. It is a
+ * bounded upsert with one row per device. Nothing here may be
  * used to derive coordination state, execution state, authorization, billing or
  * recovery — which is why this file shares no vocabulary with `board.ts` and
  * none with the frozen wire states.
@@ -17,7 +17,7 @@
  * clock means sleeping or accepting flakes, which is why the port takes `ttlMs`
  * and the composition supplies the clock.
  */
-import { type ActivityAppendInput, type ActivityStore, type ActivityTail, type Clock, type PresenceHint, type PresenceHintInput, type PresenceStore, type TenantId } from '@byok-sdk/core';
+import { type Clock, type PresenceHint, type PresenceHintInput, type PresenceStore, type TenantId } from '@byok-sdk/core';
 import type { Pool } from 'pg';
 export declare class PostgresPresenceStore implements PresenceStore {
     #private;
@@ -26,9 +26,3 @@ export declare class PostgresPresenceStore implements PresenceStore {
     read(tenant: TenantId, deviceId: string): Promise<PresenceHint | undefined>;
     list(tenant: TenantId): Promise<readonly PresenceHint[]>;
 }
-export declare class PostgresActivityStore implements ActivityStore {
-    #private;
-    constructor(pool: Pool, clock: Clock);
-    append(tenant: TenantId, input: ActivityAppendInput): Promise<ActivityTail>;
-    read(tenant: TenantId, taskId: string): Promise<ActivityTail | undefined>;
-}

package/dist/stores/index.d.ts

@@ -1,10 +1,12 @@
 /**
  * The Postgres composition of the cloud-local ports.
  *
- * Seven durable stores, one object-storage blob store, one in-memory limiter:
+ * Nine durable stores, one object-storage blob store, one in-memory limiter:
  *
  * - Six durable ones have rows in `deploy/sql/0001_cloud_local.sql`; S6's
- *   proof receipt authority is the seventh, in `0004_device_proof_truth.sql`.
+ *   proof receipt authority is the seventh, in `0004_device_proof_truth.sql`;
+ *   typed activity uses the JSONB tail row in `0002_core_domain.sql`; approval
+ *   lifecycle observations use `0007_approval_timeline.sql`.
  * - `blobs` is the R2 adapter over the `object_manifest` row the core store
  *   already owns: metadata in Postgres, bytes in the object store, one
  *   reserve/verify protocol binding them (design §6). It supplies grants only,
@@ -29,10 +31,12 @@ export { PostgresPairingCodeStore } from './pairing-codes';
 export { PostgresRequestReceiptStore } from './receipts';
 export { PostgresProofRequestReceiptStore } from './proof-receipts';
 export { PostgresTaskAttemptStore } from './task-attempts';
+export { PostgresActivityStore } from './activity';
+export { PostgresApprovalTimelineStore } from './approval-timeline';
 export { DEFAULT_MAX_ATTEMPTS, DEFAULT_PRESIGN_TTL_SECONDS, DEFAULT_RETRY_DELAY_MS, MAX_PRESIGN_TTL_SECONDS, MIN_PRESIGN_TTL_SECONDS, ObjectStoreRequestError, R2_BLOB_ERROR_CODES, R2BlobStoreError, R2CloudBlobStore, R2ObjectMaintenanceStore, } from './r2-blobs';
 export type { ObjectStoreFetch, R2BlobErrorCode, R2BlobStoreOptions } from './r2-blobs';
 export type { R2DeleteResult, R2ListedObject, R2ObjectMaintenance, R2ObjectMaintenanceOptions, R2ObjectPage, } from './r2-blobs';
-/** Every cloud-local port. All nine, or it is not a composition. */
+/** Every cloud-local port. All eleven, or it is not a composition. */
 export type PostgresCloudStores = CloudStores;
 /** Everything the blob store needs that is not already a composition-wide input. */
 export type PostgresObjectStorageOptions = Omit<R2BlobStoreOptions, 'objects'>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@byok-sdk/cloud-dataplane",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "BYOK SDK hosted data plane: canonical Postgres + R2 stores, migrations, truth transactions, and maintenance",
   "type": "module",
   "license": "MIT",
@@ -14,7 +14,7 @@
   },
   "homepage": "https://github.com/Ancienttwo/byok-sdk#readme",
   "engines": {
-    "node": ">=22.19.0"
+    "node": ">=22.22.0"
   },
   "sideEffects": false,
   "main": "./dist/index.js",
@@ -25,6 +25,10 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
+    "./runtime": {
+      "types": "./dist/runtime.d.ts",
+      "import": "./dist/runtime.js"
+    },
     "./package.json": "./package.json"
   },
   "files": [
@@ -35,25 +39,27 @@
   "publishConfig": {
     "access": "public"
   },
-  "dependencies": {
-    "aws4fetch": "1.0.20",
-    "fast-xml-parser": "^5.10.1",
-    "pg": "^8.22.0",
-    "@byok-sdk/cloud": "0.4.0",
-    "@byok-sdk/protocol": "0.4.0",
-    "@byok-sdk/core": "0.4.0"
-  },
-  "devDependencies": {
-    "@types/pg": "^8.20.4",
-    "undici": "8.9.0",
-    "@byok-sdk/conformance": "0.0.0"
-  },
   "scripts": {
     "build": "tsup && tsc -p tsconfig.build.json && node scripts/copy-migrations.mjs",
     "dev": "tsup --watch",
     "test": "vitest run",
     "test:watch": "vitest",
+    "test:worker": "vitest run src/__tests__/runtime-entry.test.ts src/__tests__/worker-packaging.test.ts",
     "typecheck": "tsc --noEmit",
     "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@byok-sdk/cloud": "0.4.2",
+    "@byok-sdk/core": "0.4.2",
+    "@byok-sdk/protocol": "0.4.2",
+    "aws4fetch": "1.0.20",
+    "fast-xml-parser": "^5.10.1",
+    "pg": "^8.22.0"
+  },
+  "devDependencies": {
+    "@byok-sdk/conformance": "0.0.0",
+    "@types/pg": "^8.20.4",
+    "undici": "8.9.0",
+    "wrangler": "4.123.0"
   }
-}
+}