@withpotter/lib 0.13.0-next.101

package/dist/connect/catalog.js

@@ -0,0 +1,268 @@
+const CONNECT_PRODUCTS = [
+  {
+    id: "email-delivery",
+    name: "Email delivery",
+    plane: "messaging",
+    shape: "delivery",
+    availability: "fixture_certified",
+    outcome: "Send receipts, confirmations and operational mail from your own domain, and see what reached the customer.",
+    requires: "A domain you can add DNS records to.",
+    permissions: [
+      "Send email as your verified sending domain",
+      "Record delivery, bounce and complaint receipts",
+      "Hold opt-outs and suppressions for your business"
+    ],
+    limits: ["Box does not read replies to your customers."]
+  },
+  {
+    id: "whatsapp-delivery",
+    name: "WhatsApp messaging",
+    brand: "WhatsApp",
+    plane: "messaging",
+    shape: "delivery",
+    availability: "fixture_certified",
+    outcome: "Send approved WhatsApp templates to customers and take structured replies back into Box.",
+    requires: "A WhatsApp business number Box can be authorised on.",
+    permissions: [
+      "Send approved template messages from your number",
+      "Receive delivery receipts and customer replies",
+      "Apply your consent and frequency rules before sending"
+    ]
+  },
+  {
+    id: "sms-delivery",
+    name: "SMS delivery",
+    plane: "messaging",
+    shape: "delivery",
+    availability: "fixture_certified",
+    outcome: "Reach customers who are not on WhatsApp, on the same consent and evidence rules.",
+    requires: "An approved sender ID in each market you send to.",
+    permissions: [
+      "Send SMS from your registered sender ID",
+      "Record carrier delivery receipts"
+    ]
+  },
+  {
+    id: "quickbooks-accounting",
+    name: "QuickBooks accounting sync",
+    brand: "QuickBooks",
+    plane: "integrations",
+    shape: "sync",
+    availability: "defined",
+    outcome: "Send approved customers and invoices to your books, and keep paid status in step without re-keying anything.",
+    requires: "A QuickBooks company you administer.",
+    permissions: [
+      "Create and update customers and invoices in one company",
+      "Read invoice and payment status back"
+    ],
+    limits: ["Box never starts, captures or refunds a payment in QuickBooks."]
+  },
+  {
+    id: "calendar-sync",
+    name: "Calendar booking sync",
+    brand: "Google Calendar",
+    plane: "integrations",
+    shape: "sync",
+    availability: "defined",
+    outcome: "Keep bookings and the calendar your team actually watches in step, both ways, without duplicate events.",
+    requires: "A calendar you own on Google or Microsoft 365.",
+    permissions: [
+      "Read and write events on the calendars you pick",
+      "Subscribe to changes so a move on either side is noticed"
+    ],
+    limits: ["Calendars you do not select stay invisible to Box."]
+  },
+  {
+    id: "slack-alerts",
+    name: "Slack operational alerts",
+    brand: "Slack",
+    plane: "integrations",
+    shape: "alert",
+    availability: "defined",
+    outcome: "Put the orders, stock warnings and failures your team needs to see into one channel they already read.",
+    requires: "A Slack workspace and a channel to post in.",
+    permissions: ["Post messages to the single channel you choose"],
+    limits: ["Box cannot read your Slack messages or join other channels."]
+  },
+  {
+    id: "governed-automation",
+    name: "Automation bridge",
+    plane: "integrations",
+    shape: "action",
+    availability: "defined",
+    outcome: "React to something happening in Box by doing something in another system, with every step recorded.",
+    requires: "An automation tool your team already runs.",
+    permissions: [
+      "Publish Box events to your automation tool",
+      "Accept typed actions back, under the same policy as everything else"
+    ],
+    limits: [
+      "Your automation tool never receives a provider credential from Box."
+    ]
+  },
+  {
+    /*
+     * THE ERP CONNECTOR, AND WHY IT IS THE ONLY ONE THAT NEEDED NO PERMISSION.
+     *
+     * Every other integration on this list waits on somebody: WhatsApp on
+     * Meta, the social three on developer apps and app review, Glovo on an
+     * account manager. Odoo authenticates a database name, a login and an API
+     * key the merchant makes in their own Odoo, so nothing here is gated on a
+     * queue Box does not control. That is why it arrived two rungs above
+     * three older entries rather than behind them.
+     *
+     * WHY `fixture_certified` AND NOT HIGHER.
+     *
+     * potter-api holds the module: an injected transport, a JSON-RPC client,
+     * both crossings, and 19 tests that drive the whole request-to-parse cycle
+     * against recorded Odoo responses, asserting the outbound envelope rather
+     * than only the parse. The four that matter are decisions rather than
+     * mechanisms: a retry must not raise a second sale order, an order missing
+     * a line must not go over with a wrong total, a cursor must not advance
+     * past records the run never read, and stock must not travel back the way
+     * it came.
+     *
+     * It has met no real Odoo. `sandbox_certified` needs a database, and a
+     * free Odoo Online trial is enough. The day it runs against one, this
+     * comment and the rung move together.
+     */
+    id: "odoo-erp-sync",
+    name: "Odoo order and stock sync",
+    brand: "Odoo",
+    plane: "integrations",
+    shape: "sync",
+    availability: "fixture_certified",
+    outcome: "Sell what your ERP says you have, and let a paid order land in Odoo without anyone typing it twice.",
+    requires: "An Odoo database you administer, and an API key from your own user preferences.",
+    permissions: [
+      "Read products and stock in the companies you choose",
+      "Create customers and sale orders for what you sell in Box",
+      "Read back the companies in your database, so you can pick them"
+    ],
+    limits: [
+      "Box never overwrites a stock count in Odoo. Your ERP owns that number and Box reads it.",
+      "Box never posts a journal entry, changes a tax rule or touches your chart of accounts.",
+      "Only a paid order crosses. Box does not fill your ERP with quotations."
+    ]
+  },
+  /*
+   * THE THREE SOCIAL SOURCES, AND WHY THEY ARE READS AND NOT SHOPS.
+   *
+   * Measured against each provider's own eligibility documentation on
+   * 2026-08-31: Meta's supported-country list for Shops and product tagging
+   * contains no African country at all, TikTok Shop runs in roughly two dozen
+   * markets with nothing in Africa, and YouTube Shopping is fifteen markets
+   * plus Partner Programme membership. Meta CUT its list in 2023.
+   *
+   * Reading, on all three, works anywhere. So these are named for the outcome
+   * a merchant can actually have — seeing what their posts did — rather than
+   * for the one most of the world cannot. Whether a given workspace may also
+   * SELL inside a platform is not baked in here: it comes from
+   * `GET /social-sources`, which asks the adapter about the workspace's own
+   * market rather than assuming. A catalogue entry promising a shop would be
+   * an advert for a door that does not open.
+   *
+   * They sit at `fixture_certified` — passing Box's conformance suite
+   * against test doubles — and the evidence is in potter-api's
+   * `modules/social-sources`: three adapters, an injected transport, and a
+   * suite that drives the whole cycle against recorded responses, request
+   * included. It asserts each provider's own auth spelling (Meta in the query,
+   * TikTok in an `Access-Token` header, YouTube in a bearer header), that a
+   * refusal is raised rather than returned as an empty account, and that
+   * nothing is requested at all without credentials. Proven to bite: moving
+   * TikTok's token into the query fails exactly one test.
+   *
+   * They are NOT `sandbox_certified`. Nothing here has met the providers' own
+   * sandboxes, which needs developer apps registered under Box's accounts
+   * and, for Meta, app review. That is the next rung and this comment moves
+   * with it.
+   */
+  {
+    id: "instagram-insights",
+    name: "Instagram performance",
+    brand: "Instagram",
+    plane: "integrations",
+    shape: "sync",
+    availability: "fixture_certified",
+    outcome: "See what each post actually did, and which ones sent the people who bought.",
+    requires: "An Instagram business or creator account linked to a Facebook Page.",
+    permissions: [
+      "Read reach and engagement on posts you published",
+      "Read your follower count and profile reach",
+      "Ask Meta whether your account may tag products"
+    ],
+    limits: [
+      "Box never posts, replies or sends a message as you.",
+      "Meta discards these numbers after 90 days, so Box keeps what it reads."
+    ]
+  },
+  {
+    id: "tiktok-insights",
+    name: "TikTok performance",
+    brand: "TikTok",
+    plane: "integrations",
+    shape: "sync",
+    availability: "fixture_certified",
+    outcome: "See how each video performed, and which ones turned into orders.",
+    requires: "A TikTok business account you administer.",
+    permissions: [
+      "Read views, reach and engagement on videos you published",
+      "Read your follower count"
+    ],
+    limits: [
+      "Box never posts or comments as you.",
+      "TikTok only lets a business read its own account, so nothing is compared across merchants."
+    ]
+  },
+  {
+    id: "youtube-insights",
+    name: "YouTube performance",
+    brand: "YouTube",
+    plane: "integrations",
+    shape: "sync",
+    availability: "fixture_certified",
+    outcome: "See what each video earned you, from views through to orders.",
+    requires: "A YouTube channel you own.",
+    permissions: [
+      "Read views, likes and comments on your own videos",
+      "Read your subscriber count"
+    ],
+    limits: [
+      "Box never uploads, comments or changes anything on your channel.",
+      "YouTube counts views, not people, so it reports no reach figure at all."
+    ]
+  }
+];
+const REQUESTABLE_FAMILIES = [
+  "Accounting or bookkeeping",
+  "Calendar or scheduling",
+  "Team chat",
+  "Online marketplace",
+  "Advertising",
+  "Shipping or logistics",
+  "CRM or support desk",
+  "Something else"
+];
+function productById(id) {
+  return CONNECT_PRODUCTS.find((p) => p.id === id);
+}
+const RUNG = {
+  generally_available: 0,
+  pilot: 1,
+  sandbox_certified: 2,
+  fixture_certified: 3,
+  implemented: 4,
+  defined: 5,
+  suspended: 6,
+  retired: 7
+};
+function byReadiness(a, b) {
+  return RUNG[a.availability] - RUNG[b.availability] || a.name.localeCompare(b.name);
+}
+export {
+  CONNECT_PRODUCTS,
+  REQUESTABLE_FAMILIES,
+  byReadiness,
+  productById
+};
+//# sourceMappingURL=catalog.js.map

