@mantajs/sdk 0.2.0-beta.0

package/dist/client.d.ts

@@ -0,0 +1,103 @@
+import type { RunResult, WorkflowRunSnapshot } from './workflow-types';
+export interface MantaClientOptions {
+    /** Context name (e.g. 'admin', 'store'). Determines the API base path. */
+    context: string;
+    /** Base URL of the Manta backend. Default: '' (same origin). */
+    baseUrl?: string;
+    /** Custom function to get the auth token. Default: reads from localStorage. */
+    getToken?: () => string | null;
+    /** Called on 401 — should refresh the token and return true if successful. */
+    onUnauthorized?: () => Promise<boolean>;
+}
+export declare class MantaClient {
+    private _context;
+    private _baseUrl;
+    private _getToken;
+    private _onUnauthorized;
+    constructor(options: MantaClientOptions);
+    get basePath(): string;
+    private _headers;
+    /** Fetch with automatic 401 retry after token refresh. */
+    private _fetch;
+    /**
+     * Execute a command (POST /api/{ctx}/command/{name}).
+     *
+     * Returns the bare result for inline success.
+     * For async responses (HTTP 202), returns `undefined` — callers that care
+     * about the runId should use {@link runCommand} which returns a
+     * discriminated {@link RunResult} instead.
+     *
+     * Throws {@link MantaSDKError} on HTTP failure.
+     */
+    command<TInput = unknown, TOutput = unknown>(name: string, input: TInput): Promise<TOutput | undefined>;
+    /**
+     * Execute a command and return the full {@link RunResult} envelope.
+     *
+     * See WORKFLOW_PROGRESS.md §6.1:
+     *  - `{ status: 'succeeded', result, runId? }` — workflow finished within the
+     *    300ms inline window (HTTP 200).
+     *  - `{ status: 'failed', error }`             — workflow failed inline.
+     *  - `{ status: 'running', runId }`            — workflow still running; poll
+     *    `GET /api/admin/_workflow/:runId` (HTTP 202).
+     *
+     * This method does NOT throw on inline failure — the error is returned as
+     * part of the discriminated union. Transport-level failures (network errors,
+     * non-JSON bodies) still throw.
+     */
+    runCommand<TInput = unknown, TOutput = unknown>(name: string, input: TInput): Promise<RunResult<TOutput>>;
+    /**
+     * Fetch the merged snapshot for a workflow run.
+     * GET /api/admin/_workflow/:runId — see WORKFLOW_PROGRESS.md §6.5.
+     */
+    getWorkflowRun(runId: string): Promise<WorkflowRunSnapshot>;
+    /**
+     * Request cancellation of a running workflow.
+     * DELETE /api/admin/_workflow/:runId — idempotent (server-side no-op on
+     * terminal runs). See WORKFLOW_PROGRESS.md §6.5.
+     */
+    cancelWorkflowRun(runId: string): Promise<void>;
+    /** Execute a named query (GET /api/{ctx}/{queryName}?params). */
+    query<TOutput = unknown>(name: string, params?: Record<string, unknown>): Promise<TOutput>;
+    /** Execute a graph query (POST /api/{ctx}/graph). */
+    graphQuery<TOutput = unknown>(config: GraphQueryInput): Promise<TOutput>;
+    /** Login and store token. */
+    login(email: string, password: string): Promise<{
+        token: string;
+        refreshToken: string;
+    }>;
+    /** Logout and clear token. */
+    logout(): Promise<void>;
+    /** Get current user. */
+    me<T = unknown>(): Promise<T>;
+}
+/** Entity name — autocompletes from codegen when @mantajs/core types are loaded. */
+declare global {
+    interface MantaGeneratedEntities {
+    }
+}
+type EntityNameArg = keyof MantaGeneratedEntities extends never ? string : keyof MantaGeneratedEntities | (string & {});
+/** Graph query input shape. */
+export interface GraphQueryInput {
+    entity: EntityNameArg;
+    filters?: Record<string, unknown>;
+    pagination?: {
+        limit?: number;
+        offset?: number;
+    };
+    sort?: {
+        field?: string;
+        order?: 'asc' | 'desc';
+    };
+    relations?: string[];
+    fields?: string[];
+    /** Full-text search query — searches across all searchable fields of the entity. */
+    q?: string;
+}
+/** SDK error with type and status. */
+export declare class MantaSDKError extends Error {
+    type: string;
+    status: number;
+    constructor(type: string, message: string, status: number);
+}
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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

package/dist/client.js

