@junejuly-lockstep/sdk 0.1.1 → 0.2.1

package/README.md

@@ -1,12 +1,15 @@
 # @junejuly-lockstep/sdk
 
-A typed `fetch` client for the Lockstep platform API. Two clients:
+A typed `fetch` client for the Lockstep platform API, used by `@junejuly-lockstep/cli`. Three
+clients:
 
-- `createIngestClient` authenticates with a project API key (`lsk_...`, sent as a bearer token) and
-  covers the routes the reconciler uses: presigned uploads, baselines, `POST /api/ingest/runs` and
-  `POST /api/ingest/models`.
-- `createSessionClient` rides the SPA's session cookie and covers the read and judgment API
-  (projects, journeys, board, cards, annotations, ops).
+- `createCheckClient` authenticates with a project API key (`lsk_...`, sent as a bearer token) and
+  covers what `lockstep check` needs: presigned screenshot uploads, `POST /api/ingest/checks` and
+  the intent manifest.
+- `createDeviceClient` runs the CLI device authorization (`lockstep init`): request a code, then
+  poll until a signed-in member approves it and the project API key comes back.
+- `createAgentClient` (project API key) gives coding agents ticket context: the project, tickets,
+  a ticket's context and screens, and linking a pull request, comments and agent runs to a ticket.
 
 Every response is validated with the `@junejuly-lockstep/model` schemas before it is returned; failures
 surface as `LockstepApiError` (HTTP status and body) or `LockstepNetworkError` (retries exhausted).
@@ -21,16 +24,16 @@ pnpm add @junejuly-lockstep/sdk @junejuly-lockstep/model
 ## Usage
 
 ```ts
-import { createIngestClient, LockstepApiError } from '@junejuly-lockstep/sdk';
+import { createAgentClient, LockstepApiError } from '@junejuly-lockstep/sdk';
 
-const ingest = createIngestClient({
+const agent = createAgentClient({
   baseUrl: 'https://api.lockstep.example',
   apiKey: process.env.LOCKSTEP_API_KEY!,
 });
 
 try {
-  const baselines = await ingest.getBaselines('FERN');
-  console.log(`${baselines.entries.length} approved baselines`);
+  const tickets = await agent.listTickets(['todo', 'in_progress']);
+  console.log(`${tickets.length} open tickets`);
 } catch (err) {
   if (err instanceof LockstepApiError) console.error(err.status, err.message);
   else throw err;
@@ -38,7 +41,7 @@ try {
 ```
 
 `@junejuly-lockstep/sdk/testing` exports `fakeFetch`, a recording `fetch` double for unit tests of code that
