@feltdb/core 0.9.0 → 0.10.0

package/dist/public-contract.js

@@ -0,0 +1,125 @@
+import { FeltDBErrorCode, FeltDBServiceError } from './error-codes.js';
+export const FELTDB_PUBLIC_CONTRACT_VERSION = '1.0';
+/**
+ * One typed public adapter over the canonical FeltDB authority.
+ *
+ * This class owns no records, versions, cursors, work, provenance, or retry
+ * log. Its fields are routing adapters; destroying this object loses no
+ * durable information.
+ */
+export class FeltDBPublicContract {
+    db;
+    scope;
+    applicationId;
+    environment;
+    request;
+    version = FELTDB_PUBLIC_CONTRACT_VERSION;
+    constructor(db, scope, applicationId, environment, request) {
+        this.db = db;
+        this.scope = scope;
+        this.applicationId = applicationId;
+        this.environment = environment;
+        this.request = request;
+    }
+    requireApplicationScope() {
+        if (this.scope?.kind !== 'tenant' || !this.applicationId) {
+            throw new FeltDBServiceError('The public durable contract requires explicit tenant and application scope', FeltDBErrorCode.AUTHORITY_SCOPE_REQUIRED);
+        }
+        return { tenantId: this.scope.tenantId, applicationId: this.applicationId };
+    }
+    authority() {
+        this.requireApplicationScope();
+        if (!this.request) {
+            throw new FeltDBServiceError('This capability requires a connected FeltDB authority', FeltDBErrorCode.CONTRACT_UNSUPPORTED);
+        }
+        return this.request;
+    }
+    state = {
+        collection: (name) => {
+            this.requireApplicationScope();
+            return this.db.collection(name);
+        },
+        transaction: (build, options = {}) => {
+            this.requireApplicationScope();
+            return this.db.transaction(build, options);
+        },
+    };
+    principals = {
+        list: async () => {
+            const { applicationId } = this.requireApplicationScope();
+            return this.authority()(`/api/applications/${encodeURIComponent(applicationId)}/principals`);
+        },
+        create: async (input) => {
+            const { applicationId } = this.requireApplicationScope();
+            return this.authority()(`/api/applications/${encodeURIComponent(applicationId)}/principals`, { method: 'POST', body: JSON.stringify(input) });
+        },
+        grant: async (principalId, capability) => this.authority()(`/api/principals/${encodeURIComponent(principalId)}/capabilities`, { method: 'POST', body: JSON.stringify({ capability }) }),
+    };
+    work = {
+        create: async (input) => {
+            const { tenantId, applicationId } = this.requireApplicationScope();
+            if (input.tenant_id !== tenantId || input.application_id !== applicationId) {
+                throw new FeltDBServiceError('Durable Work scope does not match the bound public contract', FeltDBErrorCode.SCOPE_VIOLATION);
+            }
+            return this.authority()('/v1/workloads', {
+                method: 'POST',
+                body: JSON.stringify({ ...input, created_at: input.created_at ?? Math.floor(Date.now() / 1000) }),
+            });
+        },
+        inspect: (workId) => this.authority()(`/v1/workloads/${encodeURIComponent(workId)}`),
+        history: (workId) => this.authority()(`/v1/workloads/${encodeURIComponent(workId)}/history`),
+    };
+    events = {
+        replay: async (after, options = {}) => {
+            const { applicationId } = this.requireApplicationScope();
+            const query = new URLSearchParams({
+                application_id: applicationId,
+                environment: this.environment,
+                limit: String(options.limit ?? 100),
+            });
+            if (after)
+                query.set('cursor', after);
+            return this.authority()(`/v1/public/events/replay?${query}`);
+        },
+        subscribe: (after, listener, options = {}) => {
+            const controller = new AbortController();
+            const cancel = () => controller.abort();
+            options.signal?.addEventListener('abort', cancel, { once: true });
+            void (async () => {
+                let cursor = after;
+                while (!controller.signal.aborted) {
+                    const page = await this.events.replay(cursor);
+                    for (const event of page.events)
+                        await listener(event);
+                    cursor = page.next_cursor;
+                    await new Promise(resolve => {
+                        const timer = setTimeout(resolve, options.pollIntervalMs ?? 250);
+                        controller.signal.addEventListener('abort', () => {
+                            clearTimeout(timer);
+                            resolve();
+                        }, { once: true });
+                    });
+                }
+            })().catch(() => {
+                // Delivery failure ends this discardable subscriber. Replay remains
+                // available from the caller's last acknowledged opaque cursor.
+                controller.abort();
+            });
+            return cancel;
+        },
+    };
+    provenance = {
+        record: async (collection, id) => {
+            const { applicationId } = this.requireApplicationScope();
+            const query = new URLSearchParams({
+                application_id: applicationId,
+                environment: this.environment,
+            });
+            return this.authority()(`/v1/control-plane/provenance/${encodeURIComponent(collection)}/${encodeURIComponent(id)}?${query}`);
+        },
+    };
+    async capabilities() {
+        const declaration = await this.authority()('/v1/control-plane/capabilities');
+        return declaration.public_contract;
+    }
+}

