optio-api 0.1.0

package/dist/handlers.d.ts

@@ -0,0 +1,110 @@
+import type { ProcessMetadataFilter } from './types.js';
+import type { OptioContext } from './context.js';
+import type { LaunchFailureReason as LaunchFailureReasonType, CancelFailureReason as CancelFailureReasonType, DismissFailureReason as DismissFailureReasonType } from 'optio-contracts';
+export interface ListQuery {
+    cursor?: string;
+    limit: number;
+    rootId?: string;
+    state?: string;
+    metadataFilter?: ProcessMetadataFilter;
+}
+export interface ListProcessesQuery extends ListQuery {
+    database?: string;
+    prefix?: string;
+}
+export declare function listProcesses(ctx: OptioContext, query: ListProcessesQuery): Promise<{
+    items: {
+        _id: any;
+        parentId: any;
+        rootId: any;
+    }[];
+    nextCursor: string | null;
+    totalCount: number;
+}>;
+export declare function getProcess(ctx: OptioContext, query: {
+    database?: string;
+    prefix?: string;
+}, id: string): Promise<{
+    _id: any;
+    parentId: any;
+    rootId: any;
+} | null>;
+export declare function getProcessTree(ctx: OptioContext, query: {
+    database?: string;
+    prefix?: string;
+    maxDepth?: number;
+}, id: string): Promise<any>;
+export interface PaginationQuery {
+    cursor?: string;
+    limit: number;
+}
+export interface GetProcessLogQuery extends PaginationQuery {
+    database?: string;
+    prefix?: string;
+}
+export declare function getProcessLog(ctx: OptioContext, query: GetProcessLogQuery, id: string): Promise<{
+    items: any;
+    nextCursor: string | null;
+    totalCount: any;
+} | null>;
+export interface TreeLogQuery extends PaginationQuery {
+    maxDepth?: number;
+}
+export interface GetProcessTreeLogQuery extends TreeLogQuery {
+    database?: string;
+    prefix?: string;
+}
+export declare function getProcessTreeLog(ctx: OptioContext, query: GetProcessTreeLogQuery, id: string): Promise<{
+    items: any[];
+    nextCursor: string | null;
+    totalCount: number;
+} | null>;
+export type LaunchCommandResult = {
+    status: 200;
+    body: any;
+} | {
+    status: 404 | 409;
+    body: {
+        reason: LaunchFailureReasonType;
+        message: string;
+    };
+};
+export type CancelCommandResult = {
+    status: 200;
+    body: any;
+} | {
+    status: 404 | 409;
+    body: {
+        reason: CancelFailureReasonType;
+        message: string;
+    };
+};
+export type DismissCommandResult = {
+    status: 200;
+    body: any;
+} | {
+    status: 404 | 409;
+    body: {
+        reason: DismissFailureReasonType;
+        message: string;
+    };
+};
+export declare function launchProcess(ctx: OptioContext, query: {
+    database?: string;
+    prefix?: string;
+}, id: string, resume?: boolean): Promise<LaunchCommandResult>;
+export declare function cancelProcess(ctx: OptioContext, query: {
+    database?: string;
+    prefix?: string;
+}, id: string): Promise<CancelCommandResult>;
+export declare function dismissProcess(ctx: OptioContext, query: {
+    database?: string;
+    prefix?: string;
+}, id: string): Promise<DismissCommandResult>;
+export declare function resyncProcesses(ctx: OptioContext, query: {
+    database?: string;
+    prefix?: string;
+}, clean?: boolean, metadataFilter?: ProcessMetadataFilter): Promise<{
+    message: string;
+}>;
+//# sourceMappingURL=handlers.d.ts.map

package/dist/handlers.d.ts.map

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

package/dist/handlers.js

