@feltdb/core 0.7.3 → 0.8.0

package/dist/http-client.d.ts

@@ -4,31 +4,152 @@
  * Provides a simple interface for connecting to and querying remote FeltDB instances.
  * For applications that only need HTTP access without the full core framework.
  */
+import type { FeltDBProposalEvent, FeltDBProposalPreviewArtifact, FeltDBProposalRecord, ProposalReadiness, ProposalStatus } from './proposal.js';
+import type { CanonicalQuery, QueryResult, TransactionResult } from './state-contract.js';
 export interface ClientOptions {
     url: string;
     token: string;
+    applicationId?: string;
+    environment?: string;
+    revisionId?: string;
+    fetch?: typeof globalThis.fetch;
 }
-export interface RemoteRecord<T> {
-    id: string;
-    key: string;
-    value: T;
-    version_ms: number;
+export interface ServiceApiErrorBody {
+    code?: string;
+    error?: string;
+    message?: string;
+    request_id?: string;
+}
+export declare class FeltDBServiceApiError extends Error {
+    readonly code: string;
+    readonly status: number;
+    readonly requestId?: string | undefined;
+    constructor(code: string, message: string, status: number, requestId?: string | undefined);
+}
+export interface ApplicationInspection {
+    application_id: string;
+    application_name?: string;
+    environment: string;
+    version: number;
+    revision_id: string;
+    contract_hash: string;
+    flow_hash?: string;
+    snapshot: Record<string, unknown>;
+}
+export interface ApplicationSchemaInspection {
+    application: {
+        application_id: string;
+        environment: string;
+    };
+    contract_version: number;
+    collections: Array<{
+        collection: string;
+        fields: Array<{
+            name: string;
+            type: string;
+            required?: boolean;
+            reference?: string;
+        }>;
+        relationships: unknown[];
+    }>;
+}
+export interface InspectionPage<T> {
+    collection: string;
+    records: T[];
+    pagination: {
+        limit: number;
+        nextCursor: string | null;
+    };
+    state_version: number;
+}
+export interface InspectionRecord<T> {
+    collection: string;
+    record: T;
+    relationships: unknown[];
 }
 export declare class FeltDBClient {
     private readonly url;
     private readonly token;
+    private readonly applicationId?;
+    private readonly environment;
+    private readonly fetcher;
+    private revisionId?;
     constructor(options: ClientOptions);
     private headers;
     private request;
-    runtime(): Promise<Record<string, unknown>>;
-    list<T>(collection: string): Promise<Array<RemoteRecord<T>>>;
-    get<T>(collection: string, id: string | number): Promise<RemoteRecord<T>>;
-    insert<T extends object>(collection: string, value: T, id?: string | number): Promise<RemoteRecord<T>>;
-    update<T extends object>(collection: string, id: string | number, changes: Partial<T>): Promise<RemoteRecord<T>>;
-    delete(collection: string, id: string | number): Promise<void>;
-    getInfo(): {
-        runtime: 'remote';
-        url: string;
+    private scoped;
+    private scopeBody;
+    private activeRevision;
+    /** Canonical application Contract Snapshot and schema inspection. */
+    readonly application: {
+        get: () => Promise<ApplicationInspection>;
+        schema: () => Promise<ApplicationSchemaInspection>;
+    };
+    /** Bounded, authorized application-state inspection. Cursors remain opaque. */
+    readonly data: {
+        list: <T = Record<string, unknown>>(collection: string, options?: {
+            limit?: number;
+            cursor?: string;
+            filters?: Record<string, string>;
+        }) => Promise<InspectionPage<T>>;
+        get: <T = Record<string, unknown>>(collection: string, id: string) => Promise<InspectionRecord<T>>;
+    };
+    /** Canonical application queries and atomic transactions against the active revision. */
+    readonly state: {
+        query: <T = Record<string, unknown>>(query: CanonicalQuery) => Promise<QueryResult<T>>;
+        transaction: (transaction: Record<string, unknown>) => Promise<TransactionResult>;
+        version: () => Promise<{
+            state_version: number;
+        }>;
+    };
+    /** Public contract-declared application capability invocation. */
+    readonly capabilities: {
+        run: (name: string, input: unknown) => Promise<unknown>;
+    };
+    /** Canonical Proposal lifecycle. Repository application is intentionally absent. */
+    readonly proposals: {
+        create: (proposal: {
+            base_contract_hash: string;
+            base_flow_hash: string;
+            proposed_flow: string;
+            summary: string;
+            warnings?: string[];
+            metadata?: Record<string, string>;
+            parent_proposal_id?: string;
+            expires_at?: string | number;
+        }) => Promise<FeltDBProposalRecord>;
+        list: (options?: {
+            status?: ProposalStatus;
+            limit?: number;
+            cursor?: string;
+        }) => Promise<{
+            proposals: FeltDBProposalRecord[];
+            pagination: {
+                limit: number;
+                nextCursor: string | null;
+            };
+        }>;
+        get: (id: string) => Promise<FeltDBProposalRecord>;
+        history: (id: string) => Promise<{
+            events: FeltDBProposalEvent[];
+        }>;
+        status: (id: string) => Promise<ProposalReadiness>;
+        validate: (id: string, proposedManifest?: unknown) => Promise<FeltDBProposalRecord>;
+        createPreview: (id: string) => Promise<FeltDBProposalPreviewArtifact>;
+        preview: (previewId: string) => Promise<FeltDBProposalPreviewArtifact>;
+        previewData: <T = Record<string, unknown>>(previewId: string, collection: string, options?: {
+            limit?: number;
+            cursor?: string;
+        }) => Promise<InspectionPage<T>>;
+        simulatePreview: (previewId: string, event: string) => Promise<{
+            preview_id: string;
+            event: string;
+            status: "simulated";
+            external_side_effects: "none";
+            trace: string[];
+        }>;
+        approve: (id: string, approveAuthorization?: boolean) => Promise<FeltDBProposalRecord>;
+        reject: (id: string, reason?: string) => Promise<FeltDBProposalRecord>;
     };
 }
 export declare function createClient(options: ClientOptions): FeltDBClient;

package/dist/http-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../src/http-client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,CAAC,CAAC;IACT,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAEnB,OAAO,EAAE,aAAa;IAMlC,OAAO,CAAC,OAAO;YAQD,OAAO;IAgBrB,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAI3C,IAAI,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;IAI5D,GAAG,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAIzE,MAAM,CAAC,CAAC,SAAS,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAOtG,MAAM,CAAC,CAAC,SAAS,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAOhH,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM9D,OAAO,IAAI;QAAE,OAAO,EAAE,QAAQ,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE;CAG9C;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,YAAY,CAEjE"}
+{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../src/http-client.ts"],"names":[],"mappings":"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"}

package/dist/http-client.js

@@ -4,14 +4,33 @@
  * Provides a simple interface for connecting to and querying remote FeltDB instances.
  * For applications that only need HTTP access without the full core framework.
  */
+export class FeltDBServiceApiError extends Error {
+    code;
+    status;
+    requestId;
+    constructor(code, message, status, requestId) {
+        super(message);
+        this.code = code;
+        this.status = status;
+        this.requestId = requestId;
+    }
+}
 export class FeltDBClient {
     url;
     token;
+    applicationId;
+    environment;
+    fetcher;
+    revisionId;
     constructor(options) {
         if (!options.url || !options.token)
             throw new Error('FeltDBClient requires url and token');
         this.url = options.url.replace(/\/$/, '');
         this.token = options.token;
+        this.applicationId = options.applicationId;
+        this.environment = options.environment || 'production';
+        this.fetcher = options.fetch ?? globalThis.fetch.bind(globalThis);
+        this.revisionId = options.revisionId;
     }
     headers(json = false) {
         return {
@@ -21,51 +40,80 @@ export class FeltDBClient {
         };
     }
     async request(path, init = {}) {
-        const response = await fetch(`${this.url}${path}`, {
+        const response = await this.fetcher(`${this.url}${path}`, {
             ...init,
             headers: { ...this.headers(init.body !== undefined), ...init.headers },
         });
         if (!response.ok) {
             let message = `FeltDB request failed: HTTP ${response.status}`;
+            let body = {};
             try {
-                const body = await response.json();
-                if (body.error)
-                    message = body.error;
+                body = await response.json();
             }
             catch { /* non-JSON error */ }
-            throw new Error(message);
+            if (body.message || body.error)
+                message = body.message || body.error || message;
+            throw new FeltDBServiceApiError(body.code || body.error || 'REQUEST_FAILED', message, response.status, body.request_id);
         }
         return (response.status === 204 ? undefined : response.json());
     }
-    runtime() {
-        return this.request('/runtime');
-    }
-    list(collection) {
-        return this.request(`/collections/${encodeURIComponent(collection)}`);
+    scoped(path, query = {}) {
+        if (!this.applicationId)
+            throw new Error('This Service API operation requires createClient({ applicationId })');
+        const separator = path.includes('?') ? '&' : '?';
+        const parameters = new URLSearchParams({ application_id: this.applicationId, environment: this.environment });
+        for (const [name, value] of Object.entries(query))
+            if (value !== undefined && value !== '')
+                parameters.set(name, String(value));
+        return `${path}${separator}${parameters}`;
     }
-    get(collection, id) {
-        return this.request(`/collections/${encodeURIComponent(collection)}/${encodeURIComponent(String(id))}`);
-    }
-    insert(collection, value, id) {
-        return this.request(`/collections/${encodeURIComponent(collection)}`, {
-            method: 'POST',
-            body: JSON.stringify(id === undefined ? value : { ...value, id }),
-        });
-    }
-    update(collection, id, changes) {
-        return this.request(`/collections/${encodeURIComponent(collection)}/${encodeURIComponent(String(id))}`, {
-            method: 'PATCH',
-            body: JSON.stringify(changes),
-        });
-    }
-    delete(collection, id) {
-        return this.request(`/collections/${encodeURIComponent(collection)}/${encodeURIComponent(String(id))}`, {
-            method: 'DELETE',
-        });
+    scopeBody(value = {}) {
+        if (!this.applicationId)
+            throw new Error('This Service API operation requires createClient({ applicationId })');
+        return { application_id: this.applicationId, environment: this.environment, ...value };
     }
-    getInfo() {
-        return { runtime: 'remote', url: this.url };
+    async activeRevision() {
+        if (this.revisionId)
+            return this.revisionId;
+        const application = await this.application.get();
+        this.revisionId = application.revision_id;
+        return application.revision_id;
     }
+    /** Canonical application Contract Snapshot and schema inspection. */
+    application = {
+        get: () => this.request(this.scoped('/v1/application')),
+        schema: () => this.request(this.scoped('/v1/application/schema')),
+    };
+    /** Bounded, authorized application-state inspection. Cursors remain opaque. */
+    data = {
+        list: (collection, options = {}) => this.request(this.scoped(`/v1/data/${encodeURIComponent(collection)}`, { limit: options.limit, cursor: options.cursor, ...options.filters })),
+        get: (collection, id) => this.request(this.scoped(`/v1/data/${encodeURIComponent(collection)}/${encodeURIComponent(id)}`)),
+    };
+    /** Canonical application queries and atomic transactions against the active revision. */
+    state = {
+        query: async (query) => this.request('/v1/query', { method: 'POST', body: JSON.stringify({ ...this.scopeBody(), revision_id: await this.activeRevision(), query }) }),
+        transaction: async (transaction) => this.request('/v1/transactions', { method: 'POST', body: JSON.stringify({ ...this.scopeBody(), revision_id: await this.activeRevision(), transaction }) }),
+        version: async () => this.request(this.scoped('/v1/state/version', { revision_id: await this.activeRevision() })),
+    };
+    /** Public contract-declared application capability invocation. */
+    capabilities = {
+        run: (name, input) => this.request(this.scoped(`/v1/capabilities/${encodeURIComponent(name)}/run`), { method: 'POST', body: JSON.stringify(input) }),
+    };
+    /** Canonical Proposal lifecycle. Repository application is intentionally absent. */
+    proposals = {
+        create: (proposal) => this.request('/v1/proposals', { method: 'POST', body: JSON.stringify(this.scopeBody(proposal)) }),
+        list: (options = {}) => this.request(this.scoped('/v1/proposals', options)),
+        get: (id) => this.request(this.scoped(`/v1/proposals/${encodeURIComponent(id)}`)),
+        history: (id) => this.request(this.scoped(`/v1/proposals/${encodeURIComponent(id)}/history`)),
+        status: (id) => this.request(this.scoped(`/v1/proposals/${encodeURIComponent(id)}/status`)),
+        validate: (id, proposedManifest) => this.request(`/v1/proposals/${encodeURIComponent(id)}/validate`, { method: 'POST', body: JSON.stringify(this.scopeBody({ proposed_manifest: proposedManifest })) }),
+        createPreview: (id) => this.request(`/v1/proposals/${encodeURIComponent(id)}/preview`, { method: 'POST', body: JSON.stringify(this.scopeBody()) }),
+        preview: (previewId) => this.request(this.scoped(`/v1/previews/${encodeURIComponent(previewId)}`)),
+        previewData: (previewId, collection, options = {}) => this.request(this.scoped(`/v1/previews/${encodeURIComponent(previewId)}/data/${encodeURIComponent(collection)}`, options)),
+        simulatePreview: (previewId, event) => this.request(this.scoped(`/v1/previews/${encodeURIComponent(previewId)}/simulate`), { method: 'POST', body: JSON.stringify({ event }) }),
+        approve: (id, approveAuthorization = false) => this.request(`/v1/proposals/${encodeURIComponent(id)}/approve`, { method: 'POST', body: JSON.stringify(this.scopeBody({ approve_authorization: approveAuthorization })) }),
+        reject: (id, reason) => this.request(`/v1/proposals/${encodeURIComponent(id)}/reject`, { method: 'POST', body: JSON.stringify(this.scopeBody({ reason })) }),
+    };
 }
 export function createClient(options) {
     return new FeltDBClient(options);

package/dist/http-db.d.ts

@@ -7,7 +7,9 @@ interface JsResult {
 }
 interface HttpRuntimeOptions {
     url: string;
-    token: string;
+    token?: string;
+    applicationId?: string;
+    environment?: string;
 }
 export interface AuthorityQueryRequest {
     collection: string;
@@ -35,10 +37,20 @@ export interface AuthorityQueryPage<T = Record<string, unknown>> {
 /** Network adapter implementing the same collection runtime contract as WASM. */
 export declare class HttpJsDb implements JsDb {
     private readonly url;
-    private readonly token;
+    private token;
+    private readonly applicationId?;
+    private readonly environment;
+    private activeRevision?;
     constructor(options: HttpRuntimeOptions);
     private headers;
+    auth_request<T extends {
+        access_token?: string;
+    }>(operation: 'signup' | 'signin' | 'signout' | 'session', body?: unknown): Promise<T>;
     private splitKey;
+    private revisionId;
+    private canonical;
+    private transactionDocument;
+    private canonicalTransaction;
     get(key: string): Promise<JsResult>;
     query(collection: string): Promise<JsResult>;
     authority_query<T = Record<string, unknown>>(query: AuthorityQueryRequest): Promise<AuthorityQueryPage<T>>;
@@ -102,6 +114,7 @@ export declare class HttpJsDb implements JsDb {
     }>;
     acquireContent(hash: string): Promise<Uint8Array | null>;
     command(path: string, body: unknown): Promise<any>;
+    application_request<T>(path: string, init?: RequestInit): Promise<T>;
     subscribe_changes(callback: (collection: string) => void): () => void;
     private consumeEvents;
     private failure;

package/dist/http-db.d.ts.map

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

package/dist/http-db.js

@@ -1,18 +1,39 @@
+import { FeltDBServiceError } from './error-codes.js';
 /** Network adapter implementing the same collection runtime contract as WASM. */
 export class HttpJsDb {
     url;
     token;
+    applicationId;
+    environment;
+    activeRevision;
     constructor(options) {
         this.url = options.url.replace(/\/$/, '');
-        this.token = options.token;
+        this.token = options.token || '';
+        this.applicationId = options.applicationId;
+        this.environment = options.environment || 'production';
     }
     headers(json = false) {
         return {
-            Authorization: `Bearer ${this.token}`,
+            ...(this.token ? { Authorization: `Bearer ${this.token}` } : {}),
             'FeltDB-Protocol': '1',
             ...(json ? { 'Content-Type': 'application/json' } : {}),
         };
     }
+    async auth_request(operation, body) {
+        const response = await fetch(`${this.url}/v1/auth/${operation}`, {
+            method: operation === 'session' ? 'GET' : 'POST',
+            headers: this.headers(body !== undefined),
+            ...(body !== undefined ? { body: JSON.stringify(operation === 'signup' ? { application_id: this.applicationId, ...body } : body) } : {}),
+        });
+        const value = response.status === 204 ? {} : await response.json();
+        if (!response.ok)
+            throw new FeltDBServiceError(value.message || value.error || 'Authentication failed', value.code || value.error || 'AUTHENTICATION_FAILED', value.request_id, response.status);
+        if (value.access_token)
+            this.token = value.access_token;
+        if (operation === 'signout')
+            this.token = '';
+        return value;
+    }
     splitKey(key) {
         const separator = key.indexOf(':');
         if (separator < 1 || separator === key.length - 1) {
@@ -20,9 +41,33 @@ export class HttpJsDb {
         }
         return [key.slice(0, separator), key.slice(separator + 1)];
     }
+    async revisionId() {
+        if (!this.applicationId)
+            throw new Error('applicationId is required for the canonical application service');
+        this.activeRevision ??= this.application_request('/application').then(value => value.revision_id);
+        return this.activeRevision;
+    }
+    async canonical(path, payload) {
+        const revisionId = await this.revisionId();
+        return this.application_request(path, { method: 'POST', body: JSON.stringify({
+                application_id: this.applicationId, revision_id: revisionId, environment: this.environment, ...payload,
+            }) });
+    }
+    transactionDocument(revisionId, operations, transactionId = crypto.randomUUID()) {
+        return { transaction_id: transactionId, tenant_id: '', application_id: this.applicationId, revision_id: revisionId, schema_version: 0,
+            authorization: { subject: '', tenant_id: '', application_id: this.applicationId, revision_id: revisionId, capabilities: [] }, operations };
+    }
+    async canonicalTransaction(operations, transactionId) {
+        const revisionId = await this.revisionId();
+        return this.application_request('/transactions', { method: 'POST', body: JSON.stringify({ application_id: this.applicationId, revision_id: revisionId, environment: this.environment, transaction: this.transactionDocument(revisionId, operations, transactionId) }) });
+    }
     async get(key) {
         try {
             const [collection, id] = this.splitKey(key);
+            if (this.applicationId) {
+                const result = await this.canonical('/query', { query: { collection, filter: { operator: 'eq', field: 'id', value: id }, limit: 1 } });
+                return { success: true, data: result.records.length ? JSON.stringify(result.records[0]) : undefined };
+            }
             const response = await fetch(`${this.url}/collections/${encodeURIComponent(collection)}/${encodeURIComponent(id)}`, {
                 headers: this.headers(),
             });
@@ -39,6 +84,10 @@ export class HttpJsDb {
     }
     async query(collection) {
         try {
+            if (this.applicationId) {
+                const result = await this.canonical('/query', { query: { collection, limit: 500 } });
+                return { success: true, data: JSON.stringify(result.records) };
+            }
             const response = await fetch(`${this.url}/collections/${encodeURIComponent(collection)}`, {
                 headers: this.headers(),
             });
@@ -52,6 +101,20 @@ export class HttpJsDb {
         }
     }
     async authority_query(query) {
+        if (this.applicationId) {
+            const conditions = query.where || [];
+            const filters = conditions.map(condition => {
+                const operator = Object.keys(condition).find(key => key !== 'field') || 'eq';
+                return { operator, field: condition.field, value: condition[operator] };
+            });
+            const result = await this.canonical('/query', { query: {
+                    collection: query.collection,
+                    filter: filters.length === 1 ? filters[0] : filters.length ? { operator: 'and', filters } : undefined,
+                    order_by: query.orderBy?.map(value => ({ field: value.field, direction: value.direction })),
+                    limit: query.limit, cursor: query.cursor,
+                } });
+            return { records: result.records, nextCursor: result.next_cursor, exhausted: !result.next_cursor };
+        }
         const response = await fetch(`${this.url}/query`, {
             method: 'POST', headers: this.headers(true), body: JSON.stringify(query),
         });
@@ -68,6 +131,10 @@ export class HttpJsDb {
         try {
             const [collection, id] = this.splitKey(key);
             const record = JSON.parse(value);
+            if (this.applicationId) {
+                await this.canonicalTransaction([{ kind: 'insert', collection, id, value: record }]);
+                return { success: true, data: key };
+            }
             const response = await fetch(`${this.url}/collections/${encodeURIComponent(collection)}`, {
                 method: 'POST',
                 headers: this.headers(true),
@@ -84,6 +151,10 @@ export class HttpJsDb {
     async update(key, value) {
         try {
             const [collection, id] = this.splitKey(key);
+            if (this.applicationId) {
+                await this.canonicalTransaction([{ kind: 'update', collection, id, value: JSON.parse(value) }]);
+                return { success: true, data: key };
+            }
             const response = await fetch(`${this.url}/collections/${encodeURIComponent(collection)}/${encodeURIComponent(id)}`, {
                 method: 'PATCH',
                 headers: this.headers(true),
@@ -104,6 +175,16 @@ export class HttpJsDb {
      * durable record on the server. A refusal means nothing was applied.
      */
     async commit_transaction(request) {
+        if (this.applicationId) {
+            if (request.preconditions?.length)
+                throw new Error('record preconditions are not representable by the canonical transaction contract');
+            const operations = request.operations.map(operation => ({
+                kind: operation.value === undefined ? 'delete' : operation.requireAbsent ? 'insert' : 'update',
+                collection: operation.collection, id: operation.id, value: operation.value, if_version: operation.expectedVersion,
+            }));
+            const result = await this.canonicalTransaction(operations, request.transactionId);
+            return { transactionId: result.transaction_id, duplicate: result.duplicate, operations: operations.length, stateBefore: result.state_before, stateAfter: result.state_after };
+        }
         const response = await fetch(`${this.url}/transactions`, {
             method: 'POST',
             headers: this.headers(true),
@@ -174,6 +255,10 @@ export class HttpJsDb {
     async delete(key) {
         try {
             const [collection, id] = this.splitKey(key);
+            if (this.applicationId) {
+                await this.canonicalTransaction([{ kind: 'delete', collection, id }]);
+                return { success: true, data: key };
+            }
             const response = await fetch(`${this.url}/collections/${encodeURIComponent(collection)}/${encodeURIComponent(id)}`, {
                 method: 'DELETE',
                 headers: this.headers(),
@@ -230,6 +315,28 @@ export class HttpJsDb {
             throw new Error((await this.failure(response)).error);
         return response.status === 204 ? undefined : response.json();
     }
+    async application_request(path, init = {}) {
+        const separator = path.includes('?') ? '&' : '?';
+        const context = this.applicationId
+            ? `${separator}application_id=${encodeURIComponent(this.applicationId)}&environment=${encodeURIComponent(this.environment)}`
+            : '';
+        const response = await fetch(`${this.url}/v1${path}${context}`, {
+            ...init,
+            headers: { ...this.headers(init.body !== undefined), ...(init.headers || {}) },
+        });
+        const text = await response.text();
+        let body;
+        try {
+            body = text ? JSON.parse(text) : undefined;
+        }
+        catch {
+            body = { message: text };
+        }
+        if (!response.ok) {
+            throw new FeltDBServiceError(body?.message || body?.error || `FeltDB service request failed: HTTP ${response.status}`, body?.code || body?.error || 'REQUEST_FAILED', body?.request_id, response.status);
+        }
+        return body;
+    }
     subscribe_changes(callback) {
         const controller = new AbortController();
         void this.consumeEvents(controller, callback);
@@ -238,7 +345,8 @@ export class HttpJsDb {
     async consumeEvents(controller, callback) {
         while (!controller.signal.aborted) {
             try {
-                const response = await fetch(`${this.url}/events`, {
+                const eventPath = this.applicationId ? `/v1/events?application_id=${encodeURIComponent(this.applicationId)}&environment=${encodeURIComponent(this.environment)}` : '/events';
+                const response = await fetch(`${this.url}${eventPath}`, {
                     headers: this.headers(),
                     signal: controller.signal,
                 });
@@ -259,8 +367,8 @@ export class HttpJsDb {
                         if (!data)
                             continue;
                         const event = JSON.parse(data);
-                        if (event.change?.capability)
-                            callback(event.change.capability);
+                        if (event.resource)
+                            callback(event.resource);
                     }
                 }
             }

package/dist/index-core.d.ts

@@ -52,6 +52,11 @@ export * from './provider.js';
 export * from './identity.js';
 export * from './development-runtime-bridge.js';
 export * from './application-contract.js';
+export * from './canonical-application.js';
+export * from './application-development.js';
+export * from './proposal.js';
+export * from './module.js';
+export * from './module-intent.js';
 export { ProtocolHandler, type Message, type Operation as ProtocolOperation, type Response as ProtocolResponse, } from './protocol.js';
 /**
  * Agent Runtime APIs

package/dist/index-core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index-core.d.ts","sourceRoot":"","sources":["../src/index-core.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,YAAY,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAC9E,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,iCAAiC,CAAC;AAChD,cAAc,2BAA2B,CAAC;AAC1C,OAAO,EACL,eAAe,EACf,KAAK,OAAO,EACZ,KAAK,SAAS,IAAI,iBAAiB,EACnC,KAAK,QAAQ,IAAI,gBAAgB,GAClC,MAAM,eAAe,CAAC;AAEvB;;GAEG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AAEnC;;GAEG;AACH,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACnE,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEzE;;GAEG;AACH,YAAY,EACV,eAAe,EACf,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,SAAS,CAAC;AAEjB;;;;GAIG;AACH,cAAc,wBAAwB,CAAC;AACvC,cAAc,iCAAiC,CAAC"}
+{"version":3,"file":"index-core.d.ts","sourceRoot":"","sources":["../src/index-core.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,YAAY,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAC9E,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,iCAAiC,CAAC;AAChD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,OAAO,EACL,eAAe,EACf,KAAK,OAAO,EACZ,KAAK,SAAS,IAAI,iBAAiB,EACnC,KAAK,QAAQ,IAAI,gBAAgB,GAClC,MAAM,eAAe,CAAC;AAEvB;;GAEG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AAEnC;;GAEG;AACH,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACnE,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEzE;;GAEG;AACH,YAAY,EACV,eAAe,EACf,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,SAAS,CAAC;AAEjB;;;;GAIG;AACH,cAAc,wBAAwB,CAAC;AACvC,cAAc,iCAAiC,CAAC"}

package/dist/index-core.js

@@ -51,6 +51,11 @@ export * from './provider.js';
 export * from './identity.js';
 export * from './development-runtime-bridge.js';
 export * from './application-contract.js';
+export * from './canonical-application.js';
+export * from './application-development.js';
+export * from './proposal.js';
+export * from './module.js';
+export * from './module-intent.js';
 export { ProtocolHandler, } from './protocol.js';
 /**
  * Agent Runtime APIs