package/dist/studio/app.d.ts

@@ -16,6 +16,29 @@ export interface StudioAppProps {
     sourceSync?: SourceSyncConfiguration;
     onConnect?: (url: string, token: string) => void;
 }
+export interface ApplicationConnectionNoticeProps {
+    registration?: {
+        namespace?: string;
+    };
+}
+export type StudioConnectionResolution = {
+    source: 'explicit-authority' | 'configured-authority';
+    authorityUrl: string;
+} | {
+    source: 'injected';
+    authorityUrl: '';
+} | {
+    source: 'browser';
+    authorityUrl: '';
+};
+export declare function resolveStudioConnection(input: {
+    explicitAuthority?: string | null;
+    configuredAuthority?: string | null;
+    injected?: boolean;
+}): StudioConnectionResolution;
+/** A registration proves the application is connected; it does not identify
+ * the JavaScript environment in which the application itself executes. */
+export declare function ApplicationConnectionNotice({ registration }: ApplicationConnectionNoticeProps): React.JSX.Element;
 export declare function StudioApp({ db, remoteUrl, token, namespace, deploymentRuntime, applicationUrl, applicationId, environment, developmentSession, managedPublish, sourceSync, onConnect }: StudioAppProps): React.JSX.Element;
 export default StudioApp;
 //# sourceMappingURL=app.d.ts.map

package/dist/studio/app.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAA8B,MAAM,OAAO,CAAC;AAOnD,OAA4B,EAAE,KAAK,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AACzG,OAAO,EAAa,KAAK,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAqBjF,OAAO,EAAgC,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAC/E,OAAO,WAAW,CAAC;AACnB,OAAO,mCAAmC,CAAC;AAE3C,MAAM,WAAW,cAAc;IAC7B,EAAE,CAAC,EAAE,YAAY,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C,cAAc,CAAC,EAAE,2BAA2B,CAAC;IAC7C,UAAU,CAAC,EAAE,uBAAuB,CAAC;IACrC,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAClD;AAiBD,wBAAgB,SAAS,CAAC,EAAE,EAAE,EAAE,SAAc,EAAE,KAAU,EAAE,SAAqB,EAAE,iBAA6B,EAAE,cAAmB,EAAE,aAAkB,EAAE,WAA0B,EAAE,kBAAkB,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE,cAAc,qBAyJjQ;AAED,eAAe,SAAS,CAAC"}
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAA8B,MAAM,OAAO,CAAC;AAOnD,OAA4B,EAAE,KAAK,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AACzG,OAAO,EAAa,KAAK,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAqBjF,OAAO,EAAgC,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAC/E,OAAO,WAAW,CAAC;AACnB,OAAO,mCAAmC,CAAC;AAE3C,MAAM,WAAW,cAAc;IAC7B,EAAE,CAAC,EAAE,YAAY,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C,cAAc,CAAC,EAAE,2BAA2B,CAAC;IAC7C,UAAU,CAAC,EAAE,uBAAuB,CAAC;IACrC,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAClD;AAED,MAAM,WAAW,gCAAgC;IAC/C,YAAY,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACvC;AAED,MAAM,MAAM,0BAA0B,GAClC;IAAE,MAAM,EAAE,oBAAoB,GAAG,sBAAsB,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAC/E;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,YAAY,EAAE,EAAE,CAAA;CAAE,GACxC;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,YAAY,EAAE,EAAE,CAAA;CAAE,CAAC;AAE5C,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAC7C,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,GAAG,0BAA0B,CAU7B;AAED;0EAC0E;AAC1E,wBAAgB,2BAA2B,CAAC,EAAE,YAAY,EAAE,EAAE,gCAAgC,qBAM7F;AAiBD,wBAAgB,SAAS,CAAC,EAAE,EAAE,EAAE,SAAc,EAAE,KAAU,EAAE,SAAqB,EAAE,iBAA6B,EAAE,cAAmB,EAAE,aAAkB,EAAE,WAA0B,EAAE,kBAAkB,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE,cAAc,qBAyJjQ;AAED,eAAe,SAAS,CAAC"}

package/dist/studio/components/ContractInspector.d.ts

@@ -1,5 +1,10 @@
 import { default as React } from 'react';
 import { FlowSpec } from '@feltdb/core';