@@ -0,0 +1,188 @@
+import { ObjectId } from 'mongodb';
+import { metadataFilterToMongo } from './metadata-filter-query.js';
+import { findProcessByEitherId } from './process-id-resolver.js';
+import { resolveDb, resolveOptioEngine } from './resolve.js';
+function col(db, prefix) {
+    return db.collection(`${prefix}_processes`);
+}
+function stripServerSideFields(proc) {
+    const { widgetUpstream: _omit, ...rest } = proc;
+    return rest;
+}
+function toResponse(proc) {
+    const stripped = stripServerSideFields(proc);
+    return {
+        ...stripped,
+        _id: proc._id.toString(),
+        parentId: proc.parentId?.toString(),
+        rootId: proc.rootId.toString(),
+    };
+}
+export async function listProcesses(ctx, query) {
+    const { db, prefix } = resolveDb(ctx.dbOpts, query);
+    const { cursor, limit, rootId, state, metadataFilter } = query;
+    const filter = {
+        ...metadataFilterToMongo(metadataFilter),
+    };
+    if (rootId)
+        filter.rootId = new ObjectId(rootId);
+    if (state)
+        filter['status.state'] = state;
+    if (cursor)
+        filter._id = { $gt: new ObjectId(cursor) };
+    const [items, totalCount] = await Promise.all([
+        col(db, prefix).find(filter).sort({ _id: 1 }).limit(limit + 1).toArray(),
+        col(db, prefix).countDocuments(filter),
+    ]);
+    const hasNext = items.length > limit;
+    if (hasNext)
+        items.pop();
+    return {
+        items: items.map(toResponse),
+        nextCursor: hasNext ? items[items.length - 1]._id.toString() : null,
+        totalCount,
+    };
+}
+export async function getProcess(ctx, query, id) {
+    const { db, prefix } = resolveDb(ctx.dbOpts, query);
+    const proc = await findProcessByEitherId(col(db, prefix), id);
+    if (!proc)
+        return null;
+    return toResponse(proc);
+}
+async function buildTree(db, prefix, processId, maxDepth, currentDepth = 0) {
+    const proc = await col(db, prefix).findOne({ _id: processId });
+    if (!proc)
+        return null;
+    let children = [];
+    if (maxDepth === undefined || currentDepth < maxDepth) {
+        const childDocs = await col(db, prefix)
+            .find({ parentId: processId })
+            .sort({ order: 1 })
+            .toArray();
+        children = await Promise.all(childDocs.map((c) => buildTree(db, prefix, c._id, maxDepth, currentDepth + 1)));
+        children = children.filter(Boolean);
+    }
+    const stripped = stripServerSideFields(proc);
+    return {
+        ...stripped,
+        _id: proc._id.toString(),
+        parentId: proc.parentId?.toString(),
+        rootId: proc.rootId.toString(),
+        progress: proc.progress,
+        children,
+    };
+}
+export async function getProcessTree(ctx, query, id) {
+    const { db, prefix } = resolveDb(ctx.dbOpts, query);
+    // Resolve the entry-point doc first so we can accept either id form.
+    // Internal recursion in `buildTree` walks via `parentId` ObjectId
+    // references and does not need the lookup helper.
+    const entry = await findProcessByEitherId(col(db, prefix), id);
+    if (!entry)
+        return null;
+    return buildTree(db, prefix, entry._id, query.maxDepth);
+}
+export async function getProcessLog(ctx, query, id) {
+    const { db, prefix } = resolveDb(ctx.dbOpts, query);
+    const proc = await findProcessByEitherId(col(db, prefix), id);
+    if (!proc)
+        return null;
+    const { cursor, limit } = query;
+    const startIdx = cursor ? parseInt(cursor, 10) : 0;
+    const logSlice = proc.log.slice(startIdx, startIdx + limit + 1);
+    const hasNext = logSlice.length > limit;
+    if (hasNext)
+        logSlice.pop();
+    return {
+        items: logSlice,
+        nextCursor: hasNext ? String(startIdx + limit) : null,
+        totalCount: proc.log.length,
+    };
+}
+export async function getProcessTreeLog(ctx, query, id) {
+    const { db, prefix } = resolveDb(ctx.dbOpts, query);
+    const proc = await findProcessByEitherId(col(db, prefix), id);
+    if (!proc)
+        return null;
+    const { maxDepth, cursor, limit } = query;
+    const filter = { rootId: proc.rootId };
+    if (maxDepth !== undefined) {
+        filter.depth = { $lte: proc.depth + maxDepth };
+    }
+    const allProcs = await col(db, prefix).find(filter).toArray();
+    const allLogs = allProcs.flatMap((p) => p.log.map((entry) => ({
+        ...entry,
+        processId: p._id.toString(),
+        processLabel: p.name,
+    })));
+    allLogs.sort((a, b) => new Date(a.timestamp).getTime() - new Date(b.timestamp).getTime());
+    const startIdx = cursor ? parseInt(cursor, 10) : 0;
+    const logSlice = allLogs.slice(startIdx, startIdx + limit + 1);
+    const hasNext = logSlice.length > limit;
+    if (hasNext)
+        logSlice.pop();
+    return {
+        items: logSlice,
+        nextCursor: hasNext ? String(startIdx + limit) : null,
+        totalCount: allLogs.length,
+    };
+}
+const LAUNCH_STATUS = {
+    'not-found': 404,
+    'not-launchable': 409,
+    'no-resume-support': 409,
+    'launch-blocked': 409,
+};
+const CANCEL_STATUS = {
+    'not-found': 404,
+    'not-cancellable': 409,
+};
+const DISMISS_STATUS = {
+    'not-found': 404,
+    'not-dismissable': 409,
+};
+const MESSAGES = {
+    'not-found': 'Process not found',
+    'not-launchable': 'Process is not in a launchable state',
+    'no-resume-support': 'This task does not support resume',
+    'launch-blocked': 'Launches matching this filter are currently blocked',
+    'not-cancellable': 'Process is not cancellable in its current state',
+    'not-dismissable': 'Process is not in a dismissable state',
+};
+function launchFail(reason) {
+    return { status: LAUNCH_STATUS[reason], body: { reason, message: MESSAGES[reason] } };
+}
+function cancelFail(reason) {
+    return { status: CANCEL_STATUS[reason], body: { reason, message: MESSAGES[reason] } };
+}
+function dismissFail(reason) {
+    return { status: DISMISS_STATUS[reason], body: { reason, message: MESSAGES[reason] } };
+}
+export async function launchProcess(ctx, query, id, resume = false) {
+    const engine = resolveOptioEngine(ctx, query);
+    const result = await engine.launch({ processId: id, resume });
+    if (result.ok)
+        return { status: 200, body: toResponse(result.process) };
+    return launchFail(result.reason);
+}
+export async function cancelProcess(ctx, query, id) {
+    const engine = resolveOptioEngine(ctx, query);
+    const result = await engine.cancel({ processId: id });
+    if (result.ok)
+        return { status: 200, body: toResponse(result.process) };
+    return cancelFail(result.reason);
+}
+export async function dismissProcess(ctx, query, id) {
+    const engine = resolveOptioEngine(ctx, query);
+    const result = await engine.dismiss({ processId: id });
+    if (result.ok)
+        return { status: 200, body: toResponse(result.process) };
+    return dismissFail(result.reason);
+}
+export async function resyncProcesses(ctx, query, clean = false, metadataFilter) {
+    const engine = resolveOptioEngine(ctx, query);
+    await engine.resync({ clean, metadataFilter });
+    return { message: clean ? 'Nuke and resync requested' : 'Resync requested' };
+}
+//# sourceMappingURL=handlers.js.map

