@treeseed/treedx 0.2.43 → 0.3.0-rc.2

package/README.md

@@ -6,7 +6,7 @@ does not encode TreeSeed product semantics. `packages/trsd-sdk` is a downstream
 TreeSeed consumer/reference only.
 
 The current `sdk-manifest.yaml` reports modules, capabilities, and test roots as
-`implemented`. The SDK exposes all 113 `/api/v1` OpenAPI operations through
+`implemented`. The SDK exposes all 118 `/api/v1` OpenAPI operations through
 first-class module methods and a validated raw operation fallback.
 
 ## Install

package/dist/treedx/adapters/{federation-internal.d.ts → federation/federation-internal.d.ts}

@@ -1,4 +1,4 @@
-import { type TreeDxAdapterContext } from './common.js';
+import { type TreeDxAdapterContext } from '../runtime/common.js';
 export declare class FederationInternalAdapter {
     private readonly context;
     constructor(context: TreeDxAdapterContext);

package/dist/treedx/adapters/{federation-internal.js → federation/federation-internal.js}

@@ -1,4 +1,4 @@
-import { jsonRequest, segment } from './common.js';
+import { jsonRequest, segment } from '../runtime/common.js';
 export class FederationInternalAdapter {
     context;
     constructor(context) {

package/dist/treedx/adapters/{federation.d.ts → federation/federation.d.ts}

@@ -1,4 +1,4 @@
-import { segment, type TreeDxAdapterContext } from './common.js';
+import { segment, type TreeDxAdapterContext } from '../runtime/common.js';
 export declare class FederationAdapter {
     private readonly context;
     constructor(context: TreeDxAdapterContext);

package/dist/treedx/adapters/{federation.js → federation/federation.js}

@@ -1,4 +1,4 @@
-import { jsonRequest, segment } from './common.js';
+import { jsonRequest, segment } from '../runtime/common.js';
 export class FederationAdapter {
     context;
     constructor(context) {

package/dist/treedx/adapters/{mirrors.d.ts → federation/mirrors.d.ts}

@@ -1,4 +1,4 @@
-import { type TreeDxAdapterContext } from './common.js';
+import { type TreeDxAdapterContext } from '../runtime/common.js';
 export declare class MirrorsAdapter {
     private readonly context;
     constructor(context: TreeDxAdapterContext);

package/dist/treedx/adapters/{mirrors.js → federation/mirrors.js}

@@ -1,4 +1,4 @@
-import { jsonRequest, segment } from './common.js';
+import { jsonRequest, segment } from '../runtime/common.js';
 export class MirrorsAdapter {
     context;
     constructor(context) {

package/dist/treedx/adapters/{registry.d.ts → federation/registry.d.ts}

@@ -1,4 +1,4 @@
-import { type TreeDxAdapterContext } from './common.js';
+import { type TreeDxAdapterContext } from '../runtime/common.js';
 export declare class RegistryAdapter {
     private readonly context;
     constructor(context: TreeDxAdapterContext);

package/dist/treedx/adapters/{registry.js → federation/registry.js}

@@ -1,4 +1,4 @@
-import { jsonRequest, segment } from './common.js';
+import { jsonRequest, segment } from '../runtime/common.js';
 export class RegistryAdapter {
     context;
     constructor(context) {

package/dist/treedx/adapters/{repositories.d.ts → federation/repositories.d.ts}

@@ -1,4 +1,4 @@
-import { type TreeDxAdapterContext } from './common.js';
+import { type TreeDxAdapterContext } from '../runtime/common.js';
 export declare class RepositoriesAdapter {
     private readonly context;
     constructor(context: TreeDxAdapterContext);

package/dist/treedx/adapters/{repositories.js → federation/repositories.js}

@@ -1,4 +1,4 @@
-import { jsonRequest, segment } from './common.js';
+import { jsonRequest, segment } from '../runtime/common.js';
 export class RepositoriesAdapter {
     context;
     constructor(context) {

package/dist/treedx/adapters/{workspaces.d.ts → federation/workspaces.d.ts}

@@ -1,4 +1,4 @@
-import { type TreeDxAdapterContext } from './common.js';
+import { type TreeDxAdapterContext } from '../runtime/common.js';
 export declare class WorkspacesAdapter {
     private readonly context;
     constructor(context: TreeDxAdapterContext);

package/dist/treedx/adapters/{workspaces.js → federation/workspaces.js}

@@ -1,4 +1,4 @@
-import { jsonRequest, segment } from './common.js';
+import { jsonRequest, segment } from '../runtime/common.js';
 export class WorkspacesAdapter {
     context;
     constructor(context) {

package/dist/treedx/adapters/{admin.d.ts → governance/admin.d.ts}

@@ -1,4 +1,4 @@
-import { type TreeDxAdapterContext } from './common.js';
+import { type TreeDxAdapterContext } from '../runtime/common.js';
 export declare class AdminAdapter {
     private readonly context;
     constructor(context: TreeDxAdapterContext);

package/dist/treedx/adapters/{admin.js → governance/admin.js}

@@ -1,4 +1,4 @@
-import { jsonRequest } from './common.js';
+import { jsonRequest } from '../runtime/common.js';
 export class AdminAdapter {
     context;
     constructor(context) {

package/dist/treedx/adapters/{audit.d.ts → governance/audit.d.ts}

@@ -1,4 +1,4 @@
-import { type TreeDxAdapterContext } from './common.js';
+import { type TreeDxAdapterContext } from '../runtime/common.js';
 export declare class AuditAdapter {
     private readonly context;
     constructor(context: TreeDxAdapterContext);

package/dist/treedx/adapters/{audit.js → governance/audit.js}

@@ -1,4 +1,4 @@
-import { jsonRequest } from './common.js';
+import { jsonRequest } from '../runtime/common.js';
 export class AuditAdapter {
     context;
     constructor(context) {

package/dist/treedx/adapters/{policy.d.ts → governance/policy.d.ts}

@@ -1,4 +1,4 @@
-import { type TreeDxAdapterContext } from './common.js';
+import { type TreeDxAdapterContext } from '../runtime/common.js';
 export declare class PolicyAdapter {
     private readonly context;
     constructor(context: TreeDxAdapterContext);

package/dist/treedx/adapters/{policy.js → governance/policy.js}

@@ -1,4 +1,4 @@
-import { jsonRequest } from './common.js';
+import { jsonRequest } from '../runtime/common.js';
 export class PolicyAdapter {
     context;
     constructor(context) {

package/dist/treedx/adapters/index.d.ts

@@ -1,21 +1,21 @@
-export * from './common.js';
-export * from './repositories.js';
-export * from './workspaces.js';
-export * from './files.js';
-export * from './blobs.js';
-export * from './query.js';
-export * from './graph.js';
-export * from './context.js';
-export * from './federation.js';
-export * from './registry.js';
-export * from './snapshots.js';
-export * from './artifacts.js';
-export * from './mirrors.js';
-export * from './migrations.js';
-export * from './exec.js';
-export * from './observability.js';
-export * from './admin.js';
-export * from './audit.js';
-export * from './policy.js';
-export * from './search-index.js';
-export * from './federation-internal.js';
+export * from './runtime/common.js';
+export * from './federation/repositories.js';
+export * from './federation/workspaces.js';
+export * from './storage/files.js';
+export * from './storage/blobs.js';
+export * from './knowledge/query.js';
+export * from './knowledge/graph.js';
+export * from './knowledge/context.js';
+export * from './federation/federation.js';
+export * from './federation/registry.js';
+export * from './storage/snapshots.js';
+export * from './storage/artifacts.js';
+export * from './federation/mirrors.js';
+export * from './storage/migrations.js';
+export * from './runtime/exec.js';
+export * from './runtime/observability.js';
+export * from './governance/admin.js';
+export * from './governance/audit.js';
+export * from './governance/policy.js';
+export * from './knowledge/search-index.js';
+export * from './federation/federation-internal.js';

package/dist/treedx/adapters/index.js

@@ -1,21 +1,21 @@
-export * from './common.js';
-export * from './repositories.js';
-export * from './workspaces.js';
-export * from './files.js';
-export * from './blobs.js';
-export * from './query.js';
-export * from './graph.js';
-export * from './context.js';
-export * from './federation.js';
-export * from './registry.js';
-export * from './snapshots.js';
-export * from './artifacts.js';
-export * from './mirrors.js';
-export * from './migrations.js';
-export * from './exec.js';
-export * from './observability.js';
-export * from './admin.js';
-export * from './audit.js';
-export * from './policy.js';
-export * from './search-index.js';
-export * from './federation-internal.js';
+export * from './runtime/common.js';
+export * from './federation/repositories.js';
+export * from './federation/workspaces.js';
+export * from './storage/files.js';
+export * from './storage/blobs.js';
+export * from './knowledge/query.js';
+export * from './knowledge/graph.js';
+export * from './knowledge/context.js';
+export * from './federation/federation.js';
+export * from './federation/registry.js';
+export * from './storage/snapshots.js';
+export * from './storage/artifacts.js';
+export * from './federation/mirrors.js';
+export * from './storage/migrations.js';
+export * from './runtime/exec.js';
+export * from './runtime/observability.js';
+export * from './governance/admin.js';
+export * from './governance/audit.js';
+export * from './governance/policy.js';
+export * from './knowledge/search-index.js';
+export * from './federation/federation-internal.js';

package/dist/treedx/adapters/{context.d.ts → knowledge/context.d.ts}

@@ -1,4 +1,4 @@
-import { type TreeDxAdapterContext } from './common.js';
+import { type TreeDxAdapterContext } from '../runtime/common.js';
 export declare class ContextAdapter {
     private readonly context;
     constructor(context: TreeDxAdapterContext);

package/dist/treedx/adapters/{context.js → knowledge/context.js}

@@ -1,4 +1,4 @@
-import { jsonRequest, segment } from './common.js';
+import { jsonRequest, segment } from '../runtime/common.js';
 export class ContextAdapter {
     context;
     constructor(context) {

package/dist/treedx/adapters/{graph.d.ts → knowledge/graph.d.ts}

@@ -1,4 +1,4 @@
-import { type TreeDxAdapterContext } from './common.js';
+import { type TreeDxAdapterContext } from '../runtime/common.js';
 export declare class GraphAdapter {
     private readonly context;
     constructor(context: TreeDxAdapterContext);

package/dist/treedx/adapters/{graph.js → knowledge/graph.js}

@@ -1,4 +1,4 @@
-import { jsonRequest, segment } from './common.js';
+import { jsonRequest, segment } from '../runtime/common.js';
 export class GraphAdapter {
     context;
     constructor(context) {

package/dist/treedx/adapters/{query.d.ts → knowledge/query.d.ts}

@@ -1,4 +1,4 @@
-import { type TreeDxAdapterContext } from './common.js';
+import { type TreeDxAdapterContext } from '../runtime/common.js';
 export declare class QueryAdapter {
     private readonly context;
     constructor(context: TreeDxAdapterContext);

package/dist/treedx/adapters/{query.js → knowledge/query.js}

@@ -1,4 +1,4 @@
-import { jsonRequest, segment } from './common.js';
+import { jsonRequest, segment } from '../runtime/common.js';
 export class QueryAdapter {
     context;
     constructor(context) {

package/dist/treedx/adapters/{search-index.d.ts → knowledge/search-index.d.ts}

@@ -1,4 +1,4 @@
-import { type TreeDxAdapterContext } from './common.js';
+import { type TreeDxAdapterContext } from '../runtime/common.js';
 export declare class SearchIndexAdapter {
     private readonly context;
     constructor(context: TreeDxAdapterContext);

package/dist/treedx/adapters/{search-index.js → knowledge/search-index.js}

@@ -1,4 +1,4 @@
-import { jsonRequest, segment } from './common.js';
+import { jsonRequest, segment } from '../runtime/common.js';
 export class SearchIndexAdapter {
     context;
     constructor(context) {

package/dist/treedx/adapters/{common.d.ts → runtime/common.d.ts}

@@ -1,4 +1,4 @@
-import type { BinaryBody, Transport, TreeDxHttpMethod } from '../types/index.js';
+import type { BinaryBody, Transport, TreeDxHttpMethod } from '../../types/index.js';
 export interface TreeDxAdapterContext {
     transport: Transport;
 }

package/dist/treedx/adapters/{artifacts.d.ts → storage/artifacts.d.ts}

@@ -1,4 +1,4 @@
-import { type TreeDxAdapterContext } from './common.js';
+import { type TreeDxAdapterContext } from '../runtime/common.js';
 export declare class ArtifactsAdapter {
     private readonly context;
     constructor(context: TreeDxAdapterContext);

package/dist/treedx/adapters/{artifacts.js → storage/artifacts.js}

@@ -1,4 +1,4 @@
-import { jsonRequest, segment } from './common.js';
+import { jsonRequest, segment } from '../runtime/common.js';
 export class ArtifactsAdapter {
     context;
     constructor(context) {

package/dist/treedx/adapters/{blobs.d.ts → storage/blobs.d.ts}

@@ -1,5 +1,5 @@
-import { type TreeDxAdapterContext } from './common.js';
-import type { BinaryBody } from '../types/index.js';
+import { type TreeDxAdapterContext } from '../runtime/common.js';
+import type { BinaryBody } from '../../types/index.js';
 export declare class BlobsAdapter {
     private readonly context;
     constructor(context: TreeDxAdapterContext);

package/dist/treedx/adapters/{blobs.js → storage/blobs.js}

@@ -1,4 +1,4 @@
-import { binaryRequest, jsonRequest, segment } from './common.js';
+import { binaryRequest, jsonRequest, segment } from '../runtime/common.js';
 export class BlobsAdapter {
     context;
     constructor(context) {

package/dist/treedx/adapters/{files.d.ts → storage/files.d.ts}

@@ -1,10 +1,11 @@
-import { type TreeDxAdapterContext } from './common.js';
+import { type TreeDxAdapterContext } from '../runtime/common.js';
 export declare class FilesAdapter {
     private readonly context;
     constructor(context: TreeDxAdapterContext);
     tree(workspaceId: string, query?: Record<string, string | number | boolean | undefined>): Promise<unknown>;
     read(workspaceId: string, query?: Record<string, string | number | boolean | undefined>): Promise<unknown>;
     write(workspaceId: string, input: unknown): Promise<unknown>;
+    changeset(workspaceId: string, input: unknown): Promise<unknown>;
     patch(workspaceId: string, input: unknown): Promise<unknown>;
     delete(workspaceId: string, query?: Record<string, string | number | boolean | undefined>): Promise<unknown>;
     search(workspaceId: string, input: unknown): Promise<unknown>;

package/dist/treedx/adapters/{files.js → storage/files.js}

@@ -1,4 +1,4 @@
-import { jsonRequest, segment } from './common.js';
+import { jsonRequest, segment } from '../runtime/common.js';
 export class FilesAdapter {
     context;
     constructor(context) {
@@ -7,6 +7,7 @@ export class FilesAdapter {
     tree(workspaceId, query) { return jsonRequest(this.context.transport, 'GET', `/api/v1/workspaces/${segment(workspaceId)}/tree`, undefined, query); }
     read(workspaceId, query) { return jsonRequest(this.context.transport, 'GET', `/api/v1/workspaces/${segment(workspaceId)}/files`, undefined, query); }
     write(workspaceId, input) { return jsonRequest(this.context.transport, 'PUT', `/api/v1/workspaces/${segment(workspaceId)}/files`, input); }
+    changeset(workspaceId, input) { return jsonRequest(this.context.transport, 'POST', `/api/v1/workspaces/${segment(workspaceId)}/changesets`, input); }
     patch(workspaceId, input) { return jsonRequest(this.context.transport, 'PATCH', `/api/v1/workspaces/${segment(workspaceId)}/files`, input); }
     delete(workspaceId, query) { return jsonRequest(this.context.transport, 'DELETE', `/api/v1/workspaces/${segment(workspaceId)}/files`, undefined, query); }
     search(workspaceId, input) { return jsonRequest(this.context.transport, 'POST', `/api/v1/workspaces/${segment(workspaceId)}/search`, input); }

package/dist/treedx/adapters/{migrations.d.ts → storage/migrations.d.ts}

@@ -1,4 +1,4 @@
-import { type TreeDxAdapterContext } from './common.js';
+import { type TreeDxAdapterContext } from '../runtime/common.js';
 export declare class MigrationsAdapter {
     private readonly context;
     constructor(context: TreeDxAdapterContext);

package/dist/treedx/adapters/{migrations.js → storage/migrations.js}

@@ -1,4 +1,4 @@
-import { jsonRequest, segment } from './common.js';
+import { jsonRequest, segment } from '../runtime/common.js';
 export class MigrationsAdapter {
     context;
     constructor(context) {

package/dist/treedx/adapters/{snapshots.d.ts → storage/snapshots.d.ts}

@@ -1,4 +1,4 @@
-import { type TreeDxAdapterContext } from './common.js';
+import { type TreeDxAdapterContext } from '../runtime/common.js';
 export declare class SnapshotsAdapter {
     private readonly context;
     constructor(context: TreeDxAdapterContext);

package/dist/treedx/adapters/{snapshots.js → storage/snapshots.js}

@@ -1,4 +1,4 @@
-import { jsonRequest, segment } from './common.js';
+import { jsonRequest, segment } from '../runtime/common.js';
 export class SnapshotsAdapter {
     context;
     constructor(context) {

package/dist/treedx/client/TreeDxClient.d.ts

@@ -37,5 +37,10 @@ export declare class TreeDxClient {
         body?: unknown;
         binaryBody?: BinaryBody;
         headers?: Record<string, string>;
+        signal?: AbortSignal;
+        timeoutMs?: number;
+        requestId?: string;
+        traceparent?: string;
+        idempotencyKey?: string;
     }): Promise<T>;
 }

package/dist/treedx/client/TreeDxClient.js

@@ -78,6 +78,18 @@ export class TreeDxClient {
             }
             return encodeURIComponent(String(value));
         });
-        return this.transport.request({ method, path: resolvedPath, query: options.query, body: options.body, binaryBody: options.binaryBody, headers: options.headers }).then((response) => response.data);
+        return this.transport.request({
+            method,
+            path: resolvedPath,
+            query: options.query,
+            body: options.body,
+            binaryBody: options.binaryBody,
+            headers: options.headers,
+            signal: options.signal,
+            timeoutMs: options.timeoutMs,
+            requestId: options.requestId,
+            traceparent: options.traceparent,
+            idempotencyKey: options.idempotencyKey
+        }).then((response) => response.data);
     }
 }

package/dist/treedx/client/errors.d.ts

@@ -14,4 +14,5 @@ export declare class TreeDxApiError extends Error {
     });
     static fromResponse(status: number, payload: unknown): TreeDxApiError;
     static network(message: string, cause?: unknown): TreeDxApiError;
+    static cancelled(message?: string, cause?: unknown): TreeDxApiError;
 }

package/dist/treedx/client/errors.js

@@ -32,4 +32,12 @@ export class TreeDxApiError extends Error {
             cause
         });
     }
+    static cancelled(message = 'TreeDX request was cancelled', cause) {
+        return new TreeDxApiError({
+            status: 0,
+            code: 'request_cancelled',
+            message,
+            cause
+        });
+    }
 }

package/dist/treedx/client/transport.d.ts

@@ -6,6 +6,7 @@ export interface FetchTransportOptions {
     token?: string;
     authProvider?: TreeDxClientConfig['authProvider'];
     fetchImpl?: TreeDxFetch;
+    timeoutMs?: number;
 }
 export declare class FetchTransport implements Transport {
     private readonly options;

package/dist/treedx/client/transport.js

@@ -20,6 +20,12 @@ export class FetchTransport {
             ...authHeaders,
             ...request.headers
         };
+        if (request.requestId)
+            headers['X-Request-ID'] = request.requestId;
+        if (request.traceparent)
+            headers.traceparent = request.traceparent;
+        if (request.idempotencyKey)
+            headers['Idempotency-Key'] = request.idempotencyKey;
         let body;
         if (request.binaryBody) {
             body = request.binaryBody;
@@ -29,12 +35,33 @@ export class FetchTransport {
             body = JSON.stringify(request.body);
         }
         let response;
+        const controller = new AbortController();
+        const timeoutMs = request.timeoutMs ?? this.options.timeoutMs;
+        const timeout = timeoutMs === undefined
+            ? undefined
+            : setTimeout(() => controller.abort(new Error('TreeDX request timed out')), timeoutMs);
+        const abort = () => controller.abort(request.signal?.reason);
+        if (request.signal?.aborted)
+            abort();
+        else
+            request.signal?.addEventListener('abort', abort, { once: true });
         try {
-            response = await this.fetchImpl(url, { method: request.method, headers, body });
+            if (controller.signal.aborted) {
+                throw controller.signal.reason;
+            }
+            response = await this.fetchImpl(url, { method: request.method, headers, body, signal: controller.signal });
         }
         catch (error) {
+            if (controller.signal.aborted) {
+                throw TreeDxApiError.cancelled(timeoutMs === undefined ? undefined : `TreeDX request exceeded ${timeoutMs}ms or was cancelled`, error);
+            }
             throw TreeDxApiError.network('TreeDX network request failed', error);
         }
+        finally {
+            if (timeout !== undefined)
+                clearTimeout(timeout);
+            request.signal?.removeEventListener('abort', abort);
+        }
         const data = await parseResponseBody(response);
         if (!response.ok) {
             throw TreeDxApiError.fromResponse(response.status, data);