@possibl/rcrt-sdk 0.1.2 → 0.1.3

package/dist/internal/sse.js

@@ -0,0 +1,161 @@
+/**
+ * SSE client with automatic reconnection + typed event dispatch.
+ *
+ * Works in three environments:
+ *   - Browsers: uses the built-in `EventSource`. Auth goes via query
+ *     params because `EventSource` can't set custom headers.
+ *   - Node 18+: uses the built-in `EventSource` (Node 22+) or a
+ *     pluggable polyfill (see `config.eventSource`).
+ *   - React Native: install `react-native-sse` and pass its
+ *     constructor as `config.eventSource`. Custom headers work there.
+ *
+ * Subscribers get typed events. Streams auto-reconnect with
+ * exponential backoff unless `close()` was called explicitly.
+ */
+export function connect(config, handlers) {
+    const maxBackoff = config.maxBackoffMs ?? 30_000;
+    let backoff = 1_000;
+    let closed = false;
+    let es = null;
+    let state = 'connecting';
+    let reconnectTimer = null;
+    async function open() {
+        if (closed)
+            return;
+        const token = await config.getToken();
+        const u = new URL(config.apiUrl.replace(/\/$/, '') + config.path);
+        if (config.query) {
+            for (const [k, v] of Object.entries(config.query)) {
+                u.searchParams.set(k, v);
+            }
+        }
+        const EventSourceCtor = (config.eventSource
+            ?? globalThis.EventSource);
+        if (!EventSourceCtor) {
+            handlers.onError?.({ message: 'No EventSource implementation available. Pass config.eventSource for React Native.', fatal: true }, true);
+            closed = true;
+            state = 'closed';
+            return;
+        }
+        // Prefer header auth when the EventSource impl supports it (React
+        // Native with `react-native-sse`, Node 22+, any custom
+        // `config.eventSource` that accepts a `headers` init). The browser's
+        // built-in EventSource constructor has NO support for custom
+        // headers — there's no proposal in the WHATWG spec to change that —
+        // so when we're stuck with it we fall back to passing the bearer
+        // token and tenant ID as query params.
+        //
+        // Security note (Sonar hotspot review): tokens in URLs are a
+        // documented smell — they can leak via proxy logs, HTTP Referer
+        // headers, and browser history. We mitigate:
+        //   * TLS is assumed (RCRT's api-gateway rejects plaintext HTTP).
+        //   * Firebase ID tokens are short-lived (60 min) and auto-rotated.
+        //     A leaked token in a server log expires fast; it can't be used
+        //     to escalate outside the scope Firebase already granted.
+        //   * `tk_*` workspace API keys are long-lived and should NEVER be
+        //     passed through this path. Callers holding a tk_ key are
+        //     server-side and must set `useHeaderAuth: true`. The SDK docs
+        //     and the TokenProvider interface make this explicit.
+        //   * This fallback only triggers for SSE subscriptions. The regular
+        //     fetch-based surface (`src/internal/fetch.ts`) always uses the
+        //     Authorization header.
+        // Without this fallback the SDK cannot open SSE connections from a
+        // browser at all, which would break every chat UI built on RCRT.
+        const init = {};
+        if (config.useHeaderAuth) {
+            init.headers = {
+                Authorization: `Bearer ${token}`,
+                ...(config.tenantId ? { 'X-Tenant-ID': config.tenantId } : {}),
+            };
+        }
+        else {
+            u.searchParams.set('token', token); // NOSONAR - required for browser EventSource; see block comment above
+            if (config.tenantId)
+                u.searchParams.set('tenant_id', config.tenantId);
+        }
+        try {
+            es = new EventSourceCtor(u.toString(), init);
+        }
+        catch (err) {
+            handlers.onError?.({ message: err.message, fatal: true }, true);
+            scheduleReconnect();
+            return;
+        }
+        es.onopen = () => {
+            backoff = 1_000;
+            state = 'open';
+            handlers.onOpen?.();
+        };
+        es.addEventListener('connected', (e) => {
+            const data = tryJson(e.data);
+            handlers.onConnected?.(data);
+        });
+        es.addEventListener('delta', (e) => {
+            const data = tryJson(e.data);
+            if (data)
+                handlers.onDelta?.(data);
+        });
+        es.addEventListener('message', (e) => {
+            const data = tryJson(e.data);
+            if (data)
+                handlers.onMessage?.(data);
+        });
+        es.addEventListener('thought', (e) => {
+            const data = tryJson(e.data);
+            if (data)
+                handlers.onThought?.(data);
+        });
+        es.addEventListener('action', (e) => {
+            const data = tryJson(e.data);
+            if (data)
+                handlers.onAction?.(data);
+        });
+        es.addEventListener('error', (e) => {
+            const data = tryJson(e?.data ?? '');
+            handlers.onError?.(data ?? { message: 'stream error' }, false);
+        });
+        es.onerror = () => {
+            state = 'closed';
+            handlers.onClose?.();
+            es?.close();
+            es = null;
+            scheduleReconnect();
+        };
+    }
+    function scheduleReconnect() {
+        if (closed)
+            return;
+        state = 'connecting';
+        const delay = backoff + Math.floor(Math.random() * 500);
+        backoff = Math.min(maxBackoff, backoff * 2);
+        reconnectTimer = setTimeout(() => {
+            reconnectTimer = null;
+            void open();
+        }, delay);
+    }
+    void open();
+    return {
+        close() {
+            closed = true;
+            state = 'closed';
+            if (reconnectTimer)
+                clearTimeout(reconnectTimer);
+            es?.close();
+            es = null;
+        },
+        get state() {
+            return state;
+        },
+    };
+}
+function tryJson(raw) {
+    if (typeof raw !== 'string' || !raw)
+        return undefined;
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=sse.js.map

package/dist/internal/sse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.js","sourceRoot":"","sources":["../../src/internal/sse.ts"],"names":[],"mappings":"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"}

package/dist/types/breadcrumb.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Breadcrumb — the fundamental record of RCRT.
+ *
+ * Every meaningful state change in the system is a breadcrumb. See
+ * `packages/docs/concepts/02-primitives.md` for the mental model.
+ */
+export type ActorType = 'user' | 'agent' | 'tool' | 'system';
+export interface Actor {
+    type: ActorType;
+    /** For users: the user UUID. For agents: the agent id. For tools: the tool name. */
+    id: string;
+}
+export interface Breadcrumb {
+    id: string;
+    tenant_id: string;
+    name: string;
+    title: string;
+    content: Record<string, unknown>;
+    /** AND-semantics when queried. Prefix conventions: `interpret:*`, `service:*`, `session:*`, `user:*`, etc. */
+    tags: string[];
+    /** Breadcrumbs this derived from (SAPL provenance chain). */
+    parent_ids: string[];
+    /** Optimistic locking. PATCH must include the current value. */
+    version: number;
+    created_by: Actor;
+    created_at: string;
+    updated_at: string;
+    deleted_at: string | null;
+    /** Optional embedding for semantic search. */
+    embedding?: number[];
+    /** Relative TTL — e.g. "24h", "30d". */
+    ttl?: string;
+}
+export interface CreateBreadcrumbRequest {
+    name?: string;
+    title: string;
+    content: Record<string, unknown>;
+    tags?: string[];
+    parent_ids?: string[];
+    created_by?: Actor;
+    ttl?: string;
+    /** If a breadcrumb with the same name + tags exists, update it rather than inserting a new row. */
+    upsert?: boolean;
+}
+export interface UpdateBreadcrumbRequest {
+    /** Required. Optimistic locking fails with 409 Conflict otherwise. */
+    version: number;
+    title?: string;
+    content?: Record<string, unknown>;
+    tags?: string[];
+    parent_ids?: string[];
+    ttl?: string;
+}
+export interface BreadcrumbResponse {
+    breadcrumb: Breadcrumb;
+    action?: 'created' | 'updated';
+}
+export interface QueryByTagsOptions {
+    /** Max rows to return. Server max is 200. */
+    limit?: number;
+    offset?: number;
+    /** Exact name match. */
+    name?: string;
+    order?: 'newest' | 'oldest';
+}
+export interface SemanticSearchOptions {
+    limit?: number;
+    tags?: string[];
+}
+//# sourceMappingURL=breadcrumb.d.ts.map

package/dist/types/breadcrumb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"breadcrumb.d.ts","sourceRoot":"","sources":["../../src/types/breadcrumb.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE7D,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,SAAS,CAAC;IAChB,oFAAoF;IACpF,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,8GAA8G;IAC9G,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,6DAA6D;IAC7D,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,KAAK,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,wCAAwC;IACxC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,CAAC,EAAE,KAAK,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mGAAmG;IACnG,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,uBAAuB;IACtC,sEAAsE;IACtE,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,UAAU,CAAC;IACvB,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;CAChC;AAED,MAAM,WAAW,kBAAkB;IACjC,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wBAAwB;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;CAC7B;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB"}

package/dist/types/breadcrumb.js

@@ -0,0 +1,8 @@
+/**
+ * Breadcrumb — the fundamental record of RCRT.
+ *
+ * Every meaningful state change in the system is a breadcrumb. See
+ * `packages/docs/concepts/02-primitives.md` for the mental model.
+ */
+export {};
+//# sourceMappingURL=breadcrumb.js.map

package/dist/types/breadcrumb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"breadcrumb.js","sourceRoot":"","sources":["../../src/types/breadcrumb.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/types/card.d.ts

@@ -0,0 +1,251 @@
+/**
+ * JIT UI Card contract.
+ *
+ * The universal structure every pending-action breadcrumb carries in
+ * `content.card`. Mirrors the OpenAPI schemas under
+ * `#/components/schemas/Card*`. See
+ * `packages/docs/concepts/05-jit-ui.md` for the mental model.
+ */
+export type CardLayout = 'claim' | 'list-feed' | 'timeline' | 'stat' | 'chart' | 'compare' | 'draft' | 'decision' | 'rating' | 'input' | 'progress' | 'receipt' | 'connect' | 'info';
+export type ActionStyle = 'primary' | 'secondary' | 'ghost' | 'destructive';
+export interface CardAction {
+    /**
+     * PATCHed as `content.status` when the user taps. Canonical values:
+     * `approved` / `rejected` / `dismissed` / `edited`. Custom ids are
+     * allowed and land in `content.user_response.status`.
+     */
+    id: string;
+    label: string;
+    style?: ActionStyle;
+    emoji?: string;
+    /** Explicit result; default when absent is `{status: id}`. */
+    result?: {
+        status: string;
+        user_response?: unknown;
+    };
+}
+export interface CardHeader {
+    title: string;
+    emoji?: string;
+    /** Lucide icon name. Fallback when emoji isn't set. */
+    icon?: string;
+    subtitle?: string;
+    /** Drives chart palette and home-feed placement. e.g. `health`, `finance`. */
+    domain_tag?: string;
+}
+export interface CardFooter {
+    actions?: CardAction[];
+    dismissable?: boolean;
+}
+export type TrendDirection = 'up' | 'down' | 'flat';
+export type ChartSpec = {
+    kind: 'spark';
+    points: number[];
+    trend?: TrendDirection;
+} | {
+    kind: 'line';
+    series: Array<{
+        label?: string;
+        points: Array<[string, number]>;
+    }>;
+    y_target?: number;
+    y_unit?: string;
+} | {
+    kind: 'bar';
+    bars: Array<{
+        label: string;
+        value: number;
+        highlight?: boolean;
+    }>;
+    orientation?: 'h' | 'v';
+    y_unit?: string;
+} | {
+    kind: 'area';
+    points: Array<[string, number]>;
+    y_target?: number;
+    y_unit?: string;
+} | {
+    kind: 'ring';
+    value: number;
+    max: number;
+    label?: string;
+    value_label?: string;
+} | {
+    kind: 'heatmap';
+    cells: number[][];
+    x_labels?: string[];
+    y_labels?: string[];
+} | {
+    kind: 'histogram';
+    buckets: Array<{
+        label: string;
+        count: number;
+    }>;
+};
+export interface TextRow {
+    kind: 'text';
+    text: string;
+    badge?: string;
+}
+/**
+ * Flexible text row shape. Agents frequently reach for natural field
+ * names like `{label, detail, meta}` when listing email-ish items.
+ * Renderers should accept either shape; this SDK re-exports the
+ * strict `TextRow` as the canonical type and the loose shape as a
+ * helper for consumers writing their own renderers.
+ */
+export interface FlexibleTextRow {
+    kind?: 'text';
+    text?: string;
+    label?: string;
+    title?: string;
+    name?: string;
+    detail?: string;
+    subtitle?: string;
+    snippet?: string;
+    description?: string;
+    meta?: string;
+    badge?: string;
+    when?: string;
+    value?: string | number;
+}
+export interface ClaimRow {
+    kind: 'claim';
+    claim: string;
+    confidence?: 'low' | 'med' | 'high';
+    /** Longer context shown when the user expands a "why" drawer. */
+    why?: string;
+    /** Breadcrumb id the claim derives from. */
+    source_ref?: string;
+}
+export interface MetricRow {
+    kind: 'metric';
+    label: string;
+    /** Formatted display value — "6h 45m", "$1,420", "42%". */
+    value: string;
+    trend?: TrendDirection;
+    target?: string;
+    spark?: ChartSpec;
+}
+export interface EventRow {
+    kind: 'event';
+    title: string;
+    starts_at: string;
+    duration_min?: number;
+    location?: string;
+    who?: string[];
+    emoji?: string;
+}
+export interface PersonRow {
+    kind: 'person';
+    name: string;
+    avatar_hint?: string;
+    relationship?: string;
+    last_touch?: string;
+    spark?: ChartSpec;
+    quick_actions?: CardAction[];
+}
+export interface PlaceRow {
+    kind: 'place';
+    label: string;
+    address?: string;
+    lat_lng?: [number, number];
+}
+export interface ToggleRow {
+    kind: 'toggle';
+    label: string;
+    enabled: boolean;
+    action_id: string;
+}
+export interface DraftPreviewRow {
+    kind: 'draft-preview';
+    lines: string[];
+    body?: string;
+}
+export interface ChartRow {
+    kind: 'chart';
+    chart: ChartSpec;
+    caption?: string;
+}
+export type Row = TextRow | ClaimRow | MetricRow | EventRow | PersonRow | PlaceRow | ToggleRow | DraftPreviewRow | ChartRow;
+export interface DraftPreview {
+    kind: 'email' | 'calendar-event' | 'message' | 'ritual' | 'task' | 'custom';
+    subject?: string;
+    to?: string[];
+    from?: string;
+    starts_at?: string;
+    duration_min?: number;
+    location?: string;
+    body: string;
+}
+export type InputSpec = {
+    id: string;
+    label: string;
+    placeholder?: string;
+    kind?: 'text' | 'textarea' | 'email' | 'url' | 'number' | 'time' | 'date';
+    default_value?: string;
+};
+export type RatingSpec = {
+    kind: 'scale';
+    min: number;
+    max: number;
+    step?: number;
+    label?: string;
+} | {
+    kind: 'emoji';
+    options: Array<{
+        id: string;
+        emoji: string;
+        label: string;
+    }>;
+};
+export interface ProgressState {
+    /** 0..1, or `null` for indeterminate. */
+    pct?: number | null;
+    step?: string;
+}
+export interface ConnectDetails {
+    service_id: string;
+    scope_description?: string;
+    account_label?: string;
+    ask_label?: boolean;
+}
+export interface CompareColumn {
+    title: string;
+    subtitle?: string;
+    rows: Row[];
+    action_id?: string;
+}
+export interface CardBody {
+    text?: string;
+    rows?: Row[];
+    metrics?: MetricRow[];
+    chart?: ChartSpec;
+    draft?: DraftPreview;
+    inputs?: InputSpec[];
+    rating?: RatingSpec;
+    progress?: ProgressState;
+    connect?: ConnectDetails;
+    columns?: CompareColumn[];
+}
+export interface Card {
+    layout: CardLayout;
+    header: CardHeader;
+    body?: CardBody;
+    footer?: CardFooter;
+    /** Default `chat`. `home` → goes on the Awaiting-you feed. */
+    target?: 'chat' | 'home' | 'both';
+    entity_refs?: string[];
+    /**
+     * Optional explicit dedupe key. Without one, the server applies an
+     * implicit `(layout, service_id, title)` key for `connect` cards
+     * and `(layout, title)` otherwise.
+     */
+    dedupe_key?: string;
+}
+export type CanonicalStatus = 'pending' | 'approved' | 'rejected' | 'dismissed' | 'edited';
+export interface ResolveRequest {
+    status: CanonicalStatus | string;
+    user_response?: unknown;
+}
+//# sourceMappingURL=card.d.ts.map

package/dist/types/card.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"card.d.ts","sourceRoot":"","sources":["../../src/types/card.ts"],"names":[],"mappings":"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"}

package/dist/types/card.js

@@ -0,0 +1,10 @@
+/**
+ * JIT UI Card contract.
+ *
+ * The universal structure every pending-action breadcrumb carries in
+ * `content.card`. Mirrors the OpenAPI schemas under
+ * `#/components/schemas/Card*`. See
+ * `packages/docs/concepts/05-jit-ui.md` for the mental model.
+ */
+export {};
+//# sourceMappingURL=card.js.map

package/dist/types/card.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"card.js","sourceRoot":"","sources":["../../src/types/card.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/types/index.d.ts

@@ -0,0 +1,3 @@
+export * from './breadcrumb.js';
+export * from './card.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC"}

package/{src/types/index.ts → dist/types/index.js}

@@ -1,2 +1,3 @@
 export * from './breadcrumb.js';
 export * from './card.js';
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC"}

package/package.json

@@ -1,8 +1,9 @@
 {
   "name": "@possibl/rcrt-sdk",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "TypeScript SDK for the RCRT multi-tenant AI BaaS — isomorphic (web + node + React Native)",
   "type": "module",
+  "//": "In-repo consumers (tests, dashboard) see raw src/*.ts via `main`/`exports`. publishConfig overrides these at publish time to point at compiled dist/ so npm installs are clean JS + .d.ts.",
   "main": "./src/index.ts",
   "types": "./src/index.ts",
   "exports": {
@@ -13,12 +14,36 @@
     "./types": {
       "types": "./src/types/index.ts",
       "default": "./src/types/index.ts"
+    },
+    "./generated": {
+      "types": "./src/generated/index.ts",
+      "default": "./src/generated/index.ts"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "exports": {
+      ".": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "./types": {
+        "types": "./dist/types/index.d.ts",
+        "default": "./dist/types/index.js"
+      },
+      "./generated": {
+        "types": "./dist/generated/index.d.ts",
+        "default": "./dist/generated/index.js"
+      }
     }
   },
   "files": [
-    "src",
+    "dist",
     "README.md",
-    "CHANGELOG.md"
+    "CHANGELOG.md",
+    "LICENSE"
   ],
   "keywords": [
     "rcrt",
@@ -33,7 +58,7 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/possibl-ai/rcrt-v2.git",
+    "url": "https://github.com/possibl-ai/rcrt-v2",
     "directory": "packages/rcrt-sdk"
   },
   "homepage": "https://github.com/possibl-ai/rcrt-v2/tree/development/packages/docs",
@@ -43,11 +68,15 @@
   },
   "scripts": {
     "type-check": "tsc --noEmit && tsc --noEmit -p tsconfig.tests.json",
-    "build": "tsc",
-    "test": "tsx --test tests/*.test.ts"
+    "build": "rm -rf dist && tsc -p tsconfig.build.json",
+    "test": "tsx --test tests/*.test.ts",
+    "codegen": "openapi-typescript ../docs/openapi/v1.yaml -o ./src/generated/openapi.ts",
+    "codegen:check": "openapi-typescript ../docs/openapi/v1.yaml -o /tmp/rcrt-openapi-check.ts && diff -q ./src/generated/openapi.ts /tmp/rcrt-openapi-check.ts",
+    "prepack": "pnpm run build"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",
+    "openapi-typescript": "^7.13.0",
     "tsx": "^4.19.2",
     "typescript": "~5.6.0"
   }