@civitai/app-sdk 0.1.0

package/dist/orchestrator/index.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Orchestrator glue — types, constants, and fetch-based helpers shared by every
+ * starter's BFF. Client + server safe: no Node-only imports, no `process.env`
+ * access. All configuration flows through the `OrchestratorClient` value that
+ * the caller builds.
+ */
+export declare const DEFAULT_ORCHESTRATOR_BASE_URL = "https://orchestration.civitai.com";
+/** Default SDXL base model. Replace per starter / per call as needed. */
+export declare const DEFAULT_MODEL_AIR = "urn:air:sdxl:checkpoint:civitai:101055@128078";
+/**
+ * Terminal orchestrator statuses (lowercase — matches what the API returns).
+ */
+export declare const TERMINAL_STATUSES: readonly ["succeeded", "failed", "expired", "canceled"];
+export type TerminalStatus = (typeof TERMINAL_STATUSES)[number];
+/**
+ * Orchestrator workflow status. Lowercase — matches what the orchestrator
+ * actually returns. Forward-compat: open-ended string union so unknown
+ * statuses don't break typing.
+ */
+export type WorkflowStatus = 'unassigned' | 'pending' | 'processing' | 'succeeded' | 'failed' | 'expired' | 'canceled' | (string & {});
+export interface GenerateInput {
+    prompt: string;
+    negativePrompt?: string;
+    /** AIR URN, e.g. `urn:air:sdxl:checkpoint:civitai:101055@128078`. */
+    model?: string;
+    width?: number;
+    height?: number;
+    steps?: number;
+    cfgScale?: number;
+    seed?: number;
+    quantity?: number;
+}
+export interface WorkflowSnapshot {
+    id: string;
+    status: WorkflowStatus;
+    cost?: {
+        total?: number;
+    };
+    steps?: Array<{
+        output?: {
+            /** Canonical image array. Each item has `url` + `available: boolean`. */
+            images?: Array<{
+                url?: string;
+                available?: boolean;
+            }>;
+            /** Legacy/alternative — some workflow types still emit `blobs[]`. */
+            blobs?: Array<{
+                url?: string;
+                type?: string;
+                mimeType?: string;
+            }>;
+        };
+    }>;
+    [key: string]: unknown;
+}
+/**
+ * Minimal orchestrator client config — just the base URL and the user's
+ * access token. Build one with {@link createOrchestratorClient} and pass it
+ * to the per-call helpers below.
+ */
+export interface OrchestratorClient {
+    baseUrl: string;
+    accessToken: string;
+}
+export declare class OrchestratorError extends Error {
+    readonly status: number;
+    readonly body: unknown;
+    readonly name = "OrchestratorError";
+    constructor(message: string, status: number, body: unknown);
+}
+export interface CreateOrchestratorClientOptions {
+    /** OAuth access token (or personal API key — same Bearer scheme). */
+    accessToken: string;
+    /** Orchestrator base URL. Defaults to Civitai's prod orchestrator. */
+    baseUrl?: string;
+}
+export declare function createOrchestratorClient(opts: CreateOrchestratorClientOptions): OrchestratorClient;
+/**
+ * Internal raw-fetch helper. Logs the failing response to console.error and
+ * throws {@link OrchestratorError} on non-2xx. Exported so callers can build
+ * their own orchestrator routes without duplicating this code.
+ */
+export declare function callOrchestrator(client: OrchestratorClient, path: string, init?: RequestInit): Promise<unknown>;
+export interface BuildTextToImageBodyOptions {
+    /** Optional workflow tags — useful for attribution / debugging. */
+    tags?: string[];
+}
+/**
+ * Build a `textToImage` workflow body from a {@link GenerateInput}. Mirrors
+ * the shape every starter's existing `buildWorkflowBody` produced.
+ */
+export declare function buildTextToImageBody(input: GenerateInput, opts?: BuildTextToImageBodyOptions): unknown;
+/**
+ * Cost preview ("what if") — runs the workflow validation/pricing pipeline
+ * without committing any Buzz.
+ */
+export declare function estimateWorkflow(client: OrchestratorClient, body: unknown): Promise<WorkflowSnapshot>;
+/** Submit a workflow for real execution. Debits the token-owner's Buzz. */
+export declare function submitWorkflow(client: OrchestratorClient, body: unknown): Promise<WorkflowSnapshot>;
+export declare function getWorkflow(client: OrchestratorClient, workflowId: string): Promise<WorkflowSnapshot>;
+export interface PollWorkflowOptions {
+    /** Polling interval in ms. Default 1000. */
+    intervalMs?: number;
+    /** Max total time to poll in ms. Default 30000. */
+    timeoutMs?: number;
+    /** Optional abort signal — checked between ticks. */
+    signal?: AbortSignal;
+}
+/**
+ * Server-side long-poll helper. Re-fetches the workflow every `intervalMs`
+ * until it reaches a terminal status, the timeout elapses, or the signal
+ * aborts. Returns the latest snapshot regardless of which condition tripped —
+ * callers inspect {@link isTerminal} on the result to decide what to do.
+ */
+export declare function pollWorkflow(client: OrchestratorClient, workflowId: string, opts?: PollWorkflowOptions): Promise<WorkflowSnapshot>;
+export declare function isTerminal(snap: WorkflowSnapshot | null | undefined): boolean;
+/** Pull every available image URL out of a workflow snapshot. */
+export declare function extractImageUrls(snap: WorkflowSnapshot | null | undefined): string[];
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/orchestrator/index.js