package/dist/handlers.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { listProcesses, getProcess, getProcessTree, getProcessLog, getProcessTreeLog, launchProcess, cancelProcess, dismissProcess, resyncProcesses, type ListQuery, type PaginationQuery, type TreeLogQuery, type LaunchCommandResult, type CancelCommandResult, type DismissCommandResult, } from './handlers.js';
+export type { ProcessMetadataFilter } from './types.js';
+export { createListPoller, createTreePoller, type StreamPollerOptions, type TreePollerOptions, type ListPollerHandle } from './stream-poller.js';
+export { discoverInstances } from './discovery.js';
+export { resolveDb, resolveOptioEngine, type DbOptions, type SingleDbOptions, type MultiDbOptions } from './resolve.js';
+export { parseMetadataFilterQuery, metadataFilterToMongo, detectLegacyMetadataParams, formatLegacyMetadataMessage, type ParseResult, } from './metadata-filter-query.js';
+export { OptioEngineClient } from './_generated/optio-engine.js';
+export { createOptioTransports, type OptioTransports } from './optio-transports.js';
+export { createOptioContext, type OptioContext } from './context.js';
+//# 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,OAAO,EACL,aAAa,EACb,UAAU,EACV,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,cAAc,EACd,eAAe,EACf,KAAK,SAAS,EACd,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,GAC1B,MAAM,eAAe,CAAC;AAEvB,YAAY,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAGxD,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,KAAK,mBAAmB,EAAE,KAAK,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGjJ,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,KAAK,SAAS,EAAE,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAGxH,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,0BAA0B,EAC1B,2BAA2B,EAC3B,KAAK,WAAW,GACjB,MAAM,4BAA4B,CAAC;AAWpC,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACpF,OAAO,EAAE,kBAAkB,EAAE,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,22 @@
+// Handlers (framework-agnostic)
+export { listProcesses, getProcess, getProcessTree, getProcessLog, getProcessTreeLog, launchProcess, cancelProcess, dismissProcess, resyncProcesses, } from './handlers.js';
+// Stream poller (for custom adapters)
+export { createListPoller, createTreePoller } from './stream-poller.js';
+// Multi-db discovery
+export { discoverInstances } from './discovery.js';
+export { resolveDb, resolveOptioEngine } from './resolve.js';
+// Metadata filter helpers
+export { parseMetadataFilterQuery, metadataFilterToMongo, detectLegacyMetadataParams, formatLegacyMetadataMessage, } from './metadata-filter-query.js';
+// Engine RPC client + transport cache.
+//
+// Layers (see optio-api/AGENTS.md):
+//  - Layer 1: createOptioTransports / OptioTransports — caches RpcClient
+//    per (database, prefix). Used by RPC-only consumers + adapter authors.
+//  - Layer 2: createOptioContext / OptioContext — wraps Layer 1 + Mongo Db
+//    for HTTP-handler use. Used by HTTP hosts.
+//  - Generated: OptioEngineClient — proxy for the optio-engine clamator
+//    contract; wrap any cached transport: `new OptioEngineClient(transports.get(...))`.
+export { OptioEngineClient } from './_generated/optio-engine.js';
+export { createOptioTransports } from './optio-transports.js';
+export { createOptioContext } from './context.js';
+//# 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,gCAAgC;AAChC,OAAO,EACL,aAAa,EACb,UAAU,EACV,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,cAAc,EACd,eAAe,GAOhB,MAAM,eAAe,CAAC;AAIvB,sCAAsC;AACtC,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAA2E,MAAM,oBAAoB,CAAC;AAEjJ,qBAAqB;AACrB,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAA6D,MAAM,cAAc,CAAC;AAExH,0BAA0B;AAC1B,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,0BAA0B,EAC1B,2BAA2B,GAE5B,MAAM,4BAA4B,CAAC;AAEpC,uCAAuC;AACvC,EAAE;AACF,oCAAoC;AACpC,yEAAyE;AACzE,2EAA2E;AAC3E,2EAA2E;AAC3E,+CAA+C;AAC/C,wEAAwE;AACxE,wFAAwF;AACxF,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAwB,MAAM,uBAAuB,CAAC;AACpF,OAAO,EAAE,kBAAkB,EAAqB,MAAM,cAAc,CAAC"}

