@stackbone/cli 0.1.0-alpha.13 → 0.1.0-alpha.15

package/migrations/0021_trigger_subscriptions.sql

@@ -0,0 +1,67 @@
+-- 0021_trigger_subscriptions.sql — the inbound side of Stackbone Connect
+-- (feature 89): an operator links a connector polling TRIGGER to a World
+-- workflow, and a polling intake engine starts that workflow for each new item.
+--
+-- This is the emulator's OWN inbound state — deliberately NOT the classic
+-- `automation*` tables (which live in cloud and feed the deprecated `/invoke`
+-- pipeline). The model mirrors that pipeline's SHAPE (config + cursor state +
+-- a delivery journal) without coupling to it: the classic engine stays running
+-- and untouched; its retirement is tied to the World runtime's port to prod.
+--
+-- `trigger_subscriptions` holds the operator-owned link plus its polling state
+-- (the opaque cursor + last-poll marker, owned by the platform; the
+-- remote-subscription id is reserved for a future webhook/push source).
+-- `trigger_deliveries` is the at-least-once dedup journal: one row per
+-- (subscription, provider item) so two overlapping ticks or a mid-restart
+-- re-poll never start the same item's workflow twice.
+
+CREATE TABLE IF NOT EXISTS stackbone_platform.trigger_subscriptions (
+    id                     uuid        PRIMARY KEY,
+    -- Integration id — the SAME id resolves the credential (broker) and the
+    -- trigger capability (connector kit). e.g. 'gmail'.
+    connector              text        NOT NULL,
+    -- Capability trigger id, e.g. 'message-received'. Not the reserved word
+    -- `trigger`, so the column is `trigger_id`.
+    trigger_id             text        NOT NULL,
+    -- Which broker grant to poll with: 'app' | 'user:<issuer>:<id>'.
+    principal_key          text        NOT NULL,
+    -- The World workflow this link starts.
+    workflow_name          text        NOT NULL,
+    -- Optional JSONata event→input mapping; identity when null.
+    mapping                text,
+    enabled                boolean     NOT NULL DEFAULT true,
+    -- Opaque polling cursor (Gmail historyId, etc), platform-owned. Advanced
+    -- atomically at the END of a tick.
+    poll_cursor            jsonb,
+    -- Reserved for a future push source (a provider-side subscription id); the
+    -- polling path never reads it.
+    remote_subscription_id text,
+    last_polled_at         timestamptz,
+    created_at             timestamptz NOT NULL DEFAULT now(),
+    updated_at             timestamptz NOT NULL DEFAULT now()
+);
+
+-- The reconcile sweep loads ACTIVE links to arm one repeatable each.
+CREATE INDEX IF NOT EXISTS trigger_subscriptions_enabled_idx
+    ON stackbone_platform.trigger_subscriptions (enabled, created_at)
+    WHERE enabled;
+
+CREATE TABLE IF NOT EXISTS stackbone_platform.trigger_deliveries (
+    id               uuid        PRIMARY KEY,
+    subscription_id  uuid        NOT NULL,
+    -- The connector's stable provider item id (Gmail messageId) — the dedup key.
+    provider_item_id text        NOT NULL,
+    status           text        NOT NULL DEFAULT 'claimed'
+                                 CHECK (status IN ('claimed', 'started', 'rejected')),
+    -- The projected World run id once the workflow started.
+    run_id           text,
+    -- Validation/mapping issues when the delivery was rejected.
+    issues           jsonb,
+    created_at       timestamptz NOT NULL DEFAULT now(),
+    updated_at       timestamptz NOT NULL DEFAULT now()
+);
+
+-- The at-least-once dedup guarantee: claiming a delivery is an INSERT that
+-- collapses on this unique pair, so a re-polled item is a no-op, not a re-run.
+CREATE UNIQUE INDEX IF NOT EXISTS trigger_deliveries_dedup_idx
+    ON stackbone_platform.trigger_deliveries (subscription_id, provider_item_id);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stackbone/cli",
-  "version": "0.1.0-alpha.13",
+  "version": "0.1.0-alpha.15",
   "license": "UNLICENSED",
   "type": "module",
   "bin": {