+/** Preserve Studio's connection scope while naming a canonical Data collection. */
+export declare function dataCollectionLocation(search: string, collection: string): {
+    pathname: string;
+    search: string;
+};
 export declare function ContractInspector({ model, section }: {
     model: FlowSpec | null;
     section: 'schema' | 'policies';

package/dist/studio/components/ContractInspector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ContractInspector.d.ts","sourceRoot":"","sources":["../../src/components/ContractInspector.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAE7C,wBAAgB,iBAAiB,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IAAE,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,QAAQ,GAAC,UAAU,CAAA;CAAE,qBAM7G"}
+{"version":3,"file":"ContractInspector.d.ts","sourceRoot":"","sources":["../../src/components/ContractInspector.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAE7C,mFAAmF;AACnF,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;;;EAIxE;AAED,wBAAgB,iBAAiB,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IAAE,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,QAAQ,GAAC,UAAU,CAAA;CAAE,qBAM7G"}

package/dist/studio/components/SettingsPanel.d.ts

@@ -4,8 +4,11 @@ export interface SettingsPanelProps {
     db?: StateFirstDB;
     remoteUrl?: string;
     token?: string;
+    applicationUrl?: string;
+    feltDBRuntime?: string;
+    authorityUrl?: string;
     onConnect?: (url: string, token: string) => void;
 }
-export declare function SettingsPanel({ db, remoteUrl, token, onConnect }: SettingsPanelProps): React.JSX.Element;
+export declare function SettingsPanel({ db, remoteUrl, token, applicationUrl, feltDBRuntime, authorityUrl, onConnect }: SettingsPanelProps): React.JSX.Element;
 export default SettingsPanel;
 //# sourceMappingURL=SettingsPanel.d.ts.map

package/dist/studio/components/SettingsPanel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SettingsPanel.d.ts","sourceRoot":"","sources":["../../src/components/SettingsPanel.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAA8B,MAAM,OAAO,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,MAAM,WAAW,kBAAkB;IACjC,EAAE,CAAC,EAAE,YAAY,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAClD;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,EAAE,SAAc,EAAE,KAAU,EAAE,SAAS,EAAE,EAAE,kBAAkB,qBAmC9F;AAED,eAAe,aAAa,CAAC"}
+{"version":3,"file":"SettingsPanel.d.ts","sourceRoot":"","sources":["../../src/components/SettingsPanel.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAA8B,MAAM,OAAO,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,MAAM,WAAW,kBAAkB;IACjC,EAAE,CAAC,EAAE,YAAY,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAClD;AAWD,wBAAgB,aAAa,CAAC,EAAE,EAAE,EAAE,SAAc,EAAE,KAAU,EAAE,cAAmB,EAAE,aAAa,EAAE,YAAiB,EAAE,SAAS,EAAE,EAAE,kBAAkB,qBA8CrJ;AAED,eAAe,aAAa,CAAC"}

package/dist/studio/components/index.js

@@ -1,4 +1,4 @@
-import { _ as e, a as t, c as n, d as r, f as i, g as a, h as o, i as s, l as c, m as l, n as u, o as d, p as f, r as p, s as m, t as h, u as g, v as _, y as v } from "../components-CehkcX_k.js";
-import { t as y } from "../KeyManagementPanel-DZuSeWBK.js";
-import { ManagedInstancePanel as b } from "./ManagedInstancePanel.js";
-export { e as AgentExplorer, l as ApplicationDesigner, f as AskFeltDB, c as CapabilityExplorer, p as ConflictExplorer, g as ContractInspector, v as ExecutionViewer, o as GlobalSearch, h as HealthCenter, y as KeyManagementPanel, b as ManagedInstancePanel, r as ModuleExplorer, t as OperationsExplorer, n as OverviewDashboard, s as PeerMap, i as ProposalBrowser, u as ProvenanceViewer, d as ReferenceExplorer, a as SettingsPanel, m as StateExplorer, _ as WorkflowVisualizer };
+import { _ as e, a as t, b as n, c as r, d as i, f as a, g as o, h as s, i as c, l, m as u, n as d, o as f, p, r as m, s as h, t as g, u as _, v, y } from "../components-CJFgdKG6.js";
+import { t as b } from "../KeyManagementPanel-DZuSeWBK.js";
+import { ManagedInstancePanel as x } from "./ManagedInstancePanel.js";
+export { v as AgentExplorer, s as ApplicationDesigner, u as AskFeltDB, l as CapabilityExplorer, m as ConflictExplorer, _ as ContractInspector, n as ExecutionViewer, o as GlobalSearch, g as HealthCenter, b as KeyManagementPanel, x as ManagedInstancePanel, a as ModuleExplorer, t as OperationsExplorer, r as OverviewDashboard, c as PeerMap, p as ProposalBrowser, d as ProvenanceViewer, f as ReferenceExplorer, e as SettingsPanel, h as StateExplorer, y as WorkflowVisualizer, i as dataCollectionLocation };