package/dist/metadata-filter-query.d.ts

@@ -0,0 +1,13 @@
+import { type ProcessMetadataFilter } from 'optio-contracts';
+export type ParseResult = {
+    ok: true;
+    value: ProcessMetadataFilter | undefined;
+} | {
+    ok: false;
+    error: string;
+};
+export declare function parseMetadataFilterQuery(raw: unknown): ParseResult;
+export declare function metadataFilterToMongo(filter: ProcessMetadataFilter | undefined): Record<string, unknown>;
+export declare function detectLegacyMetadataParams(rawQuery: Record<string, unknown>): string[];
+export declare function formatLegacyMetadataMessage(legacyKeys: string[]): string;
+//# sourceMappingURL=metadata-filter-query.d.ts.map

package/dist/metadata-filter-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata-filter-query.d.ts","sourceRoot":"","sources":["../src/metadata-filter-query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkC,KAAK,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAE7F,MAAM,MAAM,WAAW,GACnB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,qBAAqB,GAAG,SAAS,CAAA;CAAE,GACtD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjC,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,OAAO,GAAG,WAAW,CAelE;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,qBAAqB,GAAG,SAAS,GACxC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAOzB;AAED,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CAItF;AAED,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,CAGxE"}

package/dist/metadata-filter-query.js