@@ -0,0 +1,204 @@
+// Manta SDK — HTTP client for CQRS endpoints
+// Handles context resolution, JWT injection, and response parsing.
+export class MantaClient {
+    _context;
+    _baseUrl;
+    _getToken;
+    _onUnauthorized;
+    constructor(options) {
+        this._context = options.context;
+        this._baseUrl = options.baseUrl ?? '';
+        this._onUnauthorized = options.onUnauthorized ?? null;
+        this._getToken =
+            options.getToken ??
+                (() => {
+                    if (typeof localStorage !== 'undefined') {
+                        return localStorage.getItem(`manta:token:${this._context}`);
+                    }
+                    return null;
+                });
+    }
+    get basePath() {
+        return `${this._baseUrl}/api/${this._context}`;
+    }
+    _headers() {
+        const headers = { 'Content-Type': 'application/json' };
+        const token = this._getToken();
+        if (token)
+            headers.Authorization = `Bearer ${token}`;
+        return headers;
+    }
+    /** Fetch with automatic 401 retry after token refresh. */
+    async _fetch(url, init) {
+        let res = await fetch(url, { ...init, headers: this._headers() });
+        if (res.status === 401 && this._onUnauthorized) {
+            const refreshed = await this._onUnauthorized();
+            if (refreshed) {
+                res = await fetch(url, { ...init, headers: this._headers() });
+            }
+        }
+        return res;
+    }
+    /**
+     * Execute a command (POST /api/{ctx}/command/{name}).
+     *
+     * Returns the bare result for inline success.
+     * For async responses (HTTP 202), returns `undefined` — callers that care
+     * about the runId should use {@link runCommand} which returns a
+     * discriminated {@link RunResult} instead.
+     *
+     * Throws {@link MantaSDKError} on HTTP failure.
+     */
+    async command(name, input) {
+        const run = await this.runCommand(name, input);
+        if (run.status === 'succeeded')
+            return run.result;
+        if (run.status === 'failed')
+            throw run.error;
+        // 'running' — inline-only callers can't wait; see runCommand for runId-aware usage.
+        return undefined;
+    }
+    /**
+     * Execute a command and return the full {@link RunResult} envelope.
+     *
+     * See WORKFLOW_PROGRESS.md §6.1:
+     *  - `{ status: 'succeeded', result, runId? }` — workflow finished within the
+     *    300ms inline window (HTTP 200).
+     *  - `{ status: 'failed', error }`             — workflow failed inline.
+     *  - `{ status: 'running', runId }`            — workflow still running; poll
+     *    `GET /api/admin/_workflow/:runId` (HTTP 202).
+     *
+     * This method does NOT throw on inline failure — the error is returned as
+     * part of the discriminated union. Transport-level failures (network errors,
+     * non-JSON bodies) still throw.
+     */
+    async runCommand(name, input) {
+        const res = await this._fetch(`${this.basePath}/command/${name}`, {
+            method: 'POST',
+            body: JSON.stringify(input),
+        });
+        const body = await res.json();
+        if (!res.ok) {
+            return {
+                status: 'failed',
+                error: new MantaSDKError(body?.type ?? 'ERROR', body?.message ?? res.statusText, res.status),
+            };
+        }
+        // Envelope shapes (set by packages/cli/.../cqrs-routes.ts):
+        //   inline success: { data: { status: 'succeeded', result, runId } }
+        //                   OR legacy: { data: <bareResult> } for sync commands that
+        //                   didn't go through the workflow manager.
+        //   async:          { data: { runId, status: 'running', href } }
+        const envelope = body?.data;
+        if (envelope && typeof envelope === 'object') {
+            const { status, result, runId } = envelope;
+            if (status === 'succeeded') {
+                return { status: 'succeeded', result: result, runId };
+            }
+            if (status === 'running' && typeof runId === 'string') {
+                return { status: 'running', runId };
+            }
+        }
+        // Legacy or unwrapped shape — treat `body.data` as the bare result.
+        return { status: 'succeeded', result: envelope };
+    }
+    /**
+     * Fetch the merged snapshot for a workflow run.
+     * GET /api/admin/_workflow/:runId — see WORKFLOW_PROGRESS.md §6.5.
+     */
+    async getWorkflowRun(runId) {
+        const res = await this._fetch(`${this._baseUrl}/api/admin/_workflow/${runId}`, { method: 'GET' });
+        const body = await res.json();
+        if (!res.ok)
+            throw new MantaSDKError(body?.type ?? 'ERROR', body?.message ?? res.statusText, res.status);
+        return body?.data;
+    }
+    /**
+     * Request cancellation of a running workflow.
+     * DELETE /api/admin/_workflow/:runId — idempotent (server-side no-op on
+     * terminal runs). See WORKFLOW_PROGRESS.md §6.5.
+     */
+    async cancelWorkflowRun(runId) {
+        const res = await this._fetch(`${this._baseUrl}/api/admin/_workflow/${runId}`, { method: 'DELETE' });
+        if (!res.ok) {
+            const body = await res.json().catch(() => ({}));
+            throw new MantaSDKError(body?.type ?? 'ERROR', body?.message ?? res.statusText, res.status);
+        }
+    }
+    /** Execute a named query (GET /api/{ctx}/{queryName}?params). */
+    async query(name, params) {
+        const url = new URL(`${this.basePath}/${name}`, window.location.origin);
+        if (params) {
+            for (const [key, value] of Object.entries(params)) {
+                if (value !== undefined && value !== null) {
+                    url.searchParams.set(key, String(value));
+                }
+            }
+        }
+        const res = await this._fetch(url.toString(), {});
+        const data = await res.json();
+        if (!res.ok)
+            throw new MantaSDKError(data.type ?? 'ERROR', data.message ?? res.statusText, res.status);
+        return data.data ?? data;
+    }
+    /** Execute a graph query (POST /api/{ctx}/graph). */
+    async graphQuery(config) {
+        const res = await this._fetch(`${this.basePath}/graph`, {
+            method: 'POST',
+            body: JSON.stringify(config),
+        });
+        const data = await res.json();
+        if (!res.ok)
+            throw new MantaSDKError(data.type ?? 'ERROR', data.message ?? res.statusText, res.status);
+        // Preserve count for pagination: return { items: [...], count: N } if count is present
+        if (Array.isArray(data.data) && data.count != null) {
+            return { items: data.data, count: data.count };
+        }
+        return data.data ?? data;
+    }
+    /** Login and store token. */
+    async login(email, password) {
+        const res = await fetch(`${this.basePath}/login`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ email, password }),
+        });
+        const data = await res.json();
+        if (!res.ok)
+            throw new MantaSDKError(data.type ?? 'ERROR', data.message ?? res.statusText, res.status);
+        if (typeof localStorage !== 'undefined') {
+            localStorage.setItem(`manta:token:${this._context}`, data.token);
+            if (data.refreshToken)
+                localStorage.setItem(`manta:refresh:${this._context}`, data.refreshToken);
+        }
+        return data;
+    }
+    /** Logout and clear token. */
+    async logout() {
+        try {
+            await fetch(`${this.basePath}/logout`, { method: 'DELETE', headers: this._headers() });
+        }
+        finally {
+            if (typeof localStorage !== 'undefined') {
+                localStorage.removeItem(`manta:token:${this._context}`);
+                localStorage.removeItem(`manta:refresh:${this._context}`);
+            }
+        }
+    }
+    /** Get current user. */
+    async me() {
+        return this.query('me');
+    }
+}
+/** SDK error with type and status. */
+export class MantaSDKError extends Error {
+    type;
+    status;
+    constructor(type, message, status) {
+        super(message);
+        this.name = 'MantaSDKError';
+        this.type = type;
+        this.status = status;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/hooks.d.ts

@@ -0,0 +1,121 @@
+import { type UseMutationResult, type UseQueryResult } from '@tanstack/react-query';
+import type { GraphQueryInput, MantaSDKError } from './client';
+import { type ProgressSnapshot, type RunResult, type StepState, type UseCommandResult, type UseCommandStatus, type WorkflowError, type WorkflowRunSnapshot } from './workflow-types';
+declare global {
+    interface MantaGeneratedCommands {
+    }
+    interface MantaGeneratedQueries {
+    }
+}
+type CommandName = keyof MantaGeneratedCommands extends never ? string : keyof MantaGeneratedCommands | (string & {});
+type QueryName = keyof MantaGeneratedQueries extends never ? string : keyof MantaGeneratedQueries | (string & {});
+export declare const WORKFLOW_POLL_INTERVAL_MS = 1000;
+/** Internal hook state — exported for unit testing of the pure reducers below. */
+export interface CommandState<TOutput> {
+    status: UseCommandStatus;
+    runId: string | undefined;
+    steps: StepState[] | undefined;
+    progress: ProgressSnapshot | undefined;
+    result: TOutput | undefined;
+    error: MantaSDKError | WorkflowError | undefined;
+}
+export declare function idleState<TOutput>(): CommandState<TOutput>;
+export declare function readOnlyInitialState<TOutput>(runId: string): CommandState<TOutput>;
+/**
+ * Reducer: merge a polled WorkflowRunSnapshot into the previous hook state.
+ * Pure — safe to call from tests or the React useEffect.
+ */
+export declare function mergePollSnapshot<TOutput>(prev: CommandState<TOutput>, snap: WorkflowRunSnapshot): CommandState<TOutput>;
+/**
+ * Reducer: derive the post-run() state from the HTTP envelope returned by
+ * `MantaClient.runCommand()`. Pure — safe to call from tests.
+ */
+export declare function stateFromRunResult<TOutput>(envelope: RunResult<TOutput>): CommandState<TOutput>;
+/**
+ * Execute a command and observe its execution.
+ *
+ * See WORKFLOW_PROGRESS.md §7 for the full contract.
+ *
+ * Primary API:
+ * ```tsx
+ * const { run, runId, status, steps, progress, result, error, cancel } = useCommand('import-products')
+ *
+ * async function onClick() {
+ *   const r = await run({ file })
+ *   if (r.status === 'running') navigate(`/_runs/${r.runId}`)
+ *   else if (r.status === 'succeeded') toast.success('Imported')
+ *   else toast.error(r.error.message)
+ * }
+ * ```
+ *
+ * Read-only (observe an existing run):
+ * ```tsx
+ * const { status, steps, progress } = useCommand('import-products', { runId: 'abc-123' })
+ * ```
+ *
+ * Back-compat aliases (`mutateAsync`, `mutate`, `isPending`, `isSuccess`, `isError`,
+ * `reset`, `data`) preserve the old React-Query shape for existing call sites.
+ */
+export declare function useCommand<TInput = unknown, TOutput = unknown>(name: CommandName, options?: {
+    runId?: string;
+}): UseCommandResult<TInput, TOutput>;
+/**
+ * Execute a named query (read-only).
+ * Queries are defined with defineQuery() on the backend.
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading } = useQuery('list-products', { status: 'active', limit: 10 })
+ *
+ * if (isLoading) return <div>Loading...</div>
+ * return <ul>{data?.map(p => <li key={p.id}>{p.title}</li>)}</ul>
+ * ```
+ */
+export declare function useQuery<TOutput = unknown>(name: QueryName, params?: Record<string, unknown>, options?: {
+    enabled?: boolean;
+    staleTime?: number;
+    refetchInterval?: number;
+}): UseQueryResult<TOutput, Error>;
+/**
+ * Execute a graph query (flexible entity + relations + filters).
+ * Only works if defineQueryGraph() is declared for the current context.
+ *
+ * @example
+ * ```tsx
+ * const { data } = useGraphQuery({
+ *   entity: 'product',
+ *   filters: { status: 'active' },
+ *   relations: ['inventory_item'],
+ *   pagination: { limit: 20 },
+ * })
+ * ```
+ */
+export declare function useGraphQuery<TOutput = unknown>(config: GraphQueryInput, options?: {
+    enabled?: boolean;
+    staleTime?: number;
+    refetchInterval?: number;
+}): UseQueryResult<TOutput, Error>;
+/**
+ * Auth helpers for the current context.
+ *
+ * @example
+ * ```tsx
+ * const { login, logout, me } = useAuth()
+ *
+ * await login('admin@example.com', 'password')
+ * const user = await me()
+ * await logout()
+ * ```
+ */
+export declare function useAuth(): {
+    login: (email: string, password: string) => Promise<{
+        token: string;
+        refreshToken: string;
+    }>;
+    logout: () => Promise<void>;
+    me: UseQueryResult<unknown, Error>;
+    isAuthenticated: boolean;
+    isLoading: boolean;
+};
+export type { UseMutationResult };
+//# sourceMappingURL=hooks.d.ts.map

package/dist/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,cAAc,EAGpB,MAAM,uBAAuB,CAAA;AAE9B,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAE9D,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACzB,MAAM,kBAAkB,CAAA;AAOzB,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,sBAAsB;KAAG;IACnC,UAAU,qBAAqB;KAAG;CACnC;AAED,KAAK,WAAW,GAAG,MAAM,sBAAsB,SAAS,KAAK,GAAG,MAAM,GAAG,MAAM,sBAAsB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;AACrH,KAAK,SAAS,GAAG,MAAM,qBAAqB,SAAS,KAAK,GAAG,MAAM,GAAG,MAAM,qBAAqB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;AAIjH,eAAO,MAAM,yBAAyB,OAAO,CAAA;AAE7C,kFAAkF;AAClF,MAAM,WAAW,YAAY,CAAC,OAAO;IACnC,MAAM,EAAE,gBAAgB,CAAA;IACxB,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB,KAAK,EAAE,SAAS,EAAE,GAAG,SAAS,CAAA;IAC9B,QAAQ,EAAE,gBAAgB,GAAG,SAAS,CAAA;IACtC,MAAM,EAAE,OAAO,GAAG,SAAS,CAAA;IAC3B,KAAK,EAAE,aAAa,GAAG,aAAa,GAAG,SAAS,CAAA;CACjD;AAED,wBAAgB,SAAS,CAAC,OAAO,KAAK,YAAY,CAAC,OAAO,CAAC,CAS1D;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,CASlF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EACvC,IAAI,EAAE,YAAY,CAAC,OAAO,CAAC,EAC3B,IAAI,EAAE,mBAAmB,GACxB,YAAY,CAAC,OAAO,CAAC,CAavB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAC,OAAO,CAAC,GAAG,YAAY,CAAC,OAAO,CAAC,CA6B/F;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,UAAU,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,EAC5D,IAAI,EAAE,WAAW,EACjB,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3B,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,CAwHnC;AAID;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CAAC,OAAO,GAAG,OAAO,EACxC,IAAI,EAAE,SAAS,EACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5E,cAAc,CAAC,OAAO,EAAE,KAAK,CAAC,CAqBhC;AAID;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAG,OAAO,EAC7C,MAAM,EAAE,eAAe,EACvB,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5E,cAAc,CAAC,OAAO,EAAE,KAAK,CAAC,CAgBhC;AAID;;;;;;;;;;;GAWG;AACH,wBAAgB,OAAO;mBAoBJ,MAAM,YAAY,MAAM;;;;;;;;EAM1C;AAKD,YAAY,EAAE,iBAAiB,EAAE,CAAA"}

package/dist/hooks.js

@@ -0,0 +1,314 @@
+// Manta SDK — React hooks for CQRS endpoints
+// useCommand, useQuery, useGraphQuery
+import { useMutation, useQuery as useReactQuery, } from '@tanstack/react-query';
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { useMantaClient } from './provider';
+import { isTerminalStatus, } from './workflow-types';
+// ── useCommand ─────────────────────────────────────────
+export const WORKFLOW_POLL_INTERVAL_MS = 1000;
+export function idleState() {
+    return {
+        status: 'idle',
+        runId: undefined,
+        steps: undefined,
+        progress: undefined,
+        result: undefined,
+        error: undefined,
+    };
+}
+export function readOnlyInitialState(runId) {
+    return {
+        status: 'running',
+        runId,
+        steps: undefined,
+        progress: undefined,
+        result: undefined,
+        error: undefined,
+    };
+}
+/**
+ * Reducer: merge a polled WorkflowRunSnapshot into the previous hook state.
+ * Pure — safe to call from tests or the React useEffect.
+ */
+export function mergePollSnapshot(prev, snap) {
+    if (!prev.runId || prev.runId !== snap.id)
+        return prev;
+    // Map WorkflowStatus → UseCommandStatus. `pending` (pre-run) is surfaced as
+    // `running` since the hook is already past idle once we have a runId.
+    const nextStatus = snap.status === 'pending' ? 'running' : snap.status;
+    return {
+        ...prev,
+        status: nextStatus,
+        steps: snap.steps,
+        progress: snap.inFlightProgress ?? prev.progress,
+        result: nextStatus === 'succeeded' ? snap.output : prev.result,
+        error: nextStatus === 'failed' ? snap.error : prev.error,
+    };
+}
+/**
+ * Reducer: derive the post-run() state from the HTTP envelope returned by
+ * `MantaClient.runCommand()`. Pure — safe to call from tests.
+ */
+export function stateFromRunResult(envelope) {
+    if (envelope.status === 'succeeded') {
+        return {
+            status: 'succeeded',
+            runId: envelope.runId,
+            steps: undefined,
+            progress: undefined,
+            result: envelope.result,
+            error: undefined,
+        };
+    }
+    if (envelope.status === 'failed') {
+        return {
+            status: 'failed',
+            runId: undefined,
+            steps: undefined,
+            progress: undefined,
+            result: undefined,
+            error: envelope.error,
+        };
+    }
+    return {
+        status: 'running',
+        runId: envelope.runId,
+        steps: undefined,
+        progress: undefined,
+        result: undefined,
+        error: undefined,
+    };
+}
+/**
+ * Execute a command and observe its execution.
+ *
+ * See WORKFLOW_PROGRESS.md §7 for the full contract.
+ *
+ * Primary API:
+ * ```tsx
+ * const { run, runId, status, steps, progress, result, error, cancel } = useCommand('import-products')
+ *
+ * async function onClick() {
+ *   const r = await run({ file })
+ *   if (r.status === 'running') navigate(`/_runs/${r.runId}`)
+ *   else if (r.status === 'succeeded') toast.success('Imported')
+ *   else toast.error(r.error.message)
+ * }
+ * ```
+ *
+ * Read-only (observe an existing run):
+ * ```tsx
+ * const { status, steps, progress } = useCommand('import-products', { runId: 'abc-123' })
+ * ```
+ *
+ * Back-compat aliases (`mutateAsync`, `mutate`, `isPending`, `isSuccess`, `isError`,
+ * `reset`, `data`) preserve the old React-Query shape for existing call sites.
+ */
+export function useCommand(name, options) {
+    const client = useMantaClient();
+    const initialRunId = options?.runId;
+    const [state, setState] = useState(() => initialRunId ? readOnlyInitialState(initialRunId) : idleState());
+    // Keep the latest state in a ref so mutateAsync's effect can read it without
+    // re-subscribing to every render.
+    const stateRef = useRef(state);
+    stateRef.current = state;
+    // Pending promise plumbing for mutateAsync's "await terminal" semantics is NOT
+    // implemented here — per the PR-5 plan we take the simpler path: mutateAsync
+    // awaits only the initial HTTP. For 'running' responses, it resolves with
+    // `undefined` + a dev warning. See the JSDoc on UseCommandResult.mutateAsync.
+    // ── Polling ─────────────────────────────────────────
+    const shouldPoll = !!state.runId && !isTerminalStatus(state.status);
+    const pollQuery = useReactQuery({
+        queryKey: ['manta', 'workflow-run', state.runId],
+        queryFn: () => client.getWorkflowRun(state.runId),
+        enabled: shouldPoll,
+        refetchInterval: (query) => {
+            const data = query.state.data;
+            if (!data)
+                return WORKFLOW_POLL_INTERVAL_MS;
+            return isTerminalStatus(data.status) ? false : WORKFLOW_POLL_INTERVAL_MS;
+        },
+        refetchIntervalInBackground: false,
+        retry: false,
+    });
+    // Merge polled snapshots into local state.
+    useEffect(() => {
+        const snap = pollQuery.data;
+        if (!snap)
+            return;
+        setState((prev) => mergePollSnapshot(prev, snap));
+    }, [pollQuery.data]);
+    // ── run ────────────────────────────────────────────
+    const run = useCallback(async (input) => {
+        // Optimistic: flip to running with no runId so UI can show a spinner.
+        setState({
+            status: 'running',
+            runId: undefined,
+            steps: undefined,
+            progress: undefined,
+            result: undefined,
+            error: undefined,
+        });
+        const envelope = await client.runCommand(name, input);
+        setState(stateFromRunResult(envelope));
+        return envelope;
+    }, [client, name]);
+    // ── cancel ─────────────────────────────────────────
+    const cancel = useCallback(async () => {
+        const current = stateRef.current;
+        if (!current.runId || isTerminalStatus(current.status))
+            return;
+        await client.cancelWorkflowRun(current.runId);
+        // Polling continues — the server will report status: 'cancelled' and the
+        // polling effect above will merge it into state.
+    }, [client]);
+    // ── reset ──────────────────────────────────────────
+    const reset = useCallback(() => {
+        setState(idleState());
+    }, []);
+    // ── Back-compat aliases ────────────────────────────
+    const mutateAsync = useCallback(async (input) => {
+        const r = await run(input);
+        if (r.status === 'succeeded')
+            return r.result;
+        if (r.status === 'failed')
+            throw r.error;
+        // 'running' — mutateAsync historically returned the bare result. For
+        // async workflows we can't deliver that without blocking on polling;
+        // return undefined and warn so callers migrate to run() + runId.
+        if (typeof console !== 'undefined' && typeof console.warn === 'function') {
+            console.warn(`[useCommand] '${name}' returned async (runId=${r.runId}). mutateAsync resolved with undefined. ` +
+                'Migrate to run() + runId to observe the workflow — see WORKFLOW_PROGRESS.md §7.');
+        }
+        return undefined;
+    }, [run, name]);
+    const mutate = useCallback((input) => {
+        void run(input).catch(() => {
+            /* fire-and-forget: error is stored in state.error */
+        });
+    }, [run]);
+    return {
+        // Primary API
+        run,
+        runId: state.runId,
+        status: state.status,
+        steps: state.steps,
+        progress: state.progress,
+        result: state.result,
+        error: state.error,
+        cancel,
+        // Back-compat aliases
+        mutateAsync,
+        mutate,
+        isPending: state.status === 'running',
+        isSuccess: state.status === 'succeeded',
+        isError: state.status === 'failed',
+        reset,
+        data: state.result,
+    };
+}
+// ── useQuery ───────────────────────────────────────────
+/**
+ * Execute a named query (read-only).
+ * Queries are defined with defineQuery() on the backend.
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading } = useQuery('list-products', { status: 'active', limit: 10 })
+ *
+ * if (isLoading) return <div>Loading...</div>
+ * return <ul>{data?.map(p => <li key={p.id}>{p.title}</li>)}</ul>
+ * ```
+ */
+export function useQuery(name, params, options) {
+    const client = useMantaClient();
+    // Block queries with unresolved :param placeholders (e.g., id=":id" before useParams resolves)
+    const hasUnresolved = params && Object.values(params).some((v) => typeof v === 'string' && v.startsWith(':'));
+    const enabled = (options?.enabled ?? true) && !hasUnresolved;
+    return useReactQuery({
+        queryKey: ['manta', 'query', name, params],
+        queryFn: () => client.query(name, params),
+        enabled,
+        staleTime: options?.staleTime,
+        refetchInterval: options?.refetchInterval,
+        // Keep previous data on pagination/filter changes within the SAME named
+        // query — but NOT when navigating to a different query (we'd display the
+        // old query's rows under the new query's columns until the fetch lands).
+        placeholderData: ((prev, prevQuery) => {
+            if (!prev)
+                return undefined;
+            const prevName = prevQuery?.queryKey?.[2];
+            return prevName === name ? prev : undefined;
+        }),
+    });
+}
+// ── useGraphQuery ──────────────────────────────────────
+/**
+ * Execute a graph query (flexible entity + relations + filters).
+ * Only works if defineQueryGraph() is declared for the current context.
+ *
+ * @example
+ * ```tsx
+ * const { data } = useGraphQuery({
+ *   entity: 'product',
+ *   filters: { status: 'active' },
+ *   relations: ['inventory_item'],
+ *   pagination: { limit: 20 },
+ * })
+ * ```
+ */
+export function useGraphQuery(config, options) {
+    const client = useMantaClient();
+    return useReactQuery({
+        queryKey: ['manta', 'graph', config.entity, config],
+        queryFn: () => client.graphQuery(config),
+        enabled: options?.enabled,
+        staleTime: options?.staleTime,
+        refetchInterval: options?.refetchInterval,
+        // Same scoping as useQuery: only keep previous when staying on the same
+        // entity (pagination, filters), not when navigating to a different one.
+        placeholderData: ((prev, prevQuery) => {
+            if (!prev)
+                return undefined;
+            const prevEntity = prevQuery?.queryKey?.[2];
+            return prevEntity === config.entity ? prev : undefined;
+        }),
+    });
+}
+// ── useAuth ────────────────────────────────────────────
+/**
+ * Auth helpers for the current context.
+ *
+ * @example
+ * ```tsx
+ * const { login, logout, me } = useAuth()
+ *
+ * await login('admin@example.com', 'password')
+ * const user = await me()
+ * await logout()
+ * ```
+ */
+export function useAuth() {
+    const client = useMantaClient();
+    const loginMutation = useMutation({
+        mutationKey: ['manta', 'auth', 'login'],
+        mutationFn: ({ email, password }) => client.login(email, password),
+    });
+    const logoutMutation = useMutation({
+        mutationKey: ['manta', 'auth', 'logout'],
+        mutationFn: () => client.logout(),
+    });
+    const meQuery = useReactQuery({
+        queryKey: ['manta', 'auth', 'me'],
+        queryFn: () => client.me(),
+        retry: false,
+    });
+    return {
+        login: (email, password) => loginMutation.mutateAsync({ email, password }),
+        logout: () => logoutMutation.mutateAsync(),
+        me: meQuery,
+        isAuthenticated: !!meQuery.data && !meQuery.isError,
+        isLoading: meQuery.isLoading,
+    };
+}
+//# sourceMappingURL=hooks.js.map

package/dist/hooks.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export type { GraphQueryInput, MantaClientOptions } from './client';
+export { MantaClient, MantaSDKError } from './client';
+export { useAuth, useCommand, useGraphQuery, useQuery } from './hooks';
+export type { MantaProviderProps } from './provider';
+export { MantaProvider, useMantaClient } from './provider';
+export { listParams, retrieveParams } from './query-helpers';
+export type { ProgressSnapshot, RunResult, StepState, StepStatus, UseCommandResult, UseCommandStatus, WorkflowError, WorkflowRunSnapshot, WorkflowStatus, } from './workflow-types';
+export { isTerminalStatus } from './workflow-types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAcA,YAAY,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAEnE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAErD,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AACtE,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAEpD,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAG1D,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAC5D,YAAY,EACV,gBAAgB,EAChB,SAAS,EACT,SAAS,EACT,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,mBAAmB,EACnB,cAAc,GACf,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/index.js

@@ -0,0 +1,24 @@
+// @mantajs/sdk — Frontend SDK for Manta applications
+//
+// Hooks:
+//   useCommand('create-product')     — execute a command (mutation)
+//   useQuery('list-products', {...}) — execute a named query (read)
+//   useGraphQuery({entity, ...})     — execute a graph query (flexible)
+//   useAuth()                        — login, logout, me
+//
+// Provider:
+//   <MantaProvider context="admin"> — wraps app with SDK context
+//
+// Client (headless):
+//   new MantaClient({ context: 'admin' }) — for non-React usage
+// Client (headless — usable without React)
+export { MantaClient, MantaSDKError } from './client';
+// React hooks
+export { useAuth, useCommand, useGraphQuery, useQuery } from './hooks';
+// Provider
+export { MantaProvider, useMantaClient } from './provider';
+// Query helpers (for defineQuery input composition)
+export { listParams, retrieveParams } from './query-helpers';
+// Workflow types — shared with the backend via HTTP (shapes match @mantajs/core)
+export { isTerminalStatus } from './workflow-types';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,EAAE;AACF,SAAS;AACT,oEAAoE;AACpE,oEAAoE;AACpE,wEAAwE;AACxE,yDAAyD;AACzD,EAAE;AACF,YAAY;AACZ,iEAAiE;AACjE,EAAE;AACF,qBAAqB;AACrB,gEAAgE;AAGhE,2CAA2C;AAC3C,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACrD,cAAc;AACd,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAEtE,WAAW;AACX,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAE1D,oDAAoD;AACpD,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAY5D,iFAAiF;AACjF,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/provider.d.ts

@@ -0,0 +1,24 @@
+import { QueryClient } from '@tanstack/react-query';
+import type React from 'react';
+import { MantaClient, type MantaClientOptions } from './client';
+export interface MantaProviderProps extends MantaClientOptions {
+    children: React.ReactNode;
+    /** Custom React Query client. Default: built-in with 30s stale time. */
+    queryClient?: QueryClient;
+}
+/**
+ * MantaProvider — wraps your app with Manta SDK context.
+ *
+ * @example
+ * ```tsx
+ * <MantaProvider context="admin">
+ *   <App />
+ * </MantaProvider>
+ * ```
+ */
+export declare function MantaProvider({ children, queryClient, ...clientOptions }: MantaProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Get the MantaClient from context. Throws if not inside MantaProvider.
+ */
+export declare function useMantaClient(): MantaClient;
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAuB,MAAM,uBAAuB,CAAA;AACxE,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAU/D,MAAM,WAAW,kBAAmB,SAAQ,kBAAkB;IAC5D,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,wEAAwE;IACxE,WAAW,CAAC,EAAE,WAAW,CAAA;CAC1B;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,aAAa,EAAE,EAAE,kBAAkB,2CAS5F;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,WAAW,CAM5C"}

package/dist/provider.js

@@ -0,0 +1,38 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+// MantaProvider — React context provider for the SDK
+// Provides the MantaClient to all hooks (useCommand, useQuery, useGraphQuery)
+import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
+import { createContext, useContext, useMemo } from 'react';
+import { MantaClient } from './client';
+const MantaContext = createContext(null);
+const defaultQueryClient = new QueryClient({
+    defaultOptions: {
+        queries: { staleTime: 30_000, retry: 1 },
+    },
+});
+/**
+ * MantaProvider — wraps your app with Manta SDK context.
+ *
+ * @example
+ * ```tsx
+ * <MantaProvider context="admin">
+ *   <App />
+ * </MantaProvider>
+ * ```
+ */
+export function MantaProvider({ children, queryClient, ...clientOptions }) {
+    // biome-ignore lint/correctness/useExhaustiveDependencies: only recreate on context/baseUrl change
+    const client = useMemo(() => new MantaClient(clientOptions), [clientOptions.context, clientOptions.baseUrl]);
+    return (_jsx(MantaContext.Provider, { value: client, children: _jsx(QueryClientProvider, { client: queryClient ?? defaultQueryClient, children: children }) }));
+}
+/**
+ * Get the MantaClient from context. Throws if not inside MantaProvider.
+ */
+export function useMantaClient() {
+    const client = useContext(MantaContext);
+    if (!client) {
+        throw new Error('useMantaClient must be used inside <MantaProvider>');
+    }
+    return client;
+}
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../src/provider.tsx"],"names":[],"mappings":";AAAA,qDAAqD;AACrD,8EAA8E;AAE9E,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAExE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAC1D,OAAO,EAAE,WAAW,EAA2B,MAAM,UAAU,CAAA;AAE/D,MAAM,YAAY,GAAG,aAAa,CAAqB,IAAI,CAAC,CAAA;AAE5D,MAAM,kBAAkB,GAAG,IAAI,WAAW,CAAC;IACzC,cAAc,EAAE;QACd,OAAO,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE;KACzC;CACF,CAAC,CAAA;AAQF;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,aAAa,EAAsB;IAC3F,mGAAmG;IACnG,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,WAAW,CAAC,aAAa,CAAC,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC,CAAA;IAE5G,OAAO,CACL,KAAC,YAAY,CAAC,QAAQ,IAAC,KAAK,EAAE,MAAM,YAClC,KAAC,mBAAmB,IAAC,MAAM,EAAE,WAAW,IAAI,kBAAkB,YAAG,QAAQ,GAAuB,GAC1E,CACzB,CAAA;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,MAAM,GAAG,UAAU,CAAC,YAAY,CAAC,CAAA;IACvC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAA;IACvE,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/query-helpers.d.ts

@@ -0,0 +1,44 @@
+import { z } from 'zod';
+/**
+ * Standard list params: limit, offset, sort, search.
+ * Spread into your defineQuery input schema.
+ *
+ * @example
+ * ```typescript
+ * export default defineQuery({
+ *   name: 'list-products',
+ *   input: z.object({
+ *     status: z.string().optional(),
+ *     ...listParams(),
+ *   }),
+ *   handler: async (input, { query }) => { ... },
+ * })
+ * ```
+ */
+export declare function listParams(defaults?: {
+    limit?: number;
+    maxLimit?: number;
+}): {
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+    sort: z.ZodOptional<z.ZodString>;
+    order: z.ZodDefault<z.ZodEnum<["asc", "desc"]>>;
+    search: z.ZodOptional<z.ZodString>;
+};
+/**
+ * Standard retrieve params: id + optional fields.
+ *
+ * @example
+ * ```typescript
+ * export default defineQuery({
+ *   name: 'get-product',
+ *   input: z.object({ ...retrieveParams() }),
+ *   handler: async (input, { query }) => { ... },
+ * })
+ * ```
+ */
+export declare function retrieveParams(): {
+    id: z.ZodString;
+    fields: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+};
+//# sourceMappingURL=query-helpers.d.ts.map

package/dist/query-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-helpers.d.ts","sourceRoot":"","sources":["../src/query-helpers.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,UAAU,CAAC,QAAQ,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE;;;;;;EAc1E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc;;;EAK7B"}

package/dist/query-helpers.js

@@ -0,0 +1,54 @@
+// Query input helpers — reusable Zod fragments for common query patterns
+// Not part of the React hooks — used in defineQuery() backend code.
+// Re-exported from @mantajs/sdk for convenience.
+import { z } from 'zod';
+/**
+ * Standard list params: limit, offset, sort, search.
+ * Spread into your defineQuery input schema.
+ *
+ * @example
+ * ```typescript
+ * export default defineQuery({
+ *   name: 'list-products',
+ *   input: z.object({
+ *     status: z.string().optional(),
+ *     ...listParams(),
+ *   }),
+ *   handler: async (input, { query }) => { ... },
+ * })
+ * ```
+ */
+export function listParams(defaults) {
+    const maxLimit = defaults?.maxLimit ?? 100;
+    return {
+        limit: z
+            .number()
+            .int()
+            .min(1)
+            .max(maxLimit)
+            .default(defaults?.limit ?? 20),
+        offset: z.number().int().min(0).default(0),
+        sort: z.string().optional(),
+        order: z.enum(['asc', 'desc']).default('desc'),
+        search: z.string().optional(),
+    };
+}
+/**
+ * Standard retrieve params: id + optional fields.
+ *
+ * @example
+ * ```typescript
+ * export default defineQuery({
+ *   name: 'get-product',
+ *   input: z.object({ ...retrieveParams() }),
+ *   handler: async (input, { query }) => { ... },
+ * })
+ * ```
+ */
+export function retrieveParams() {
+    return {
+        id: z.string(),
+        fields: z.array(z.string()).optional(),
+    };
+}
+//# sourceMappingURL=query-helpers.js.map

package/dist/query-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-helpers.js","sourceRoot":"","sources":["../src/query-helpers.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,oEAAoE;AACpE,iDAAiD;AAEjD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,UAAU,CAAC,QAAgD;IACzE,MAAM,QAAQ,GAAG,QAAQ,EAAE,QAAQ,IAAI,GAAG,CAAA;IAC1C,OAAO;QACL,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,GAAG,EAAE;aACL,GAAG,CAAC,CAAC,CAAC;aACN,GAAG,CAAC,QAAQ,CAAC;aACb,OAAO,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE,CAAC;QACjC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;QAC1C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC3B,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;QAC9C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAC9B,CAAA;AACH,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO;QACL,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;QACd,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;KACvC,CAAA;AACH,CAAC"}

package/dist/workflow-types.d.ts

@@ -0,0 +1,105 @@
+import type { MantaSDKError } from './client';
+/** Overall workflow run status — matches core `WorkflowStatus`. */
+export type WorkflowStatus = 'pending' | 'running' | 'succeeded' | 'failed' | 'cancelled';
+/** Per-step status — matches core `StepStatus`. */
+export type StepStatus = 'pending' | 'running' | 'succeeded' | 'failed' | 'cancelled' | 'compensated';
+/** Step state as returned by `GET /_workflow/:id` — matches core `StepState`. */
+export interface StepState {
+    name: string;
+    status: StepStatus;
+    started_at?: string;
+    completed_at?: string;
+    error?: {
+        message: string;
+        code?: string;
+    };
+}
+/** In-flight progress snapshot from the Redis liveness channel. */
+export interface ProgressSnapshot {
+    stepName: string;
+    current: number;
+    total: number | null;
+    message?: string;
+    at: number;
+}
+/** Workflow error payload (JSON-serialised — not a MantaError instance). */
+export interface WorkflowError {
+    message: string;
+    code?: string;
+    stack?: string;
+}
+/**
+ * Full snapshot returned by `GET /api/admin/_workflow/:id`.
+ * See packages/cli/src/bootstrap/phases/wire/wire-workflow-routes.ts for the
+ * authoritative server shape.
+ */
+export interface WorkflowRunSnapshot {
+    id: string;
+    command_name: string;
+    status: WorkflowStatus;
+    steps: StepState[];
+    inFlightProgress?: ProgressSnapshot;
+    output?: unknown;
+    error?: WorkflowError;
+    started_at?: string;
+    completed_at?: string;
+    cancel_requested_at?: string;
+}
+/**
+ * Result returned by `useCommand().run(input)`.
+ * Three cases, matching WORKFLOW_PROGRESS.md §6.1:
+ *  - `succeeded` — workflow finished within the 300ms inline window.
+ *  - `failed`    — workflow failed within the 300ms inline window.
+ *  - `running`   — workflow is still running; use `runId` to poll.
+ */
+export type RunResult<T> = {
+    status: 'succeeded';
+    result: T;
+    runId?: string;
+} | {
+    status: 'failed';
+    error: MantaSDKError;
+} | {
+    status: 'running';
+    runId: string;
+};
+/** Hook-local status — superset of `WorkflowStatus` plus `idle`. */
+export type UseCommandStatus = 'idle' | 'running' | 'succeeded' | 'failed' | 'cancelled';
+/**
+ * Return shape of `useCommand` — see WORKFLOW_PROGRESS.md §7.
+ *
+ * The primary API is `{ run, runId, status, steps, progress, result, error, cancel }`.
+ *
+ * Back-compat aliases (`mutateAsync`, `mutate`, `isPending`, `isSuccess`, `isError`,
+ * `reset`, `data`) preserve the shape of the pre-PR-4 React-Query mutation so
+ * existing call sites continue to work. New code should use the primary API.
+ */
+export interface UseCommandResult<TInput, TOutput> {
+    run: (input: TInput) => Promise<RunResult<TOutput>>;
+    runId: string | undefined;
+    status: UseCommandStatus;
+    steps: StepState[] | undefined;
+    progress: ProgressSnapshot | undefined;
+    result: TOutput | undefined;
+    error: MantaSDKError | WorkflowError | undefined;
+    cancel: () => Promise<void>;
+    /**
+     * Awaits the initial HTTP response only. On inline success, resolves with
+     * `result`. On inline failure, throws the `MantaSDKError`. On async response
+     * (`status: 'running'`), resolves with `undefined` and emits a dev-warning —
+     * migrate such call sites to the new `run()` + `runId` API.
+     */
+    mutateAsync: (input: TInput) => Promise<TOutput | undefined>;
+    /** Fire-and-forget variant of `run()`. Ignores errors. */
+    mutate: (input: TInput) => void;
+    isPending: boolean;
+    isSuccess: boolean;
+    isError: boolean;
+    /** Resets the hook to its idle state. */
+    reset: () => void;
+    /** Alias for `result`. */
+    data: TOutput | undefined;
+}
+/** Terminal states — polling stops once any of these is reached. */
+export declare function isTerminalStatus(status: UseCommandStatus | WorkflowStatus | undefined): boolean;
+//# sourceMappingURL=workflow-types.d.ts.map

package/dist/workflow-types.d.ts.map

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

package/dist/workflow-types.js

@@ -0,0 +1,12 @@
+// Workflow-related types for the SDK.
+// See WORKFLOW_PROGRESS.md §5 (data model), §6.1 (RunResult), §7 (useCommand shape).
+//
+// These are deliberately duplicated from @mantajs/core rather than imported, so the
+// SDK bundle stays free of server-only dependencies (drizzle-orm, zod, etc.). The
+// shapes MUST stay in sync with packages/core/src/ports/workflow-store.ts and
+// packages/core/src/ports/progress-channel.ts.
+/** Terminal states — polling stops once any of these is reached. */
+export function isTerminalStatus(status) {
+    return status === 'succeeded' || status === 'failed' || status === 'cancelled';
+}
+//# sourceMappingURL=workflow-types.js.map

package/dist/workflow-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-types.js","sourceRoot":"","sources":["../src/workflow-types.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,qFAAqF;AACrF,EAAE;AACF,oFAAoF;AACpF,kFAAkF;AAClF,8EAA8E;AAC9E,+CAA+C;AA2G/C,oEAAoE;AACpE,MAAM,UAAU,gBAAgB,CAAC,MAAqD;IACpF,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,WAAW,CAAA;AAChF,CAAC"}

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@mantajs/sdk",
+  "version": "0.2.0-beta.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "dependencies": {
+    "@tanstack/query-core": "^5.90.20",
+    "@tanstack/react-query": "^5.0.0",
+    "react": "^19.0.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/react": "^19.0.0"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ]
+}