@feltdb/core 0.7.4 → 0.8.1

package/dist/create/server-source/crates/feltdb-server/tests/revision_recovery_integration_test.rs

@@ -124,10 +124,7 @@ mod revision_recovery_tests {
         });
 
         // Both requests should have the same recovery_id
-        assert_eq!(
-            request1.get("recoveryId"),
-            request2.get("recoveryId")
-        );
+        assert_eq!(request1.get("recoveryId"), request2.get("recoveryId"));
     }
 
     /// Test environment parameter handling

package/dist/create/template/default-project/feltdb.flow

@@ -1,6 +1,11 @@
 flow_version 1
 
 app FeltDBStarter {
+  // Optional billing semantics. Uncomment to include the Stripe-compatible module:
+  // module stripe {
+  //   provider stripe-compatible
+  //   version 1.0.0
+  // }
   collection User {
     email: text
     name: text

package/dist/create/template/default-project/src/context/AuthContext.tsx

@@ -17,7 +17,15 @@ export function AuthProvider({ children }: { children: ReactNode }) {
   const loading = sessionRecords.loading || userRecords.loading || membershipRecords.loading || organizationRecords.loading;
   const establish = (next: Session) => { sessionStorage.setItem(SESSION_KEY, next.id); setSessionId(next.id); };
   const value = useMemo<AuthValue>(() => ({ loading, authenticated: Boolean(session && user && membership && organization), session, user, membership, organization,
-    signUp: async input => { await db.auth.signUp({ email: input.email, password: input.password, display_name: input.name }); establish(await createAccount(input)); },
+    signUp: async input => {
+      try {
+        await db.auth.signUp({ email: input.email, password: input.password, display_name: input.name });
+      } catch (error) {
+        if ((error as { code?: string }).code !== 'CONFLICT') throw error;
+        await db.auth.signIn({ email: input.email, password: input.password });
+      }
+      establish(await createAccount(input));
+    },
     signIn: async (email, password) => { await db.auth.signIn({ email, password }); establish(await createSession(email)); },
     signOut: async () => { if (session) await sessions.delete(session.id); await db.auth.signOut(); sessionStorage.removeItem(SESSION_KEY); setSessionId(null); },
   }), [loading, session, user, membership, organization]);

package/dist/create/template/default-project/src/pages/SignUp.tsx

@@ -3,6 +3,6 @@ import { useAuth } from '../context/AuthContext';
 
 export function SignUp() {
   const { signUp } = useAuth(); const [error, setError] = useState(''); const [busy, setBusy] = useState(false);
-  async function submit(event: FormEvent<HTMLFormElement>) { event.preventDefault(); setBusy(true); setError(''); const form = new FormData(event.currentTarget); try { await signUp({ name: String(form.get('name')), email: String(form.get('email')), password: String(form.get('password')), organization: String(form.get('organization')) }); } catch { setError('We could not create your account. Check the details and try again.'); setBusy(false); } }
+  async function submit(event: FormEvent<HTMLFormElement>) { event.preventDefault(); setBusy(true); setError(''); const form = new FormData(event.currentTarget); try { await signUp({ name: String(form.get('name')), email: String(form.get('email')), password: String(form.get('password')), organization: String(form.get('organization')) }); } catch (error) { setError(error instanceof Error ? error.message : 'We could not create your account. Check the details and try again.'); setBusy(false); } }
   return <><span className="eyebrow">Create your workspace</span><h2>Start with durable state.</h2><p className="muted">Your actor, account, and organization are established at the FeltDB boundary.</p><form onSubmit={submit}><label>Name<input name="name" autoComplete="name" required placeholder="Ada Lovelace" /></label><label>Work email<input name="email" type="email" autoComplete="email" required placeholder="ada@example.com" /></label><label>Password<input name="password" type="password" autoComplete="new-password" minLength={8} required /></label><label>Organization<input name="organization" required placeholder="Analytical Engines" /></label>{error && <p className="error">{error}</p>}<button disabled={busy}>{busy ? 'Creating…' : 'Create account'}</button></form><p className="switch">Already have an account? <a href="?view=signin">Sign in</a></p></>;
 }

package/dist/flowspec.d.ts

@@ -38,6 +38,7 @@ export interface FlowSpec {
     triggers: FlowTrigger[];
     policies: FlowBlock[];
     schedules: FlowBlock[];
+    modules?: import('./module.js').FlowModuleDeclaration[];
 }
 export interface FlowDiagnostic {
     severity: 'error' | 'warning';

package/dist/flowspec.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flowspec.d.ts","sourceRoot":"","sources":["../src/flowspec.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE;AAC5E,MAAM,WAAW,SAAS;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE;AAC7E,MAAM,WAAW,cAAc;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,SAAS,EAAE,CAAC;IAAC,OAAO,EAAE,SAAS,EAAE,CAAA;CAAE;AAC3F,MAAM,WAAW,SAAS;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE;AACjE,MAAM,WAAW,QAAS,SAAQ,SAAS;CAAG;AAC9C,MAAM,WAAW,YAAY;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,QAAQ,EAAE,CAAA;CAAE;AACrF,MAAM,WAAW,WAAW;IAAG,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE;AACpE,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,CAAC,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,YAAY,EAAE,SAAS,EAAE,CAAC;IAC1B,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,QAAQ,EAAE,SAAS,EAAE,CAAC;IACtB,SAAS,EAAE,SAAS,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAAG,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE;AACjG,MAAM,WAAW,YAAY;IAAG,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE;AACvF,MAAM,WAAW,sBAAsB;IAAG,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,oBAAoB,GAAG,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AAEpK,eAAO,MAAM,oBAAoB,yLAA0L,CAAC;AAC5N,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAQ1D;AAED,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAErE,sHAAsH;AACtH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,mBAAmB,CAY/G;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,QAAQ,CAG1E;AAqGD,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAA4C;AAEnG,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,GAAG,cAAc,EAAE,CAkBjE;AAGD,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAUrD;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,GAAG,YAAY,CAQ5E;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,GAAG,sBAAsB,EAAE,CAsBjG;AAED,wBAAgB,aAAa,CAAC,GAAG,SAAU,GAAG,QAAQ,CAAyI"}
+{"version":3,"file":"flowspec.d.ts","sourceRoot":"","sources":["../src/flowspec.ts"],"names":[],"mappings":"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"}

package/dist/flowspec.js

@@ -3,7 +3,7 @@ export function isValidFlowFieldType(type) {
     const value = type.trim();
     if (FLOW_PRIMITIVE_TYPES.includes(value))
         return true;
-    if (/^ref [A-Za-z_][A-Za-z0-9_-]*$/.test(value))
+    if (/^ref [A-Za-z_][A-Za-z0-9_-]*(?:\.[A-Za-z_][A-Za-z0-9_-]*)?$/.test(value))
         return true;
     if (/^enum\([^)]+\)$/.test(value))
         return value.slice(5, -1).split(',').every(item => item.trim().length > 0);
@@ -12,23 +12,30 @@ export function isValidFlowFieldType(type) {
     const container = /^(array|map)<(.+)>$/.exec(value);
     return Boolean(container && isValidFlowFieldType(container[2]));
 }
+import { resolveFeltDBModules } from './module.js';
 /** FlowSpec is a portable source format; the returned Rust manifest is authoritative only after server validation. */
 export function flowSpecToManifest(spec, tenantId, applicationId) {
-    const capabilities = spec.capabilities.map(value => ({
-        name: value.name,
-        visibility: (value.statements.find(statement => statement.startsWith('visibility '))?.slice('visibility '.length) || 'public'),
-    }));
+    const modules = resolveFeltDBModules(spec.modules);
+    const capabilities = [...spec.capabilities.map(value => ({
+            name: value.name,
+            visibility: (value.statements.find(statement => statement.startsWith('visibility '))?.slice('visibility '.length) || 'public'),
+        })), ...modules.flatMap(module => module.capabilities.map(name => ({ name, provider: module.id, visibility: 'internal' })))];
     const policySubject = (statements, operation) => statements.map(value => new RegExp(`^${operation}\\s*:\\s*(.+)$`).exec(value)?.[1]).find(Boolean);
     const manifestField = (field) => {
         const reference = field.type.startsWith('ref ') ? field.type.slice(4) : undefined;
         const enumValues = field.type.startsWith('enum(') && field.type.endsWith(')') ? field.type.slice(5, -1).split(',').map(value => value.trim()) : undefined;
         return { name: field.name, type: reference ? 'reference' : enumValues ? 'enum' : field.type, required: !field.optional, ...(reference ? { reference } : {}), ...(enumValues ? { enum_values: enumValues } : {}) };
     };
-    return { application_id: applicationId, tenant_id: tenantId, schema: 1, metadata: { name: spec.app, labels: {} }, collections: spec.collections.map(value => ({ name: value.name, fields: value.fields.map(manifestField) })), indexes: spec.collections.flatMap(collection => collection.indexes.map(index => ({ name: index.name, collection: collection.name, fields: [index.expression], unique: index.kind === 'unique' }))), references: [], queries: [], actions: [], workflows: spec.workflows.map(value => ({ name: value.name, steps: value.steps.map(step => ({ name: step.name, capability: step.statements.find(statement => statement.startsWith('capability '))?.slice('capability '.length) })) })), triggers: spec.triggers.map((value, index) => ({ name: `trigger-${index + 1}`, event: value.event, workflow: spec.workflows[0]?.name || '' })), schedules: spec.schedules.map(value => ({ name: value.name, expression: value.statements[0] || '', workflow: spec.workflows[0]?.name || '' })), agents: spec.agents.map(value => ({ name: value.name, capabilities: capabilities.map(capability => capability.name).filter(name => value.statements.some(statement => statement.includes(name))) })), capabilities, connections: [], policies: spec.policies.map(value => ({ name: value.name, resource: value.name, read: policySubject(value.statements, 'read'), write: policySubject(value.statements, 'write'), capabilities: [] })), ui: { routes: [], bindings: [], forms: [], dashboards: [] }, environments: ['development', 'preview', 'staging', 'production'].map(name => ({ name, configuration: {} })), artifacts: [], deployment: { environments: ['development', 'preview', 'staging', 'production'] }, runtime: { contract: 1, minimum_engine: '0.2.0', maximum_engine_exclusive: '2.0.0' } };
+    const indexFields = (expression) => {
+        const trimmed = expression.trim();
+        const match = trimmed.match(/^(?:[A-Za-z_][A-Za-z0-9_]*)?\((.*)\)$/);
+        return (match?.[1] ?? trimmed).split(',').map(value => value.trim()).filter(Boolean);
+    };
+    return { application_id: applicationId, tenant_id: tenantId, schema: 1, metadata: { name: spec.app, labels: {} }, collections: spec.collections.map(value => ({ name: value.name, fields: value.fields.map(manifestField) })), indexes: spec.collections.flatMap(collection => collection.indexes.map(index => ({ name: `${collection.name}.${index.name}`, collection: collection.name, fields: indexFields(index.expression), unique: index.kind === 'unique' }))), references: [], queries: [], actions: [], workflows: spec.workflows.map(value => ({ name: value.name, steps: value.steps.map(step => ({ name: step.name, capability: step.statements.find(statement => statement.startsWith('capability '))?.slice('capability '.length) })) })), triggers: spec.triggers.map((value, index) => ({ name: `trigger-${index + 1}`, event: value.event, workflow: spec.workflows[0]?.name || '' })), schedules: spec.schedules.map(value => ({ name: value.name, expression: value.statements[0] || '', workflow: spec.workflows[0]?.name || '' })), agents: spec.agents.map(value => ({ name: value.name, capabilities: capabilities.map(capability => capability.name).filter(name => value.statements.some(statement => statement.includes(name))) })), capabilities, modules: resolveFeltDBModules(spec.modules), connections: [], policies: spec.policies.map(value => ({ name: value.name, resource: value.name, read: policySubject(value.statements, 'read'), write: policySubject(value.statements, 'write'), capabilities: [] })), ui: { routes: [], bindings: [], forms: [], dashboards: [] }, environments: ['development', 'preview', 'staging', 'production'].map(name => ({ name, configuration: {} })), artifacts: [], deployment: { environments: ['development', 'preview', 'staging', 'production'] }, runtime: { contract: 1, minimum_engine: '0.2.0', maximum_engine_exclusive: '2.0.0' } };
 }
 export function manifestToFlowSpec(manifest) {
     const fieldType = (field) => field.reference ? `ref ${field.reference}` : field.enum_values?.length ? `enum(${field.enum_values.join(',')})` : field.type;
-    return { version: 1, app: manifest.metadata.name, collections: manifest.collections.map(value => ({ name: value.name, fields: value.fields.map(field => ({ name: field.name, type: fieldType(field), optional: !field.required })), indexes: manifest.indexes.filter(index => index.collection === value.name).map(index => ({ name: index.name, kind: index.unique ? 'unique' : 'index', expression: index.fields.join(', ') })) })), capabilities: manifest.capabilities.map(value => ({ name: value.name, statements: [...(value.provider ? [`provider ${value.provider}`] : []), `visibility ${value.visibility || 'public'}`] })), agents: manifest.agents.map(value => ({ name: value.name, statements: value.capabilities.map(capability => `capability ${capability}`) })), workflows: manifest.workflows.map(value => ({ name: value.name, parameters: '', steps: value.steps.map(step => ({ name: step.name, statements: step.capability ? [`capability ${step.capability}`] : [] })) })), triggers: manifest.triggers.map(value => ({ event: value.event, statements: [`run ${value.workflow}`] })), policies: manifest.policies.map(value => ({ name: value.name, statements: [...(value.read ? [`read: ${value.read}`] : []), ...(value.write ? [`write: ${value.write}`] : []), ...value.capabilities] })), schedules: manifest.schedules.map(value => ({ name: value.name, statements: [value.expression, `run ${value.workflow}`] })) };
+    return { version: 1, app: manifest.metadata.name, collections: manifest.collections.map(value => ({ name: value.name, fields: value.fields.map(field => ({ name: field.name, type: fieldType(field), optional: !field.required })), indexes: manifest.indexes.filter(index => index.collection === value.name).map(index => ({ name: index.name, kind: index.unique ? 'unique' : 'index', expression: index.fields.join(', ') })) })), capabilities: manifest.capabilities.map(value => ({ name: value.name, statements: [...(value.provider ? [`provider ${value.provider}`] : []), `visibility ${value.visibility || 'public'}`] })), agents: manifest.agents.map(value => ({ name: value.name, statements: value.capabilities.map(capability => `capability ${capability}`) })), workflows: manifest.workflows.map(value => ({ name: value.name, parameters: '', steps: value.steps.map(step => ({ name: step.name, statements: step.capability ? [`capability ${step.capability}`] : [] })) })), triggers: manifest.triggers.map(value => ({ event: value.event, statements: [`run ${value.workflow}`] })), policies: manifest.policies.map(value => ({ name: value.name, statements: [...(value.read ? [`read: ${value.read}`] : []), ...(value.write ? [`write: ${value.write}`] : []), ...value.capabilities] })), schedules: manifest.schedules.map(value => ({ name: value.name, statements: [value.expression, `run ${value.workflow}`] })), modules: (manifest.modules ?? []).map(value => ({ name: value.id, provider: value.provider, version: value.version })) };
 }
 function lex(source) {
     const tokens = [];
@@ -135,11 +142,20 @@ class Parser {
         const app = this.identifier();
         this.take('{');
         this.newlines();
-        const spec = { version, app, collections: [], capabilities: [], agents: [], workflows: [], triggers: [], policies: [], schedules: [] };
+        const spec = { version, app, collections: [], capabilities: [], agents: [], workflows: [], triggers: [], policies: [], schedules: [], modules: [] };
         while (!this.peek('}')) {
             const kind = this.take().value;
             if (kind === 'collection')
                 spec.collections.push(this.collection());
+            else if (kind === 'module') {
+                const name = this.identifier();
+                const statements = this.statements();
+                const provider = statements.find(value => value.startsWith('provider '))?.slice(9);
+                const version = statements.find(value => value.startsWith('version '))?.slice(8);
+                if (!provider)
+                    throw new Error(`Module ${name} requires provider`);
+                spec.modules.push({ name, provider: provider.replace(/^"|"$/g, ''), version: version?.replace(/^"|"$/g, '') });
+            }
             else if (kind === 'workflow')
                 spec.workflows.push(this.workflow());
             else if (kind === 'trigger')
@@ -238,6 +254,14 @@ export function validateFlowSpec(spec) {
     duplicate('capability', spec.capabilities.map(value => value.name));
     duplicate('agent', spec.agents.map(value => value.name));
     duplicate('workflow', spec.workflows.map(value => value.name));
+    duplicate('module', (spec.modules ?? []).map(value => value.name));
+    let resolvedModules = [];
+    try {
+        resolvedModules = resolveFeltDBModules(spec.modules);
+    }
+    catch (error) {
+        diagnostics.push({ severity: 'error', path: 'modules', message: error instanceof Error ? error.message : String(error) });
+    }
     for (const capability of spec.capabilities) {
         const visibility = capability.statements.find(statement => statement.startsWith('visibility '))?.slice('visibility '.length);
         if (visibility && !['public', 'agent', 'workflow', 'internal'].includes(visibility))
@@ -249,8 +273,13 @@ export function validateFlowSpec(spec) {
         for (const field of collection.fields) {
             if (!isValidFlowFieldType(field.type))
                 diagnostics.push({ severity: 'error', path: `${collection.name}.${field.name}`, message: `Unsupported field type ${field.type}` });
-            if (field.type.startsWith('ref ') && !collections.has(field.type.slice(4)))
-                diagnostics.push({ severity: 'error', path: `${collection.name}.${field.name}`, message: `Unknown referenced collection ${field.type.slice(4)}` });
+            if (field.type.startsWith('ref ')) {
+                const target = field.type.slice(4);
+                const [moduleId, model] = target.split('.');
+                const moduleReference = model && resolvedModules.some(module => module.id === moduleId && module.models.some(value => value.name === model));
+                if (!collections.has(target) && !moduleReference)
+                    diagnostics.push({ severity: 'error', path: `${collection.name}.${field.name}`, message: `Unknown referenced collection or module model ${target}` });
+            }
         }
     }
     for (const workflow of spec.workflows) {
@@ -258,6 +287,14 @@ export function validateFlowSpec(spec) {
         if (!workflow.steps.length)
             diagnostics.push({ severity: 'error', message: `Workflow ${workflow.name} has no steps` });
     }
+    for (const trigger of spec.triggers) {
+        const moduleId = trigger.event.split('.')[0];
+        const module = resolvedModules.find(value => value.id === moduleId);
+        if (moduleId && trigger.event.split('.').length >= 3 && !module)
+            diagnostics.push({ severity: 'error', path: `trigger ${trigger.event}`, message: `Module event ${trigger.event} requires module ${moduleId}` });
+        else if (module && !module.events.includes(trigger.event))
+            diagnostics.push({ severity: 'error', path: `trigger ${trigger.event}`, message: `Unknown ${moduleId} module event ${trigger.event}` });
+    }
     return diagnostics;
 }
 function block(kind, value, indent = '  ') { return `${indent}${kind} ${value.name} {\n${value.statements.map(line => `${indent}  ${line}`).join('\n')}\n${indent}}`; }
@@ -277,13 +314,15 @@ export function formatFlowSpec(spec) {
         declarations.push(block('policy', value));
     for (const value of spec.schedules)
         declarations.push(block('schedule', value));
+    for (const value of spec.modules ?? [])
+        declarations.push(`  module ${value.name} {\n    provider ${value.provider}\n${value.version ? `    version ${value.version}\n` : ''}  }`);
     return `flow_version ${spec.version}\n\napp ${spec.app} {\n${declarations.join('\n\n')}\n}\n`;
 }
 export function diffFlowSpec(before, after) {
     const flatten = (spec) => new Map([
         ...spec.collections.map(value => [`collection ${value.name}`, JSON.stringify(value)]), ...spec.capabilities.map(value => [`capability ${value.name}`, JSON.stringify(value)]),
         ...spec.agents.map(value => [`agent ${value.name}`, JSON.stringify(value)]), ...spec.workflows.map(value => [`workflow ${value.name}`, JSON.stringify(value)]),
-        ...spec.triggers.map(value => [`trigger ${value.event}`, JSON.stringify(value)]), ...spec.policies.map(value => [`policy ${value.name}`, JSON.stringify(value)]), ...spec.schedules.map(value => [`schedule ${value.name}`, JSON.stringify(value)]),
+        ...spec.triggers.map(value => [`trigger ${value.event}`, JSON.stringify(value)]), ...spec.policies.map(value => [`policy ${value.name}`, JSON.stringify(value)]), ...spec.schedules.map(value => [`schedule ${value.name}`, JSON.stringify(value)]), ...(spec.modules ?? []).map(value => [`module ${value.name}`, JSON.stringify(value)]),
     ]);
     const left = flatten(before), right = flatten(after);
     return { added: [...right.keys()].filter(key => !left.has(key)), removed: [...left.keys()].filter(key => !right.has(key)), changed: [...right.keys()].filter(key => left.has(key) && left.get(key) !== right.get(key)) };
@@ -323,4 +362,4 @@ export function planFlowSpecMigration(before, after) {
         operations.push({ kind: 'remove', target, safety: 'destructive', detail: 'Application primitive is no longer declared' });
     return operations;
 }
-export function emptyFlowSpec(app = 'MyApp') { return { version: 1, app, collections: [], capabilities: [], agents: [], workflows: [], triggers: [], policies: [], schedules: [] }; }
+export function emptyFlowSpec(app = 'MyApp') { return { version: 1, app, collections: [], capabilities: [], agents: [], workflows: [], triggers: [], policies: [], schedules: [], modules: [] }; }

package/dist/http-client.d.ts

@@ -4,31 +4,183 @@
  * 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 { ApplicationUnderstanding } from './application-understanding.js';
+import type { ConvergenceResult } from './convergence.js';
+import type { ImplementationPlan, Intent, IntentEvent, IntentExecutionResult } from './intent.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 intent execution and its durable semantic artifacts. */
+    readonly intents: {
+        execute: (rawRequest: string) => Promise<IntentExecutionResult>;
+        list: () => Promise<{
+            intents: Intent[];
+        }>;
+        get: (id: string) => Promise<Intent>;
+        understanding: (id: string) => Promise<ApplicationUnderstanding>;
+        plan: (id: string) => Promise<ImplementationPlan>;
+        proposal: (id: string) => Promise<FeltDBProposalRecord>;
+        history: (id: string) => Promise<{
+            events: IntentEvent[];
+        }>;
+    };
+    /** 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;
+            contract_diff?: string[];
+            source_plan?: {
+                files: Array<{
+                    path: string;
+                    action: string;
+                }>;
+            };
+            understanding?: ApplicationUnderstanding;
+            evidence_hash?: string;
+            understanding_hash?: string;
+        }) => 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, currentEvidenceHash?: 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>;
+        convergence: (id: string) => Promise<{
+            convergence: ConvergenceResult[];
+        }>;
+        recordConvergence: (id: string, result: ConvergenceResult) => Promise<ConvergenceResult>;
     };
 }
 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,92 @@ 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 intent execution and its durable semantic artifacts. */
+    intents = {
+        execute: (rawRequest) => this.request('/v1/intents', { method: 'POST', body: JSON.stringify(this.scopeBody({ raw_request: rawRequest })) }),
+        list: () => this.request(this.scoped('/v1/intents')),
+        get: (id) => this.request(this.scoped(`/v1/intents/${encodeURIComponent(id)}`)),
+        understanding: (id) => this.request(this.scoped(`/v1/intents/${encodeURIComponent(id)}/understanding`)),
+        plan: (id) => this.request(this.scoped(`/v1/intents/${encodeURIComponent(id)}/plan`)),
+        proposal: (id) => this.request(this.scoped(`/v1/intents/${encodeURIComponent(id)}/proposal`)),
+        history: (id) => this.request(this.scoped(`/v1/intents/${encodeURIComponent(id)}/history`)),
+    };
+    /** Canonical Proposal lifecycle. Repository application is intentionally absent. */
+    proposals = {
+        create: (proposal) => this.request('/v1/proposals', { method: 'POST', body: JSON.stringify(this.scopeBody({ proposal_version: 1, contract_diff: [], source_plan: { files: [] }, ...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, currentEvidenceHash) => this.request(this.scoped(`/v1/proposals/${encodeURIComponent(id)}/status`, { current_evidence_hash: currentEvidenceHash })),
+        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 })) }),
+        convergence: (id) => this.request(this.scoped(`/v1/proposals/${encodeURIComponent(id)}/convergence`)),
+        recordConvergence: (id, result) => this.request(`/v1/proposals/${encodeURIComponent(id)}/convergence`, { method: 'POST', body: JSON.stringify(this.scopeBody(result)) }),
+    };
 }
 export function createClient(options) {
     return new FeltDBClient(options);

package/dist/http-db.d.ts

@@ -41,8 +41,11 @@ export declare class HttpJsDb implements JsDb {
     private readonly applicationId?;
     private readonly environment;
     private activeRevision?;
+    private readonly authWaiters;
     constructor(options: HttpRuntimeOptions);
     private headers;
+    private updateToken;
+    private waitForAuthChange;
     auth_request<T extends {
         access_token?: string;
     }>(operation: 'signup' | 'signin' | 'signout' | 'session', body?: unknown): Promise<T>;