@@ -0,0 +1,36 @@
+import { MetadataFilterQueryParamSchema } from 'optio-contracts';
+export function parseMetadataFilterQuery(raw) {
+    if (raw === undefined || raw === null || raw === '') {
+        return { ok: true, value: undefined };
+    }
+    if (typeof raw !== 'string') {
+        return { ok: false, error: 'metadataFilter must be a string' };
+    }
+    const result = MetadataFilterQueryParamSchema.safeParse(raw);
+    if (!result.success) {
+        return {
+            ok: false,
+            error: result.error.issues[0]?.message ?? 'Invalid metadataFilter',
+        };
+    }
+    return { ok: true, value: result.data };
+}
+export function metadataFilterToMongo(filter) {
+    if (!filter)
+        return {};
+    const out = {};
+    for (const [k, v] of Object.entries(filter)) {
+        out[`metadata.${k}`] = v;
+    }
+    return out;
+}
+export function detectLegacyMetadataParams(rawQuery) {
+    return Object.keys(rawQuery)
+        .filter(k => k.startsWith('metadata.'))
+        .sort();
+}
+export function formatLegacyMetadataMessage(legacyKeys) {
+    return `Legacy 'metadata.*' query params are no longer supported. ` +
+        `Use ?metadataFilter=<URL-encoded JSON>. Offending keys: ${legacyKeys.join(', ')}`;
+}
+//# sourceMappingURL=metadata-filter-query.js.map

package/dist/metadata-filter-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata-filter-query.js","sourceRoot":"","sources":["../src/metadata-filter-query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAA8B,MAAM,iBAAiB,CAAC;AAM7F,MAAM,UAAU,wBAAwB,CAAC,GAAY;IACnD,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,EAAE,EAAE,CAAC;QACpD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;IACxC,CAAC;IACD,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,iCAAiC,EAAE,CAAC;IACjE,CAAC;IACD,MAAM,MAAM,GAAG,8BAA8B,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAC7D,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,IAAI,wBAAwB;SACnE,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,MAAyC;IAEzC,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IACvB,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5C,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,QAAiC;IAC1E,OAAO,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC;SACzB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;SACtC,IAAI,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,UAAoB;IAC9D,OAAO,4DAA4D;QACjE,2DAA2D,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AACvF,CAAC"}

package/dist/optio-transports.d.ts

@@ -0,0 +1,8 @@
+import type { Redis } from 'ioredis';
+import type { RpcClientCore } from '@clamator/protocol';
+export interface OptioTransports {
+    get(database: string, prefix: string): RpcClientCore;
+    closeAll(): Promise<void>;
+}
+export declare function createOptioTransports(redis: Redis): OptioTransports;
+//# sourceMappingURL=optio-transports.d.ts.map