@@ -0,0 +1,155 @@
+/**
+ * Orchestrator glue — types, constants, and fetch-based helpers shared by every
+ * starter's BFF. Client + server safe: no Node-only imports, no `process.env`
+ * access. All configuration flows through the `OrchestratorClient` value that
+ * the caller builds.
+ */
+// ---------- Constants -------------------------------------------------------
+export const DEFAULT_ORCHESTRATOR_BASE_URL = 'https://orchestration.civitai.com';
+/** Default SDXL base model. Replace per starter / per call as needed. */
+export const DEFAULT_MODEL_AIR = 'urn:air:sdxl:checkpoint:civitai:101055@128078';
+/**
+ * Terminal orchestrator statuses (lowercase — matches what the API returns).
+ */
+export const TERMINAL_STATUSES = ['succeeded', 'failed', 'expired', 'canceled'];
+export class OrchestratorError extends Error {
+    status;
+    body;
+    name = 'OrchestratorError';
+    constructor(message, status, body) {
+        super(message);
+        this.status = status;
+        this.body = body;
+    }
+}
+export function createOrchestratorClient(opts) {
+    return {
+        baseUrl: opts.baseUrl ?? DEFAULT_ORCHESTRATOR_BASE_URL,
+        accessToken: opts.accessToken,
+    };
+}
+// ---------- Raw HTTP --------------------------------------------------------
+/**
+ * Internal raw-fetch helper. Logs the failing response to console.error and
+ * throws {@link OrchestratorError} on non-2xx. Exported so callers can build
+ * their own orchestrator routes without duplicating this code.
+ */
+export async function callOrchestrator(client, path, init = {}) {
+    const { headers, ...rest } = init;
+    const res = await fetch(`${client.baseUrl}${path}`, {
+        ...rest,
+        headers: {
+            'content-type': 'application/json',
+            Authorization: `Bearer ${client.accessToken}`,
+            ...headers,
+        },
+    });
+    const text = await res.text();
+    let body = null;
+    try {
+        body = text ? JSON.parse(text) : null;
+    }
+    catch {
+        body = text;
+    }
+    if (!res.ok) {
+        console.error(`[orchestrator] ${init.method ?? 'GET'} ${path} -> ${res.status} ${res.statusText}\n` +
+            `  raw body: ${text.length ? text.slice(0, 500) : '(empty)'}`);
+        throw new OrchestratorError(`HTTP ${res.status}`, res.status, body);
+    }
+    return body;
+}
+/**
+ * Build a `textToImage` workflow body from a {@link GenerateInput}. Mirrors
+ * the shape every starter's existing `buildWorkflowBody` produced.
+ */
+export function buildTextToImageBody(input, opts = {}) {
+    const body = {
+        steps: [
+            {
+                $type: 'textToImage',
+                name: 'step_0',
+                timeout: '00:10:00',
+                input: {
+                    prompt: input.prompt,
+                    negativePrompt: input.negativePrompt,
+                    model: input.model ?? DEFAULT_MODEL_AIR,
+                    width: input.width ?? 1024,
+                    height: input.height ?? 1024,
+                    steps: input.steps ?? 25,
+                    cfgScale: input.cfgScale ?? 5,
+                    seed: input.seed,
+                    quantity: input.quantity ?? 1,
+                },
+            },
+        ],
+    };
+    if (opts.tags && opts.tags.length > 0)
+        body.tags = opts.tags;
+    return body;
+}
+// ---------- Workflow endpoints ---------------------------------------------
+/**
+ * Cost preview ("what if") — runs the workflow validation/pricing pipeline
+ * without committing any Buzz.
+ */
+export function estimateWorkflow(client, body) {
+    return callOrchestrator(client, '/v2/consumer/workflows?whatif=true', {
+        method: 'POST',
+        body: JSON.stringify(body),
+    });
+}
+/** Submit a workflow for real execution. Debits the token-owner's Buzz. */
+export function submitWorkflow(client, body) {
+    return callOrchestrator(client, '/v2/consumer/workflows', {
+        method: 'POST',
+        body: JSON.stringify(body),
+    });
+}
+export function getWorkflow(client, workflowId) {
+    return callOrchestrator(client, `/v2/consumer/workflows/${encodeURIComponent(workflowId)}`, { method: 'GET' });
+}
+/**
+ * Server-side long-poll helper. Re-fetches the workflow every `intervalMs`
+ * until it reaches a terminal status, the timeout elapses, or the signal
+ * aborts. Returns the latest snapshot regardless of which condition tripped —
+ * callers inspect {@link isTerminal} on the result to decide what to do.
+ */
+export async function pollWorkflow(client, workflowId, opts = {}) {
+    const interval = opts.intervalMs ?? 1000;
+    const timeout = opts.timeoutMs ?? 30_000;
+    const deadline = Date.now() + timeout;
+    let snapshot = await getWorkflow(client, workflowId);
+    while (!isTerminal(snapshot) && Date.now() + interval <= deadline) {
+        if (opts.signal?.aborted)
+            break;
+        await new Promise((r) => setTimeout(r, interval));
+        snapshot = await getWorkflow(client, workflowId);
+    }
+    return snapshot;
+}
+// ---------- Snapshot inspection --------------------------------------------
+export function isTerminal(snap) {
+    if (!snap?.status)
+        return false;
+    return TERMINAL_STATUSES.includes(String(snap.status));
+}
+/** Pull every available image URL out of a workflow snapshot. */
+export function extractImageUrls(snap) {
+    if (!snap?.steps)
+        return [];
+    const out = [];
+    for (const step of snap.steps) {
+        for (const img of step.output?.images ?? []) {
+            if (img.available && img.url)
+                out.push(img.url);
+        }
+        for (const blob of step.output?.blobs ?? []) {
+            if (blob.url && (blob.mimeType ?? blob.type ?? '').startsWith('image/')) {
+                out.push(blob.url);
+            }
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=index.js.map

package/dist/orchestrator/index.js.map

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

package/dist/scopes/index.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Token Scope — Bitwise flags for API key and OAuth token permissions.
+ *
+ * Each scope is a power of 2 so they can be combined with bitwise OR.
+ * Use `hasScope(tokenScope, TokenScope.ModelsWrite)` to check.
+ *
+ * Buzz spending is implicit in the scopes that require it:
+ *  - AIServicesWrite (generation, training, scanning)
+ *  - BountiesWrite (bounty creation)
+ *  - SocialTip (tipping)
+ */
+export declare const TokenScope: {
+    readonly None: 0;
+    readonly UserRead: number;
+    readonly UserWrite: number;
+    readonly ModelsRead: number;
+    readonly ModelsWrite: number;
+    readonly ModelsDelete: number;
+    readonly MediaRead: number;
+    readonly MediaWrite: number;
+    readonly MediaDelete: number;
+    readonly ArticlesRead: number;
+    readonly ArticlesWrite: number;
+    readonly ArticlesDelete: number;
+    readonly BountiesRead: number;
+    readonly BountiesWrite: number;
+    readonly BountiesDelete: number;
+    readonly AIServicesRead: number;
+    readonly AIServicesWrite: number;
+    readonly BuzzRead: number;
+    readonly CollectionsRead: number;
+    readonly CollectionsWrite: number;
+    readonly SocialWrite: number;
+    readonly SocialTip: number;
+    readonly NotificationsRead: number;
+    readonly NotificationsWrite: number;
+    readonly VaultRead: number;
+    readonly VaultWrite: number;
+    readonly Full: number;
+};
+export type TokenScopeKey = Exclude<keyof typeof TokenScope, 'None' | 'Full'>;
+export type TokenScopeValue = (typeof TokenScope)[keyof typeof TokenScope];
+export declare const tokenScopeLabels: Record<number, string>;
+export declare const TokenScopePresets: {
+    readonly ReadOnly: number;
+    readonly Creator: number;
+    readonly AIServices: number;
+    readonly Full: number;
+};
+export type TokenScopePresetKey = keyof typeof TokenScopePresets;
+/** True if the given bitmask grants the named scope. */
+export declare function hasScope(bitmask: number, scope: number): boolean;
+/** Return the list of named scopes contained in a bitmask. */
+export declare function scopesFromBitmask(bitmask: number): TokenScopeKey[];
+/** Combine a list of named scopes into a single bitmask. */
+export declare function bitmaskFromScopes(scopes: readonly TokenScopeKey[]): number;
+/** Human-readable label for a tokenScope bitmask (matches the Civitai UI). */
+export declare function getScopeLabel(tokenScope: number | null | undefined): string;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/scopes/index.ts"],"names":[],"mappings":"AASA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmDb,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,OAAO,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;AAC9E,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC;AAE3E,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA0BnD,CAAC;AAEF,eAAO,MAAM,iBAAiB;;;;;CA+BpB,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG,MAAM,OAAO,iBAAiB,CAAC;AAEjE,wDAAwD;AACxD,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAEhE;AAED,8DAA8D;AAC9D,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,EAAE,CASlE;AAED,4DAA4D;AAC5D,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,GAAG,MAAM,CAI1E;AAED,8EAA8E;AAC9E,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAO3E"}

package/dist/scopes/index.js

@@ -0,0 +1,155 @@
+// TODO(scopes-codegen): Replace this hand-copied file with a build-time
+// codegen step that fetches scope metadata from
+// `${CIVITAI_BASE_URL}/.well-known/openid-configuration` (and/or a
+// scopes-specific endpoint). The discovery endpoint already exposes scope
+// values; once Civitai publishes a stable scope-label feed we can drop the
+// labels copy too. Until then this file is the source of truth for the SDK
+// and must stay in sync with `src/shared/constants/token-scope.constants.ts`
+// in the main `civitai/civitai` repo.
+/**
+ * Token Scope — Bitwise flags for API key and OAuth token permissions.
+ *
+ * Each scope is a power of 2 so they can be combined with bitwise OR.
+ * Use `hasScope(tokenScope, TokenScope.ModelsWrite)` to check.
+ *
+ * Buzz spending is implicit in the scopes that require it:
+ *  - AIServicesWrite (generation, training, scanning)
+ *  - BountiesWrite (bounty creation)
+ *  - SocialTip (tipping)
+ */
+export const TokenScope = {
+    None: 0,
+    // Account & Profile
+    UserRead: 1 << 0,
+    UserWrite: 1 << 1,
+    // Models & Resources
+    ModelsRead: 1 << 2,
+    ModelsWrite: 1 << 3,
+    ModelsDelete: 1 << 4,
+    // Media & Posts (images, videos, posts)
+    MediaRead: 1 << 5,
+    MediaWrite: 1 << 6,
+    MediaDelete: 1 << 7,
+    // Articles
+    ArticlesRead: 1 << 8,
+    ArticlesWrite: 1 << 9,
+    ArticlesDelete: 1 << 10,
+    // Bounties (write implicitly allows buzz spend for bounty creation)
+    BountiesRead: 1 << 11,
+    BountiesWrite: 1 << 12,
+    BountiesDelete: 1 << 13,
+    // AI Services — generation, training, scanning, all orchestrator requests
+    // Write implicitly allows buzz spend for orchestrator usage
+    AIServicesRead: 1 << 14,
+    AIServicesWrite: 1 << 15,
+    // Buzz (Currency)
+    BuzzRead: 1 << 16,
+    // Collections & Interactions
+    CollectionsRead: 1 << 17,
+    CollectionsWrite: 1 << 18,
+    SocialWrite: 1 << 19,
+    SocialTip: 1 << 20,
+    // Notifications
+    NotificationsRead: 1 << 21,
+    NotificationsWrite: 1 << 22,
+    // Vault
+    VaultRead: 1 << 23,
+    VaultWrite: 1 << 24,
+    // All scopes
+    Full: (1 << 25) - 1,
+};
+export const tokenScopeLabels = {
+    [TokenScope.UserRead]: 'Read profile & settings',
+    [TokenScope.UserWrite]: 'Update profile & settings',
+    [TokenScope.ModelsRead]: 'Browse & download models',
+    [TokenScope.ModelsWrite]: 'Upload & edit models',
+    [TokenScope.ModelsDelete]: 'Delete models',
+    [TokenScope.MediaRead]: 'View images, videos & posts',
+    [TokenScope.MediaWrite]: 'Upload media & create posts',
+    [TokenScope.MediaDelete]: 'Delete media & posts',
+    [TokenScope.ArticlesRead]: 'Read articles',
+    [TokenScope.ArticlesWrite]: 'Create & edit articles',
+    [TokenScope.ArticlesDelete]: 'Delete articles',
+    [TokenScope.BountiesRead]: 'View bounties',
+    [TokenScope.BountiesWrite]: 'Create & manage bounties',
+    [TokenScope.BountiesDelete]: 'Delete bounties',
+    [TokenScope.AIServicesRead]: 'View generation & training history',
+    [TokenScope.AIServicesWrite]: 'Generate, train & scan',
+    [TokenScope.BuzzRead]: 'View buzz balance & history',
+    [TokenScope.CollectionsRead]: 'View collections',
+    [TokenScope.CollectionsWrite]: 'Manage collections',
+    [TokenScope.SocialWrite]: 'Follow, react, comment & review',
+    [TokenScope.SocialTip]: 'Tip other users',
+    [TokenScope.NotificationsRead]: 'Read notifications',
+    [TokenScope.NotificationsWrite]: 'Manage notification preferences',
+    [TokenScope.VaultRead]: 'View vault',
+    [TokenScope.VaultWrite]: 'Manage vault',
+};
+export const TokenScopePresets = {
+    ReadOnly: TokenScope.UserRead |
+        TokenScope.ModelsRead |
+        TokenScope.MediaRead |
+        TokenScope.ArticlesRead |
+        TokenScope.BountiesRead |
+        TokenScope.BuzzRead |
+        TokenScope.CollectionsRead |
+        TokenScope.AIServicesRead |
+        TokenScope.NotificationsRead |
+        TokenScope.VaultRead,
+    Creator: TokenScope.UserRead |
+        TokenScope.ModelsRead |
+        TokenScope.MediaRead |
+        TokenScope.ArticlesRead |
+        TokenScope.BountiesRead |
+        TokenScope.BuzzRead |
+        TokenScope.CollectionsRead |
+        TokenScope.AIServicesRead |
+        TokenScope.NotificationsRead |
+        TokenScope.VaultRead |
+        TokenScope.ModelsWrite |
+        TokenScope.MediaWrite |
+        TokenScope.ArticlesWrite |
+        TokenScope.BountiesWrite |
+        TokenScope.CollectionsWrite |
+        TokenScope.SocialWrite,
+    AIServices: TokenScope.AIServicesWrite | TokenScope.AIServicesRead | TokenScope.BuzzRead,
+    Full: TokenScope.Full,
+};
+/** True if the given bitmask grants the named scope. */
+export function hasScope(bitmask, scope) {
+    return (bitmask & scope) === scope;
+}
+/** Return the list of named scopes contained in a bitmask. */
+export function scopesFromBitmask(bitmask) {
+    const out = [];
+    for (const [name, bit] of Object.entries(TokenScope)) {
+        if (name === 'None' || name === 'Full')
+            continue;
+        if (typeof bit === 'number' && bit !== 0 && (bitmask & bit) === bit) {
+            out.push(name);
+        }
+    }
+    return out;
+}
+/** Combine a list of named scopes into a single bitmask. */
+export function bitmaskFromScopes(scopes) {
+    let mask = 0;
+    for (const s of scopes)
+        mask |= TokenScope[s];
+    return mask;
+}
+/** Human-readable label for a tokenScope bitmask (matches the Civitai UI). */
+export function getScopeLabel(tokenScope) {
+    if (tokenScope == null)
+        return 'Legacy';
+    if (tokenScope === TokenScope.Full)
+        return 'Full Access';
+    if (tokenScope === TokenScopePresets.ReadOnly)
+        return 'Read Only';
+    if (tokenScope === TokenScopePresets.Creator)
+        return 'Creator';
+    if (tokenScope === TokenScopePresets.AIServices)
+        return 'AI Services';
+    return 'Custom';
+}
+//# sourceMappingURL=index.js.map

package/dist/scopes/index.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,21 @@
+export interface OAuthTokens {
+    access_token: string;
+    refresh_token?: string;
+    expires_at: number;
+    scope: number;
+    token_type?: string;
+}
+export interface OAuthTokenResponse {
+    access_token: string;
+    refresh_token?: string;
+    expires_in?: number;
+    scope?: string | number;
+    token_type?: string;
+}
+export interface OAuthClientConfig {
+    clientId: string;
+    clientSecret?: string;
+    redirectUri: string;
+    baseUrl?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/dist/workflows/index.d.ts

@@ -0,0 +1,52 @@
+import { type SubmitWorkflowData, type Workflow } from '@civitai/client';
+import type { AppClient } from '../client/index.js';
+/**
+ * Thin wrappers around the orchestrator's workflow endpoints with conventions
+ * suited to third-party app starters. All calls use the user's OAuth token
+ * (or API key) carried by the `AppClient` — the orchestrator debits Buzz
+ * from whoever owns that token.
+ */
+export type WorkflowBody = NonNullable<SubmitWorkflowData['body']>;
+export interface CostEstimate {
+    /** Buzz cost. Pulled from the workflow's `cost.total` field. */
+    total: number;
+    /** Full workflow response (validation result, queue placement, etc.). */
+    raw: Workflow;
+}
+declare class WorkflowError extends Error {
+    readonly status: number | undefined;
+    readonly detail: unknown;
+    readonly name = "WorkflowError";
+    constructor(message: string, status: number | undefined, detail: unknown);
+}
+/**
+ * Cost preview ("what if") — runs the workflow validation/pricing pipeline
+ * without committing any Buzz. Use this to show the user "this will cost X
+ * Buzz" before they confirm submission.
+ *
+ * NOTE: per Civitai's docs, `whatif=true` validates and prices but does not
+ * apply per-app spending caps to the response — a successful whatif can still
+ * be denied at submit time if the user has set tight caps or insufficient
+ * funds. Treat `whatif` as "this is the price" not "this is approved."
+ */
+export declare function estimateCost(client: AppClient, body: WorkflowBody): Promise<CostEstimate>;
+/** Submit a workflow for real execution. Debits the token-owner's Buzz. */
+export declare function submitWorkflow(client: AppClient, body: WorkflowBody): Promise<Workflow>;
+export declare function getWorkflow(client: AppClient, workflowId: string): Promise<Workflow>;
+export interface PollWorkflowOptions {
+    /** Polling interval in ms. Default 2000. */
+    intervalMs?: number;
+    /** Max total time to poll in ms. Default 5 minutes. */
+    timeoutMs?: number;
+    /** Optional progress callback fired on every poll tick. */
+    onTick?: (snapshot: Workflow) => void;
+    /** Optional abort signal. */
+    signal?: AbortSignal;
+}
+/**
+ * Poll a workflow until it reaches a terminal status (`Succeeded`, `Failed`,
+ * `Canceled`) or the timeout elapses. Returns the final snapshot.
+ */
+export declare function pollWorkflow(client: AppClient, workflowId: string, opts?: PollWorkflowOptions): Promise<Workflow>;
+export { WorkflowError };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/workflows/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,kBAAkB,EACvB,KAAK,QAAQ,EACd,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD;;;;;GAKG;AAEH,MAAM,MAAM,YAAY,GAAG,WAAW,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC;AAEnE,MAAM,WAAW,YAAY;IAC3B,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,GAAG,EAAE,QAAQ,CAAC;CACf;AAED,cAAM,aAAc,SAAQ,KAAK;IAI7B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS;IACnC,QAAQ,CAAC,MAAM,EAAE,OAAO;IAJ1B,SAAkB,IAAI,mBAAmB;gBAEvC,OAAO,EAAE,MAAM,EACN,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,MAAM,EAAE,OAAO;CAI3B;AAkBD;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAQ/F;AAED,2EAA2E;AAC3E,wBAAsB,cAAc,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,CAG7F;AAED,wBAAsB,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAM1F;AAED,MAAM,WAAW,mBAAmB;IAClC,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,CAAC;IACtC,6BAA6B;IAC7B,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAID;;;GAGG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,SAAS,EACjB,UAAU,EAAE,MAAM,EAClB,IAAI,GAAE,mBAAwB,GAC7B,OAAO,CAAC,QAAQ,CAAC,CAmBnB;AAED,OAAO,EAAE,aAAa,EAAE,CAAC"}