package/dist/connect/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/connect/catalog.ts"],"sourcesContent":["import type { Availability, ConnectProduct } from './types';\n\n/**\n * What Box Connect actually offers, at the rung each thing has reached.\n *\n * ELEVEN ENTRIES, NOT SEVENTY. The rule the Connections page in Settings\n * settled on holds here and holds harder: a catalogue of logos a merchant\n * cannot use is a wall of adverts, and this one would be worse because Connect\n * is a paid managed service. Every provider Box could one day support is\n * NOT in this list. The eleven below are the ones with code, a named owner and\n * a place in the rollout; everything else is a request, which is a real record\n * with a person on the end of it rather than a card that says \"coming soon\".\n *\n * The availability values are read off the repository, not off ambition\n * (connect/docs, current position 2026-08-24): email and WhatsApp have\n * fixture-backed adapters, the integration spine is implemented against tests,\n * and the first three connectors are specified and not yet built. Nothing is\n * generally available, no production route is enabled, and this file must say\n * so. When a rung moves, it moves here in the same change as the evidence.\n *\n * The three social sources added 2026-08-31 sit at `fixture_certified` on the\n * same rule: potter-api holds three adapters, an injected transport, and a\n * conformance suite that drives the whole request-to-parse cycle against\n * recorded responses. They have met no provider's sandbox. This count is stated rather than left to\n * be counted, so adding an entry means saying so — the word \"seven\" survived\n * unchanged here while entries were added, which is how a comment starts\n * describing a file that no longer exists.\n */\nexport const CONNECT_PRODUCTS: readonly ConnectProduct[] = [\n  {\n    id: 'email-delivery',\n    name: 'Email delivery',\n    plane: 'messaging',\n    shape: 'delivery',\n    availability: 'fixture_certified',\n    outcome:\n      'Send receipts, confirmations and operational mail from your own domain, and see what reached the customer.',\n    requires: 'A domain you can add DNS records to.',\n    permissions: [\n      'Send email as your verified sending domain',\n      'Record delivery, bounce and complaint receipts',\n      'Hold opt-outs and suppressions for your business',\n    ],\n    limits: ['Box does not read replies to your customers.'],\n  },\n  {\n    id: 'whatsapp-delivery',\n    name: 'WhatsApp messaging',\n    brand: 'WhatsApp',\n    plane: 'messaging',\n    shape: 'delivery',\n    availability: 'fixture_certified',\n    outcome:\n      'Send approved WhatsApp templates to customers and take structured replies back into Box.',\n    requires: 'A WhatsApp business number Box can be authorised on.',\n    permissions: [\n      'Send approved template messages from your number',\n      'Receive delivery receipts and customer replies',\n      'Apply your consent and frequency rules before sending',\n    ],\n  },\n  {\n    id: 'sms-delivery',\n    name: 'SMS delivery',\n    plane: 'messaging',\n    shape: 'delivery',\n    availability: 'fixture_certified',\n    outcome:\n      'Reach customers who are not on WhatsApp, on the same consent and evidence rules.',\n    requires: 'An approved sender ID in each market you send to.',\n    permissions: [\n      'Send SMS from your registered sender ID',\n      'Record carrier delivery receipts',\n    ],\n  },\n  {\n    id: 'quickbooks-accounting',\n    name: 'QuickBooks accounting sync',\n    brand: 'QuickBooks',\n    plane: 'integrations',\n    shape: 'sync',\n    availability: 'defined',\n    outcome:\n      'Send approved customers and invoices to your books, and keep paid status in step without re-keying anything.',\n    requires: 'A QuickBooks company you administer.',\n    permissions: [\n      'Create and update customers and invoices in one company',\n      'Read invoice and payment status back',\n    ],\n    limits: ['Box never starts, captures or refunds a payment in QuickBooks.'],\n  },\n  {\n    id: 'calendar-sync',\n    name: 'Calendar booking sync',\n    brand: 'Google Calendar',\n    plane: 'integrations',\n    shape: 'sync',\n    availability: 'defined',\n    outcome:\n      'Keep bookings and the calendar your team actually watches in step, both ways, without duplicate events.',\n    requires: 'A calendar you own on Google or Microsoft 365.',\n    permissions: [\n      'Read and write events on the calendars you pick',\n      'Subscribe to changes so a move on either side is noticed',\n    ],\n    limits: ['Calendars you do not select stay invisible to Box.'],\n  },\n  {\n    id: 'slack-alerts',\n    name: 'Slack operational alerts',\n    brand: 'Slack',\n    plane: 'integrations',\n    shape: 'alert',\n    availability: 'defined',\n    outcome:\n      'Put the orders, stock warnings and failures your team needs to see into one channel they already read.',\n    requires: 'A Slack workspace and a channel to post in.',\n    permissions: ['Post messages to the single channel you choose'],\n    limits: ['Box cannot read your Slack messages or join other channels.'],\n  },\n  {\n    id: 'governed-automation',\n    name: 'Automation bridge',\n    plane: 'integrations',\n    shape: 'action',\n    availability: 'defined',\n    outcome:\n      'React to something happening in Box by doing something in another system, with every step recorded.',\n    requires: 'An automation tool your team already runs.',\n    permissions: [\n      'Publish Box events to your automation tool',\n      'Accept typed actions back, under the same policy as everything else',\n    ],\n    limits: [\n      'Your automation tool never receives a provider credential from Box.',\n    ],\n  },\n  {\n    /*\n     * THE ERP CONNECTOR, AND WHY IT IS THE ONLY ONE THAT NEEDED NO PERMISSION.\n     *\n     * Every other integration on this list waits on somebody: WhatsApp on\n     * Meta, the social three on developer apps and app review, Glovo on an\n     * account manager. Odoo authenticates a database name, a login and an API\n     * key the merchant makes in their own Odoo, so nothing here is gated on a\n     * queue Box does not control. That is why it arrived two rungs above\n     * three older entries rather than behind them.\n     *\n     * WHY `fixture_certified` AND NOT HIGHER.\n     *\n     * potter-api holds the module: an injected transport, a JSON-RPC client,\n     * both crossings, and 19 tests that drive the whole request-to-parse cycle\n     * against recorded Odoo responses, asserting the outbound envelope rather\n     * than only the parse. The four that matter are decisions rather than\n     * mechanisms: a retry must not raise a second sale order, an order missing\n     * a line must not go over with a wrong total, a cursor must not advance\n     * past records the run never read, and stock must not travel back the way\n     * it came.\n     *\n     * It has met no real Odoo. `sandbox_certified` needs a database, and a\n     * free Odoo Online trial is enough. The day it runs against one, this\n     * comment and the rung move together.\n     */\n    id: 'odoo-erp-sync',\n    name: 'Odoo order and stock sync',\n    brand: 'Odoo',\n    plane: 'integrations',\n    shape: 'sync',\n    availability: 'fixture_certified',\n    outcome:\n      'Sell what your ERP says you have, and let a paid order land in Odoo without anyone typing it twice.',\n    requires:\n      'An Odoo database you administer, and an API key from your own user preferences.',\n    permissions: [\n      'Read products and stock in the companies you choose',\n      'Create customers and sale orders for what you sell in Box',\n      'Read back the companies in your database, so you can pick them',\n    ],\n    limits: [\n      'Box never overwrites a stock count in Odoo. Your ERP owns that number and Box reads it.',\n      'Box never posts a journal entry, changes a tax rule or touches your chart of accounts.',\n      'Only a paid order crosses. Box does not fill your ERP with quotations.',\n    ],\n  },\n  /*\n   * THE THREE SOCIAL SOURCES, AND WHY THEY ARE READS AND NOT SHOPS.\n   *\n   * Measured against each provider's own eligibility documentation on\n   * 2026-08-31: Meta's supported-country list for Shops and product tagging\n   * contains no African country at all, TikTok Shop runs in roughly two dozen\n   * markets with nothing in Africa, and YouTube Shopping is fifteen markets\n   * plus Partner Programme membership. Meta CUT its list in 2023.\n   *\n   * Reading, on all three, works anywhere. So these are named for the outcome\n   * a merchant can actually have — seeing what their posts did — rather than\n   * for the one most of the world cannot. Whether a given workspace may also\n   * SELL inside a platform is not baked in here: it comes from\n   * `GET /social-sources`, which asks the adapter about the workspace's own\n   * market rather than assuming. A catalogue entry promising a shop would be\n   * an advert for a door that does not open.\n   *\n   * They sit at `fixture_certified` — passing Box's conformance suite\n   * against test doubles — and the evidence is in potter-api's\n   * `modules/social-sources`: three adapters, an injected transport, and a\n   * suite that drives the whole cycle against recorded responses, request\n   * included. It asserts each provider's own auth spelling (Meta in the query,\n   * TikTok in an `Access-Token` header, YouTube in a bearer header), that a\n   * refusal is raised rather than returned as an empty account, and that\n   * nothing is requested at all without credentials. Proven to bite: moving\n   * TikTok's token into the query fails exactly one test.\n   *\n   * They are NOT `sandbox_certified`. Nothing here has met the providers' own\n   * sandboxes, which needs developer apps registered under Box's accounts\n   * and, for Meta, app review. That is the next rung and this comment moves\n   * with it.\n   */\n  {\n    id: 'instagram-insights',\n    name: 'Instagram performance',\n    brand: 'Instagram',\n    plane: 'integrations',\n    shape: 'sync',\n    availability: 'fixture_certified',\n    outcome:\n      'See what each post actually did, and which ones sent the people who bought.',\n    requires:\n      'An Instagram business or creator account linked to a Facebook Page.',\n    permissions: [\n      'Read reach and engagement on posts you published',\n      'Read your follower count and profile reach',\n      'Ask Meta whether your account may tag products',\n    ],\n    limits: [\n      'Box never posts, replies or sends a message as you.',\n      'Meta discards these numbers after 90 days, so Box keeps what it reads.',\n    ],\n  },\n  {\n    id: 'tiktok-insights',\n    name: 'TikTok performance',\n    brand: 'TikTok',\n    plane: 'integrations',\n    shape: 'sync',\n    availability: 'fixture_certified',\n    outcome: 'See how each video performed, and which ones turned into orders.',\n    requires: 'A TikTok business account you administer.',\n    permissions: [\n      'Read views, reach and engagement on videos you published',\n      'Read your follower count',\n    ],\n    limits: [\n      'Box never posts or comments as you.',\n      'TikTok only lets a business read its own account, so nothing is compared across merchants.',\n    ],\n  },\n  {\n    id: 'youtube-insights',\n    name: 'YouTube performance',\n    brand: 'YouTube',\n    plane: 'integrations',\n    shape: 'sync',\n    availability: 'fixture_certified',\n    outcome: 'See what each video earned you, from views through to orders.',\n    requires: 'A YouTube channel you own.',\n    permissions: [\n      'Read views, likes and comments on your own videos',\n      'Read your subscriber count',\n    ],\n    limits: [\n      'Box never uploads, comments or changes anything on your channel.',\n      'YouTube counts views, not people, so it reports no reach figure at all.',\n    ],\n  },\n];\n\n/** The families a merchant can ask for by name when nothing above fits. */\nexport const REQUESTABLE_FAMILIES: readonly string[] = [\n  'Accounting or bookkeeping',\n  'Calendar or scheduling',\n  'Team chat',\n  'Online marketplace',\n  'Advertising',\n  'Shipping or logistics',\n  'CRM or support desk',\n  'Something else',\n];\n\nexport function productById(id: string): ConnectProduct | undefined {\n  return CONNECT_PRODUCTS.find((p) => p.id === id);\n}\n\n/**\n * Ready first, then how far along, then alphabetical.\n *\n * A merchant scanning this wants the thing they can use today at the top; a\n * list sorted by name buries it under whatever begins with A.\n */\nconst RUNG: Record<Availability, number> = {\n  generally_available: 0,\n  pilot: 1,\n  sandbox_certified: 2,\n  fixture_certified: 3,\n  implemented: 4,\n  defined: 5,\n  suspended: 6,\n  retired: 7,\n};\n\nexport function byReadiness(a: ConnectProduct, b: ConnectProduct): number {\n  return (\n    RUNG[a.availability] - RUNG[b.availability] || a.name.localeCompare(b.name)\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/connect/fixtures/commands.d.ts

@@ -0,0 +1,8 @@
+import type { CommandRecord } from '../types';
+/**
+ * The log, worst first.
+ *
+ * A command that needs a person is the only reason to open this screen
+ * unprompted, so it is not buried under two hundred successes in date order.
+ */
+export declare const FIXTURE_COMMANDS: readonly CommandRecord[];

package/dist/connect/fixtures/commands.js

@@ -0,0 +1,146 @@
+const FIXTURE_COMMANDS = [
+  {
+    id: "cmd_8831",
+    connectionId: "conn_quickbooks_1",
+    subject: { id: "demo-inv-1", kind: "invoice" },
+    summary: "Record invoice INV-2043 for Adaeze Interiors",
+    status: "reconciling",
+    acceptedAt: "2026-08-24T08:38:12.000Z",
+    attempts: [
+      {
+        at: "2026-08-24T08:38:14.000Z",
+        number: 1,
+        reason: "Request timed out after 30s waiting for a response",
+        status: "retry_scheduled"
+      },
+      {
+        at: "2026-08-24T08:41:00.000Z",
+        number: 2,
+        reason: "Accepted, then the connection closed before the reply arrived",
+        status: "reconciling"
+      }
+    ],
+    occurredAt: "2026-08-24T08:41:00.000Z",
+    question: "QuickBooks timed out after accepting the invoice. It may already exist. Box will not send it again until this is settled."
+  },
+  {
+    id: "cmd_8829",
+    connectionId: "conn_calendar_1",
+    subject: { id: "demo-b1", kind: "booking" },
+    summary: "Add booking for Chidera O. to Studio diary",
+    status: "failed",
+    acceptedAt: "2026-08-22T06:02:00.000Z",
+    attempts: [
+      {
+        at: "2026-08-22T06:02:03.000Z",
+        number: 1,
+        reason: "invalid_grant",
+        status: "retry_scheduled"
+      },
+      {
+        at: "2026-08-22T06:04:11.000Z",
+        number: 2,
+        reason: "invalid_grant",
+        status: "retry_scheduled"
+      },
+      {
+        at: "2026-08-22T06:09:40.000Z",
+        number: 3,
+        reason: "invalid_grant",
+        status: "retry_scheduled"
+      },
+      {
+        at: "2026-08-22T06:15:00.000Z",
+        number: 4,
+        reason: "invalid_grant: token has been expired or revoked",
+        status: "failed"
+      }
+    ],
+    occurredAt: "2026-08-22T06:15:00.000Z",
+    question: "The calendar refused the authorisation. Reconnect the calendar and this will be offered again."
+  },
+  {
+    id: "cmd_8830",
+    connectionId: "conn_quickbooks_1",
+    subject: { id: "demo-c1", kind: "customer" },
+    summary: "Update customer Chidera Okafor",
+    status: "retry_scheduled",
+    acceptedAt: "2026-08-24T08:38:55.000Z",
+    attempts: [
+      {
+        at: "2026-08-24T08:39:00.000Z",
+        number: 1,
+        reason: "Too many requests. The provider asked us to wait 60s",
+        status: "retry_scheduled"
+      }
+    ],
+    occurredAt: "2026-08-24T08:39:00.000Z"
+  },
+  {
+    id: "cmd_8828",
+    connectionId: "conn_quickbooks_1",
+    subject: { id: "demo-inv-2", kind: "invoice" },
+    summary: "Record invoice INV-2042 for Tolu Balogun",
+    status: "succeeded",
+    acceptedAt: "2026-08-24T07:02:00.000Z",
+    attempts: [
+      { at: "2026-08-24T07:02:00.000Z", number: 1, status: "succeeded" }
+    ],
+    occurredAt: "2026-08-24T07:02:00.000Z",
+    externalRef: "QB-INV-119384"
+  },
+  {
+    id: "cmd_8827",
+    connectionId: "conn_slack_1",
+    subject: { id: "PB-2411", kind: "order" },
+    summary: "Post order #1841 to #orders",
+    status: "succeeded",
+    acceptedAt: "2026-08-11T17:44:00.000Z",
+    attempts: [
+      { at: "2026-08-11T17:44:00.000Z", number: 1, status: "succeeded" }
+    ],
+    occurredAt: "2026-08-11T17:44:00.000Z",
+    externalRef: "slack-1754932..."
+  },
+  {
+    id: "cmd_8826",
+    connectionId: "conn_calendar_1",
+    subject: { id: "demo-b2", kind: "booking" },
+    summary: "Add booking for Ifeoma N. to Studio diary",
+    status: "succeeded",
+    acceptedAt: "2026-08-21T15:28:00.000Z",
+    attempts: [
+      { at: "2026-08-21T15:28:00.000Z", number: 1, status: "succeeded" }
+    ],
+    occurredAt: "2026-08-21T15:28:00.000Z",
+    externalRef: "gcal-8f21c4"
+  },
+  {
+    id: "cmd_8825",
+    connectionId: "conn_quickbooks_1",
+    summary: "Record invoice INV-2041 for Ngozi Eze",
+    status: "expired",
+    acceptedAt: "2026-08-19T22:10:00.000Z",
+    attempts: [
+      { at: "2026-08-19T22:10:00.000Z", number: 1, status: "expired" }
+    ],
+    occurredAt: "2026-08-19T22:10:00.000Z"
+  },
+  {
+    id: "cmd_8824",
+    connectionId: "conn_whatsapp_1",
+    subject: { id: "PB-2411", kind: "order" },
+    summary: "Send order confirmation to Chidera Okafor",
+    status: "succeeded",
+    acceptedAt: "2026-08-11T17:43:10.000Z",
+    attempts: [
+      { at: "2026-08-11T17:43:12.000Z", number: 1, status: "succeeded" }
+    ],
+    occurredAt: "2026-08-11T17:43:12.000Z",
+    externalRef: "wamid.HBgNMjM0\u2026"
+  }
+];
+export {
+  FIXTURE_COMMANDS
+};
+//# sourceMappingURL=commands.js.map

package/dist/connect/fixtures/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/connect/fixtures/commands.ts"],"sourcesContent":["import type { CommandRecord } from '../types';\n\n/**\n * The log, worst first.\n *\n * A command that needs a person is the only reason to open this screen\n * unprompted, so it is not buried under two hundred successes in date order.\n */\nexport const FIXTURE_COMMANDS: readonly CommandRecord[] = [\n  {\n    id: 'cmd_8831',\n    connectionId: 'conn_quickbooks_1',\n    subject: { id: 'demo-inv-1', kind: 'invoice' },\n    summary: 'Record invoice INV-2043 for Adaeze Interiors',\n    status: 'reconciling',\n    acceptedAt: '2026-08-24T08:38:12.000Z',\n    attempts: [\n      {\n        at: '2026-08-24T08:38:14.000Z',\n        number: 1,\n        reason: 'Request timed out after 30s waiting for a response',\n        status: 'retry_scheduled',\n      },\n      {\n        at: '2026-08-24T08:41:00.000Z',\n        number: 2,\n        reason: 'Accepted, then the connection closed before the reply arrived',\n        status: 'reconciling',\n      },\n    ],\n    occurredAt: '2026-08-24T08:41:00.000Z',\n    question:\n      'QuickBooks timed out after accepting the invoice. It may already exist. Box will not send it again until this is settled.',\n  },\n  {\n    id: 'cmd_8829',\n    connectionId: 'conn_calendar_1',\n    subject: { id: 'demo-b1', kind: 'booking' },\n    summary: 'Add booking for Chidera O. to Studio diary',\n    status: 'failed',\n    acceptedAt: '2026-08-22T06:02:00.000Z',\n    attempts: [\n      {\n        at: '2026-08-22T06:02:03.000Z',\n        number: 1,\n        reason: 'invalid_grant',\n        status: 'retry_scheduled',\n      },\n      {\n        at: '2026-08-22T06:04:11.000Z',\n        number: 2,\n        reason: 'invalid_grant',\n        status: 'retry_scheduled',\n      },\n      {\n        at: '2026-08-22T06:09:40.000Z',\n        number: 3,\n        reason: 'invalid_grant',\n        status: 'retry_scheduled',\n      },\n      {\n        at: '2026-08-22T06:15:00.000Z',\n        number: 4,\n        reason: 'invalid_grant: token has been expired or revoked',\n        status: 'failed',\n      },\n    ],\n    occurredAt: '2026-08-22T06:15:00.000Z',\n    question:\n      'The calendar refused the authorisation. Reconnect the calendar and this will be offered again.',\n  },\n  {\n    id: 'cmd_8830',\n    connectionId: 'conn_quickbooks_1',\n    subject: { id: 'demo-c1', kind: 'customer' },\n    summary: 'Update customer Chidera Okafor',\n    status: 'retry_scheduled',\n    acceptedAt: '2026-08-24T08:38:55.000Z',\n    attempts: [\n      {\n        at: '2026-08-24T08:39:00.000Z',\n        number: 1,\n        reason: 'Too many requests. The provider asked us to wait 60s',\n        status: 'retry_scheduled',\n      },\n    ],\n    occurredAt: '2026-08-24T08:39:00.000Z',\n  },\n  {\n    id: 'cmd_8828',\n    connectionId: 'conn_quickbooks_1',\n    subject: { id: 'demo-inv-2', kind: 'invoice' },\n    summary: 'Record invoice INV-2042 for Tolu Balogun',\n    status: 'succeeded',\n    acceptedAt: '2026-08-24T07:02:00.000Z',\n    attempts: [\n      { at: '2026-08-24T07:02:00.000Z', number: 1, status: 'succeeded' },\n    ],\n    occurredAt: '2026-08-24T07:02:00.000Z',\n    externalRef: 'QB-INV-119384',\n  },\n  {\n    id: 'cmd_8827',\n    connectionId: 'conn_slack_1',\n    subject: { id: 'PB-2411', kind: 'order' },\n    summary: 'Post order #1841 to #orders',\n    status: 'succeeded',\n    acceptedAt: '2026-08-11T17:44:00.000Z',\n    attempts: [\n      { at: '2026-08-11T17:44:00.000Z', number: 1, status: 'succeeded' },\n    ],\n    occurredAt: '2026-08-11T17:44:00.000Z',\n    externalRef: 'slack-1754932...',\n  },\n  {\n    id: 'cmd_8826',\n    connectionId: 'conn_calendar_1',\n    subject: { id: 'demo-b2', kind: 'booking' },\n    summary: 'Add booking for Ifeoma N. to Studio diary',\n    status: 'succeeded',\n    acceptedAt: '2026-08-21T15:28:00.000Z',\n    attempts: [\n      { at: '2026-08-21T15:28:00.000Z', number: 1, status: 'succeeded' },\n    ],\n    occurredAt: '2026-08-21T15:28:00.000Z',\n    externalRef: 'gcal-8f21c4',\n  },\n  {\n    id: 'cmd_8825',\n    connectionId: 'conn_quickbooks_1',\n    summary: 'Record invoice INV-2041 for Ngozi Eze',\n    status: 'expired',\n    acceptedAt: '2026-08-19T22:10:00.000Z',\n    attempts: [\n      { at: '2026-08-19T22:10:00.000Z', number: 1, status: 'expired' },\n    ],\n    occurredAt: '2026-08-19T22:10:00.000Z',\n  },\n  {\n    id: 'cmd_8824',\n    connectionId: 'conn_whatsapp_1',\n    subject: { id: 'PB-2411', kind: 'order' },\n    summary: 'Send order confirmation to Chidera Okafor',\n    status: 'succeeded',\n    acceptedAt: '2026-08-11T17:43:10.000Z',\n    attempts: [\n      { at: '2026-08-11T17:43:12.000Z', number: 1, status: 'succeeded' },\n    ],\n    occurredAt: '2026-08-11T17:43:12.000Z',\n    externalRef: 'wamid.HBgNMjM0…',\n  },\n];\n"],"mappings":"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","names":[]}

package/dist/connect/fixtures/connections.d.ts

@@ -0,0 +1,21 @@
+import type { Connection } from '../types';
+/**
+ * Sample operating state, so the connected experience can be built and judged
+ * before the Connect API is reachable from the dashboard.
+ *
+ * NAMED FOR WHAT IT IS. The catalogue's availability values are real and read
+ * off the Connect repository; these connections are not. The dashboard talks
+ * to potter-api, `withpotter/connect` is a separate service, and no route
+ * proxies one to the other yet — so a page that rendered live-looking rows
+ * from nothing would be the exact failure the availability ladder exists to
+ * prevent, committed by the screen that displays it.
+ *
+ * Everything below is reachable through `use-connect.ts`, which is the only
+ * seam: when the proxy lands, that file changes and these screens do not.
+ *
+ * The three connections are deliberately not all healthy. A surface only
+ * proves itself on the states nobody designs for, and the two that matter here
+ * are a credential that has started failing and a write whose outcome the
+ * provider never confirmed.
+ */
+export declare const FIXTURE_CONNECTIONS: readonly Connection[];