package/dist/optio-transports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"optio-transports.d.ts","sourceRoot":"","sources":["../src/optio-transports.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,CAAC;IACrD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAUD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,KAAK,GAAG,eAAe,CA4BnE"}

package/dist/optio-transports.js

@@ -0,0 +1,37 @@
+import { RedisRpcClient } from '@clamator/over-redis';
+// Caches one RpcClientCore (concretely RedisRpcClient) per (database, prefix)
+// pair. Each transport is bound to a unique redis namespace via
+// keyPrefix = `${database}/${prefix}` and can be wrapped by any number of
+// clamator contract clients (OptioEngineClient + custom consumer contracts).
+//
+// Cache is unbounded by design. Multi-db deployments are expected to have a
+// small (~10) number of pairs. If the cache exceeds 100 entries in
+// production, file an issue and revisit eviction strategy.
+export function createOptioTransports(redis) {
+    const map = new Map();
+    return {
+        get(database, prefix) {
+            const key = `${database}/${prefix}`;
+            let rpc = map.get(key);
+            if (!rpc) {
+                rpc = new RedisRpcClient({ redis, keyPrefix: key });
+                rpc.start().catch((err) => {
+                    console.error(`[optio-transports] start failed for ${key}:`, err);
+                });
+                map.set(key, rpc);
+            }
+            return rpc;
+        },
+        async closeAll() {
+            const results = await Promise.allSettled([...map.values()].map((r) => r.stop()));
+            map.clear();
+            const rejections = results
+                .filter((r) => r.status === 'rejected')
+                .map((r) => r.reason);
+            if (rejections.length > 0) {
+                throw new AggregateError(rejections, 'closeAll: some transports failed to stop');
+            }
+        },
+    };
+}
+//# sourceMappingURL=optio-transports.js.map