-uses either client.
+uses any client.
 
 Published from the [Lockstep monorepo](https://github.com/JuneJulyHealth/lockstep)
-(`packages/sdk`). Versioned in lockstep with `@junejuly-lockstep/model` and `@junejuly-lockstep/reconciler`.
+(`packages/sdk`). Versioned in lockstep with `@junejuly-lockstep/model` and `@junejuly-lockstep/cli`.

package/dist/index.d.ts

@@ -1,8 +1,6 @@
 export { LockstepApiError, LockstepNetworkError } from './errors.js';
-export { createIngestClient, INGEST_ROUTES } from './ingest.js';
-export type { IngestClient, IngestClientOptions } from './ingest.js';
-export { createSessionClient, SESSION_ROUTES } from './session.js';
-export type { ConditionalOptions, JudgmentAction, RunArtifactsResponse, SessionClient, SessionClientOptions, } from './session.js';
+export { AGENT_ROUTES, CHECK_ROUTES, DEVICE_ROUTES, createAgentClient, createCheckClient, createDeviceClient, } from './v2.js';
+export type { AgentClient, ApiKeyClientOptions, CheckClient, DeviceClient, DeviceClientOptions, } from './v2.js';
 export { joinUrl, DEFAULT_RETRY } from './http.js';
 export type { Conditional, FetchLike, RetryPolicy } from './http.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAChE,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnE,YAAY,EACV,kBAAkB,EAClB,cAAc,EACd,oBAAoB,EACpB,aAAa,EACb,oBAAoB,GACrB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AACnD,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,SAAS,CAAC;AACjB,YAAY,EACV,WAAW,EACX,mBAAmB,EACnB,WAAW,EACX,YAAY,EACZ,mBAAmB,GACpB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AACnD,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -1,5 +1,4 @@
 export { LockstepApiError, LockstepNetworkError } from './errors.js';
-export { createIngestClient, INGEST_ROUTES } from './ingest.js';
-export { createSessionClient, SESSION_ROUTES } from './session.js';
+export { AGENT_ROUTES, CHECK_ROUTES, DEVICE_ROUTES, createAgentClient, createCheckClient, createDeviceClient, } from './v2.js';
 export { joinUrl, DEFAULT_RETRY } from './http.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEhE,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAQnE,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,SAAS,CAAC;AAQjB,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC"}

package/dist/v2.d.ts

@@ -0,0 +1,65 @@
+import { z } from 'zod';
+import { AgentStartedRequest, CheckPayload, DeviceCodeRequest, DeviceCodeResponse, DeviceTokenResponse, IngestCheckResponse, IngestProjectDto, IntentManifest, LinkPrRequest, PresignCheckRequest, PresignCheckResponse, ScreenContextDto, TicketContextDto, TicketDto, type TicketStatus } from '@junejuly-lockstep/model/v2';
+import { type FetchLike, type RetryPolicy } from './http.js';
+/**
+ * Lockstep v2 clients (docs/REDESIGN.md). Every route the CLI calls is listed here so the API can
+ * be reconciled against one table.
+ */
+export declare const CHECK_ROUTES: {
+    readonly presign: "/api/ingest/checks/presign";
+    readonly checks: "/api/ingest/checks";
+    readonly intentManifest: "/api/ingest/intent-manifest";
+};
+export declare const DEVICE_ROUTES: {
+    readonly start: "/api/cli/device";
+    readonly token: "/api/cli/device/token";
+};
+export declare const AGENT_ROUTES: {
+    readonly project: "/api/ingest/project";
+    readonly tickets: "/api/ingest/tickets";
+    readonly ticketContext: (ref: string) => string;
+    readonly ticketPrs: (ref: string) => string;
+    readonly ticketComments: (ref: string) => string;
+    readonly ticketAgentStarted: (ref: string) => string;
+    readonly screen: "/api/ingest/screens";
+};
+export interface ApiKeyClientOptions {
+    /** Platform API origin, e.g. https://api-staging.lockstep.junejuly.dev */
+    baseUrl: string;
+    /** Project API key, `lsk_...`. Sent as `Authorization: Bearer`. */
+    apiKey: string;
+    fetch?: FetchLike;
+    retry?: Partial<RetryPolicy>;
+}
+export interface CheckClient {
+    /** POST /api/ingest/checks/presign: presigned PUTs, at most 50 files per call; the first call reserves the check id. */
+    presign(req: PresignCheckRequest): Promise<PresignCheckResponse>;
+    /** POST /api/ingest/checks: the reality map and visual scores of one check. */
+    postCheck(payload: CheckPayload): Promise<IngestCheckResponse>;
+    /** GET /api/ingest/intent-manifest?project=KEY: intent screenshots with presigned GETs; null on 404. */
+    getIntentManifest(projectKey: string): Promise<IntentManifest | null>;
+}
+export declare function createCheckClient(options: ApiKeyClientOptions): CheckClient;
+export interface DeviceClientOptions {
+    baseUrl: string;
+    fetch?: FetchLike;
+    retry?: Partial<RetryPolicy>;
+}
+export interface DeviceClient {
+    /** POST /api/cli/device: no auth; returns the user code and verification URL. */
+    start(req: z.input<typeof DeviceCodeRequest>): Promise<DeviceCodeResponse>;
+    /** POST /api/cli/device/token: one poll. A non-2xx body that is a token status is returned too. */
+    poll(deviceCode: string): Promise<DeviceTokenResponse>;
+}
+export declare function createDeviceClient(options: DeviceClientOptions): DeviceClient;
+export interface AgentClient {
+    getProject(): Promise<IngestProjectDto>;
+    listTickets(status?: TicketStatus[]): Promise<TicketDto[]>;
+    getTicketContext(ref: string): Promise<TicketContextDto>;
+    getScreen(screenKey: string, env?: string): Promise<ScreenContextDto>;
+    linkPr(ref: string, req: z.input<typeof LinkPrRequest>): Promise<unknown>;
+    addComment(ref: string, text: string): Promise<unknown>;
+    agentStarted(ref: string, req?: z.input<typeof AgentStartedRequest>): Promise<unknown>;
+}
+export declare function createAgentClient(options: ApiKeyClientOptions): AgentClient;
+//# sourceMappingURL=v2.d.ts.map

package/dist/v2.d.ts.map

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

package/dist/v2.js

@@ -0,0 +1,184 @@
+import { z } from 'zod';
+import { AddTicketCommentRequest, AgentStartedRequest, CheckPayload, DeviceCodeRequest, DeviceCodeResponse, DeviceTokenRequest, DeviceTokenResponse, IngestCheckResponse, IngestProjectDto, IntentManifest, LinkPrRequest, PresignCheckRequest, PresignCheckResponse, ScreenContextDto, TicketContextDto, TicketDto, TicketListDto, } from '@junejuly-lockstep/model/v2';
+import { LockstepApiError } from './errors.js';
+import { createHttp } from './http.js';
+/**
+ * Lockstep v2 clients (docs/REDESIGN.md). Every route the CLI calls is listed here so the API can
+ * be reconciled against one table.
+ */
+export const CHECK_ROUTES = {
+    presign: '/api/ingest/checks/presign',
+    checks: '/api/ingest/checks',
+    intentManifest: '/api/ingest/intent-manifest',
+};
+export const DEVICE_ROUTES = {
+    start: '/api/cli/device',
+    token: '/api/cli/device/token',
+};
+const enc = (ref) => encodeURIComponent(ref);
+export const AGENT_ROUTES = {
+    project: '/api/ingest/project',
+    tickets: '/api/ingest/tickets',
+    ticketContext: (ref) => `/api/ingest/tickets/${enc(ref)}/context`,
+    ticketPrs: (ref) => `/api/ingest/tickets/${enc(ref)}/prs`,
+    ticketComments: (ref) => `/api/ingest/tickets/${enc(ref)}/comments`,
+    ticketAgentStarted: (ref) => `/api/ingest/tickets/${enc(ref)}/agent-started`,
+    screen: '/api/ingest/screens',
+};
+function apiKeyHttp(options, who) {
+    if (!options.apiKey)
+        throw new Error(`${who}: apiKey is required`);
+    if (!options.apiKey.startsWith('lsk_'))
+        throw new Error(`${who}: apiKey must be a project key starting with lsk_`);
+    return createHttp({
+        baseUrl: options.baseUrl,
+        fetch: options.fetch,
+        retry: options.retry,
+        headers: { authorization: `Bearer ${options.apiKey}` },
+    });
+}
+export function createCheckClient(options) {
+    const http = apiKeyHttp(options, 'createCheckClient');
+    return {
+        async presign(req) {
+            return http.request({
+                method: 'POST',
+                path: CHECK_ROUTES.presign,
+                body: PresignCheckRequest.parse(req),
+                schema: PresignCheckResponse,
+                // Presign is idempotent for a given check id; retry transient failures.
+                idempotent: req.checkId !== undefined,
+            });
+        },
+        async postCheck(payload) {
+            return http.request({
+                method: 'POST',
+                path: CHECK_ROUTES.checks,
+                body: CheckPayload.parse(payload),
+                schema: IngestCheckResponse,
+            });
+        },
+        async getIntentManifest(projectKey) {
+            try {
+                return await http.request({
+                    method: 'GET',
+                    path: CHECK_ROUTES.intentManifest,
+                    query: { project: projectKey },
+                    schema: IntentManifest,
+                });
+            }
+            catch (err) {
+                if (err instanceof LockstepApiError && err.status === 404)
+                    return null;
+                throw err;
+            }
+        },
+    };
+}
+export function createDeviceClient(options) {
+    const http = createHttp({ baseUrl: options.baseUrl, fetch: options.fetch, retry: options.retry });
+    return {
+        async start(req) {
+            return http.request({
+                method: 'POST',
+                path: DEVICE_ROUTES.start,
+                body: DeviceCodeRequest.parse(req),
+                schema: DeviceCodeResponse,
+            });
+        },
+        async poll(deviceCode) {
+            const body = DeviceTokenRequest.parse({ deviceCode });
+            const { response, url } = await http.raw({
+                method: 'POST',
+                path: DEVICE_ROUTES.token,
+                body,
+                schema: DeviceTokenResponse,
+                idempotent: true,
+            });
+            const text = await response.text();
+            let json = null;
+            try {
+                json = text ? JSON.parse(text) : null;
+            }
+            catch {
+                json = text;
+            }
+            const parsed = DeviceTokenResponse.safeParse(json);
+            if (parsed.success)
+                return parsed.data;
+            throw new LockstepApiError({
+                status: response.status,
+                body: json,
+                method: 'POST',
+                url,
+                message: response.ok
+                    ? `POST ${url} returned a body that is not a device token status`
+                    : undefined,
+            });
+        },
+    };
+}
+/* ------------------------------------------------------------------ agents (mcp, work orders) */
+/** The list endpoint may answer `{ tickets }` or a bare array; both parse to `{ tickets }`. */
+const TicketListResponse = z.union([
+    TicketListDto,
+    z.array(TicketDto).transform((tickets) => ({ tickets })),
+]);
+export function createAgentClient(options) {
+    const http = apiKeyHttp(options, 'createAgentClient');
+    const anyBody = z.unknown();
+    return {
+        async getProject() {
+            return http.request({ method: 'GET', path: AGENT_ROUTES.project, schema: IngestProjectDto });
+        },
+        async listTickets(status) {
+            const res = await http.request({
+                method: 'GET',
+                path: AGENT_ROUTES.tickets,
+                query: { status: status && status.length > 0 ? status.join(',') : undefined },
+                schema: TicketListResponse,
+            });
+            return res.tickets;
+        },
+        async getTicketContext(ref) {
+            return http.request({
+                method: 'GET',
+                path: AGENT_ROUTES.ticketContext(ref),
+                schema: TicketContextDto,
+            });
+        },
+        async getScreen(screenKey, env) {
+            return http.request({
+                method: 'GET',
+                path: AGENT_ROUTES.screen,
+                query: { key: screenKey, env },
+                schema: ScreenContextDto,
+            });
+        },
+        async linkPr(ref, req) {
+            return http.request({
+                method: 'POST',
+                path: AGENT_ROUTES.ticketPrs(ref),
+                body: LinkPrRequest.parse(req),
+                schema: anyBody,
+            });
+        },
+        async addComment(ref, text) {
+            return http.request({
+                method: 'POST',
+                path: AGENT_ROUTES.ticketComments(ref),
+                body: AddTicketCommentRequest.parse({ text }),
+                schema: anyBody,
+            });
+        },
+        async agentStarted(ref, req = {}) {
+            return http.request({
+                method: 'POST',
+                path: AGENT_ROUTES.ticketAgentStarted(ref),
+                body: AgentStartedRequest.parse(req),
+                schema: anyBody,
+            });
+        },
+    };
+}
+//# sourceMappingURL=v2.js.map

package/dist/v2.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@junejuly-lockstep/sdk",
-  "version": "0.1.1",
-  "description": "Typed fetch client for the Lockstep platform: ingest API (runs, presign, baselines, model sync) and the session read API.",
+  "version": "0.2.1",
+  "description": "Typed fetch client for the Lockstep platform: check ingest, CLI device authorization and agent (ticket) clients.",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -45,14 +45,14 @@
   },
   "dependencies": {
     "zod": "^3.24.1",
-    "@junejuly-lockstep/model": "0.1.1"
+    "@junejuly-lockstep/model": "0.2.1"
   },
   "devDependencies": {
     "typescript": "^5.7.2",
     "vitest": "^2.1.8"
   },
   "scripts": {
-    "build": "tsc -p tsconfig.json",
+    "build": "node -e \"for (const p of ['dist','tsconfig.tsbuildinfo']) require('node:fs').rmSync(p,{recursive:true,force:true})\" && tsc -p tsconfig.json",
     "typecheck": "tsc -p tsconfig.typecheck.json --noEmit",
     "lint": "eslint src",
     "test": "vitest run"

package/dist/ingest.d.ts

@@ -1,32 +0,0 @@
-import { BaselineManifest, IngestRunResponse, ModelSyncPayload, ModelSyncResponse, PresignRequest, PresignResponse, RunPayload } from '@junejuly-lockstep/model';
-import { type FetchLike, type RetryPolicy } from './http.js';
-export interface IngestClientOptions {
-    /** Platform API origin, e.g. https://api.lockstep.example */
-    baseUrl: string;
-    /** Project API key, `lsk_...`. Sent as `Authorization: Bearer`. */
-    apiKey: string;
-    fetch?: FetchLike;
-    retry?: Partial<RetryPolicy>;
-}
-/** Routes the reconciler uses. Kept in one place so the API can be reconciled against them. */
-export declare const INGEST_ROUTES: {
-    readonly presign: "/api/ingest/presign";
-    readonly runs: "/api/ingest/runs";
-    readonly baselines: "/api/ingest/baselines";
-    readonly models: "/api/ingest/models";
-};
-export interface IngestClient {
-    /** POST /api/ingest/presign: batch presigned PUT URLs (max 50 files per call). */
-    presign(req: PresignRequest): Promise<PresignResponse>;
-    /** GET /api/ingest/baselines?project=KEY: current approved baselines with presigned GET URLs. */
-    getBaselines(projectKey: string): Promise<BaselineManifest>;
-    /** POST /api/ingest/runs: the complete run payload. */
-    postRun(payload: RunPayload): Promise<IngestRunResponse>;
-    /**
-     * POST /api/ingest/models: parsed journey models and scenarios at a commit (M3 model sync, run
-     * by `lockstep sync-models` in client CI on push; the platform never evaluates journey files).
-     */
-    syncModels(payload: ModelSyncPayload): Promise<ModelSyncResponse>;
-}
-export declare function createIngestClient(options: IngestClientOptions): IngestClient;
-//# sourceMappingURL=ingest.d.ts.map

package/dist/ingest.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ingest.d.ts","sourceRoot":"","sources":["../src/ingest.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,UAAU,EACX,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAc,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAEzE,MAAM,WAAW,mBAAmB;IAClC,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;CAC9B;AAED,+FAA+F;AAC/F,eAAO,MAAM,aAAa;;;;;CAKhB,CAAC;AAEX,MAAM,WAAW,YAAY;IAC3B,kFAAkF;IAClF,OAAO,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IACvD,iGAAiG;IACjG,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC5D,uDAAuD;IACvD,OAAO,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACzD;;;OAGG;IACH,UAAU,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACnE;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,YAAY,CAiD7E"}

package/dist/ingest.js

@@ -1,60 +0,0 @@
-import { BaselineManifest, IngestRunResponse, ModelSyncPayload, ModelSyncResponse, PresignRequest, PresignResponse, RunPayload, } from '@junejuly-lockstep/model';
-import { createHttp } from './http.js';
-/** Routes the reconciler uses. Kept in one place so the API can be reconciled against them. */
-export const INGEST_ROUTES = {
-    presign: '/api/ingest/presign',
-    runs: '/api/ingest/runs',
-    baselines: '/api/ingest/baselines',
-    models: '/api/ingest/models',
-};
-export function createIngestClient(options) {
-    if (!options.apiKey)
-        throw new Error('createIngestClient: apiKey is required');
-    if (!options.apiKey.startsWith('lsk_')) {
-        throw new Error('createIngestClient: apiKey must be a project key starting with lsk_');
-    }
-    const http = createHttp({
-        baseUrl: options.baseUrl,
-        fetch: options.fetch,
-        retry: options.retry,
-        headers: { authorization: `Bearer ${options.apiKey}` },
-    });
-    return {
-        async presign(req) {
-            const body = PresignRequest.parse(req);
-            return http.request({
-                method: 'POST',
-                path: INGEST_ROUTES.presign,
-                body,
-                schema: PresignResponse,
-            });
-        },
-        async getBaselines(projectKey) {
-            return http.request({
-                method: 'GET',
-                path: INGEST_ROUTES.baselines,
-                query: { project: projectKey },
-                schema: BaselineManifest,
-            });
-        },
-        async postRun(payload) {
-            const body = RunPayload.parse(payload);
-            return http.request({
-                method: 'POST',
-                path: INGEST_ROUTES.runs,
-                body,
-                schema: IngestRunResponse,
-            });
-        },
-        async syncModels(payload) {
-            const body = ModelSyncPayload.parse(payload);
-            return http.request({
-                method: 'POST',
-                path: INGEST_ROUTES.models,
-                body,
-                schema: ModelSyncResponse,
-            });
-        },
-    };
-}
-//# sourceMappingURL=ingest.js.map

package/dist/ingest.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ingest.js","sourceRoot":"","sources":["../src/ingest.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,UAAU,GACX,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,UAAU,EAAoC,MAAM,WAAW,CAAC;AAWzE,+FAA+F;AAC/F,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,OAAO,EAAE,qBAAqB;IAC9B,IAAI,EAAE,kBAAkB;IACxB,SAAS,EAAE,uBAAuB;IAClC,MAAM,EAAE,oBAAoB;CACpB,CAAC;AAgBX,MAAM,UAAU,kBAAkB,CAAC,OAA4B;IAC7D,IAAI,CAAC,OAAO,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC/E,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAC;IACzF,CAAC;IACD,MAAM,IAAI,GAAG,UAAU,CAAC;QACtB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,OAAO,CAAC,MAAM,EAAE,EAAE;KACvD,CAAC,CAAC;IAEH,OAAO;QACL,KAAK,CAAC,OAAO,CAAC,GAAG;YACf,MAAM,IAAI,GAAG,cAAc,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACvC,OAAO,IAAI,CAAC,OAAO,CAAC;gBAClB,MAAM,EAAE,MAAM;gBACd,IAAI,EAAE,aAAa,CAAC,OAAO;gBAC3B,IAAI;gBACJ,MAAM,EAAE,eAAe;aACxB,CAAC,CAAC;QACL,CAAC;QACD,KAAK,CAAC,YAAY,CAAC,UAAU;YAC3B,OAAO,IAAI,CAAC,OAAO,CAAC;gBAClB,MAAM,EAAE,KAAK;gBACb,IAAI,EAAE,aAAa,CAAC,SAAS;gBAC7B,KAAK,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE;gBAC9B,MAAM,EAAE,gBAAgB;aACzB,CAAC,CAAC;QACL,CAAC;QACD,KAAK,CAAC,OAAO,CAAC,OAAO;YACnB,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACvC,OAAO,IAAI,CAAC,OAAO,CAAC;gBAClB,MAAM,EAAE,MAAM;gBACd,IAAI,EAAE,aAAa,CAAC,IAAI;gBACxB,IAAI;gBACJ,MAAM,EAAE,iBAAiB;aAC1B,CAAC,CAAC;QACL,CAAC;QACD,KAAK,CAAC,UAAU,CAAC,OAAO;YACtB,MAAM,IAAI,GAAG,gBAAgB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC7C,OAAO,IAAI,CAAC,OAAO,CAAC;gBAClB,MAAM,EAAE,MAAM;gBACd,IAAI,EAAE,aAAa,CAAC,MAAM;gBAC1B,IAAI;gBACJ,MAAM,EAAE,iBAAiB;aAC1B,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}