package/dist/optio-transports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"optio-transports.js","sourceRoot":"","sources":["../src/optio-transports.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAQtD,8EAA8E;AAC9E,gEAAgE;AAChE,0EAA0E;AAC1E,6EAA6E;AAC7E,EAAE;AACF,4EAA4E;AAC5E,mEAAmE;AACnE,2DAA2D;AAC3D,MAAM,UAAU,qBAAqB,CAAC,KAAY;IAChD,MAAM,GAAG,GAAG,IAAI,GAAG,EAAyB,CAAC;IAE7C,OAAO;QACL,GAAG,CAAC,QAAQ,EAAE,MAAM;YAClB,MAAM,GAAG,GAAG,GAAG,QAAQ,IAAI,MAAM,EAAE,CAAC;YACpC,IAAI,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACvB,IAAI,CAAC,GAAG,EAAE,CAAC;gBACT,GAAG,GAAG,IAAI,cAAc,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;gBACpD,GAAG,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;oBACxB,OAAO,CAAC,KAAK,CAAC,uCAAuC,GAAG,GAAG,EAAE,GAAG,CAAC,CAAC;gBACpE,CAAC,CAAC,CAAC;gBACH,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YACpB,CAAC;YACD,OAAO,GAAG,CAAC;QACb,CAAC;QAED,KAAK,CAAC,QAAQ;YACZ,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YACjF,GAAG,CAAC,KAAK,EAAE,CAAC;YACZ,MAAM,UAAU,GAAG,OAAO;iBACvB,MAAM,CAAC,CAAC,CAAC,EAA8B,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,UAAU,CAAC;iBAClE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;YACxB,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC1B,MAAM,IAAI,cAAc,CAAC,UAAU,EAAE,0CAA0C,CAAC,CAAC;YACnF,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/process-id-resolver.d.ts

@@ -0,0 +1,26 @@
+import { type Collection, type Document } from 'mongodb';
+/**
+ * Look up a single process document by either form of identifier the
+ * system uses to refer to it:
+ *
+ *  - The Mongo ObjectId hex string (24 hex chars), matched against `_id`.
+ *  - The application-level `processId` string from `mkPid()`, matched
+ *    against the `processId` field on the document.
+ *
+ * Both fields live on every process row. The `processId` form is what
+ * callers tend to know first (it's deterministic, generated client-side
+ * before the row exists), while `_id` is what mongo assigns when the
+ * row is materialized. Excavator's recipe-debug flow returns the
+ * `processId` string to the frontend at submit time, then frontend code
+ * hands it to optio-ui's `useProcessStream`, which calls into this API.
+ * Without this fallback, the inline `new ObjectId(id)` in the old handlers
+ * threw on the non-hex string and the request 500'd.
+ *
+ * Resolution order: ObjectId form first (cheap, indexed by `_id`), then
+ * `processId` form. The two are disjoint in practice — `mkPid()` output
+ * is much longer than 24 chars and contains underscores — so the order
+ * does not matter for correctness, only for which index is hit on the
+ * common path.
+ */
+export declare function findProcessByEitherId<T extends Document = Document>(col: Collection<T>, id: string): Promise<T | null>;
+//# sourceMappingURL=process-id-resolver.d.ts.map

package/dist/process-id-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-id-resolver.d.ts","sourceRoot":"","sources":["../src/process-id-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,UAAU,EAAE,KAAK,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,qBAAqB,CAAC,CAAC,SAAS,QAAQ,GAAG,QAAQ,EACvE,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,EAClB,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAKnB"}

package/dist/process-id-resolver.js

@@ -0,0 +1,31 @@
+import { ObjectId } from 'mongodb';
+/**
+ * Look up a single process document by either form of identifier the
+ * system uses to refer to it:
+ *
+ *  - The Mongo ObjectId hex string (24 hex chars), matched against `_id`.
+ *  - The application-level `processId` string from `mkPid()`, matched
+ *    against the `processId` field on the document.
+ *
+ * Both fields live on every process row. The `processId` form is what
+ * callers tend to know first (it's deterministic, generated client-side
+ * before the row exists), while `_id` is what mongo assigns when the
+ * row is materialized. Excavator's recipe-debug flow returns the
+ * `processId` string to the frontend at submit time, then frontend code
+ * hands it to optio-ui's `useProcessStream`, which calls into this API.
+ * Without this fallback, the inline `new ObjectId(id)` in the old handlers
+ * threw on the non-hex string and the request 500'd.
+ *
+ * Resolution order: ObjectId form first (cheap, indexed by `_id`), then
+ * `processId` form. The two are disjoint in practice — `mkPid()` output
+ * is much longer than 24 chars and contains underscores — so the order
+ * does not matter for correctness, only for which index is hit on the
+ * common path.
+ */
+export async function findProcessByEitherId(col, id) {
+    if (ObjectId.isValid(id)) {
+        return col.findOne({ _id: new ObjectId(id) });
+    }
+    return col.findOne({ processId: id });
+}
+//# sourceMappingURL=process-id-resolver.js.map

package/dist/process-id-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-id-resolver.js","sourceRoot":"","sources":["../src/process-id-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAkC,MAAM,SAAS,CAAC;AAEnE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,GAAkB,EAClB,EAAU;IAEV,IAAI,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;QACzB,OAAO,GAAG,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,IAAI,QAAQ,CAAC,EAAE,CAAC,EAAS,CAAsB,CAAC;IAC5E,CAAC;IACD,OAAO,GAAG,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,EAAE,EAAS,CAAsB,CAAC;AACpE,CAAC"}

package/dist/resolve.d.ts

@@ -0,0 +1,25 @@
+import type { Db, MongoClient } from 'mongodb';
+import { OptioEngineClient } from './_generated/optio-engine.js';
+import type { OptioContext } from './context.js';
+export interface SingleDbOptions {
+    db: Db;
+    mongoClient?: never;
+}
+export interface MultiDbOptions {
+    mongoClient: MongoClient;
+    db?: never;
+}
+export type DbOptions = SingleDbOptions | MultiDbOptions;
+export declare function resolveDb(opts: DbOptions, query: {
+    database?: string;
+    prefix?: string;
+}): {
+    db: Db;
+    database: string;
+    prefix: string;
+};
+export declare function resolveOptioEngine(ctx: OptioContext, query: {
+    database?: string;
+    prefix?: string;
+}): OptioEngineClient;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,EAAE,CAAC;IACP,WAAW,CAAC,EAAE,KAAK,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,WAAW,CAAC;IACzB,EAAE,CAAC,EAAE,KAAK,CAAC;CACZ;AAED,MAAM,MAAM,SAAS,GAAG,eAAe,GAAG,cAAc,CAAC;AAEzD,wBAAgB,SAAS,CACvB,IAAI,EAAE,SAAS,EACf,KAAK,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5C;IAAE,EAAE,EAAE,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAY9C;AAED,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,YAAY,EACjB,KAAK,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5C,iBAAiB,CAGnB"}

package/dist/resolve.js

@@ -0,0 +1,16 @@
+import { OptioEngineClient } from './_generated/optio-engine.js';
+export function resolveDb(opts, query) {
+    const prefix = query.prefix || 'optio';
+    if ('db' in opts && opts.db) {
+        return { db: opts.db, database: opts.db.databaseName, prefix };
+    }
+    if (!query.database) {
+        throw new Error('database query parameter is required in multi-db mode');
+    }
+    return { db: opts.mongoClient.db(query.database), database: query.database, prefix };
+}
+export function resolveOptioEngine(ctx, query) {
+    const { database, prefix } = resolveDb(ctx.dbOpts, query);
+    return new OptioEngineClient(ctx.transports.get(database, prefix));
+}
+//# sourceMappingURL=resolve.js.map

package/dist/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAejE,MAAM,UAAU,SAAS,CACvB,IAAe,EACf,KAA6C;IAE7C,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,OAAO,CAAC;IAEvC,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;QAC5B,OAAO,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,CAAC;IACjE,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;IAC3E,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,IAAI,CAAC,WAAY,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;AACxF,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,GAAiB,EACjB,KAA6C;IAE7C,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC1D,OAAO,IAAI,iBAAiB,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;AACrE,CAAC"}

package/dist/sse-options.d.ts

@@ -0,0 +1,28 @@
+import type { ProcessMetadataFilter } from './types.js';
+export declare class LegacyMetadataParamError extends Error {
+    readonly keys: string[];
+    constructor(keys: string[]);
+}
+export interface ParsedSseOptions {
+    database?: string;
+    prefix?: string;
+    metadataFilter?: ProcessMetadataFilter;
+    maxDepth?: number;
+}
+/**
+ * Parse SSE/poller query parameters into a typed shape. Throws Error on
+ * invalid `metadataFilter` JSON or on a non-finite/negative `maxDepth`;
+ * adapters should map a thrown Error to a 400 response.
+ *
+ * Does NOT inspect legacy `metadata.*` keys — call
+ * `checkLegacyMetadataParams` separately for that, since adapters want to
+ * distinguish the two error cases.
+ */
+export declare function parseSseOptions(rawQuery: Record<string, unknown>): ParsedSseOptions;
+/**
+ * Throws `LegacyMetadataParamError` if the raw query contains any legacy
+ * `metadata.*` keys (a removed pre-`metadataFilter` API). Adapters catch
+ * this and emit a 400 with the formatted migration message.
+ */
+export declare function checkLegacyMetadataParams(rawQuery: Record<string, unknown>): void;
+//# sourceMappingURL=sse-options.d.ts.map

package/dist/sse-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse-options.d.ts","sourceRoot":"","sources":["../src/sse-options.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD,qBAAa,wBAAyB,SAAQ,KAAK;IACjD,SAAgB,IAAI,EAAE,MAAM,EAAE,CAAC;gBACnB,IAAI,EAAE,MAAM,EAAE;CAK3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,qBAAqB,CAAC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,gBAAgB,CAkClB;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,IAAI,CAKN"}