@feltdb/core 0.2.0 → 0.3.0

package/dist/sync-contract.js

@@ -0,0 +1,90 @@
+class StatusSignal {
+    constructor(value = 'offline') {
+        this.value = value;
+        this.listeners = new Set();
+    }
+    subscribe(listener) { this.listeners.add(listener); listener(this.value); return () => this.listeners.delete(listener); }
+    set(value) { this.value = value; for (const listener of this.listeners)
+        listener(value); }
+    get() { return this.value; }
+}
+export class SyncController {
+    constructor(config) {
+        this.config = config;
+        this.status = new StatusSignal();
+        this.fetcher = config.fetcher || fetch;
+        this.restore();
+    }
+    key() { return `feltdb:sync:v1:${this.config.device.application_id}:${this.config.device.device_id}`; }
+    restore() { if (typeof localStorage === 'undefined')
+        return; try {
+        const value = JSON.parse(localStorage.getItem(this.key()) || '{}');
+        this.sessionId = value.sessionId;
+        this.cursor = value.cursor;
+        this.error = value.error;
+    }
+    catch { } }
+    persist() { if (typeof localStorage !== 'undefined')
+        localStorage.setItem(this.key(), JSON.stringify({ sessionId: this.sessionId, cursor: this.cursor, error: this.error, outbox: this.readOutbox() })); }
+    readOutbox() { if (typeof localStorage === 'undefined')
+        return []; try {
+        return JSON.parse(localStorage.getItem(`${this.key()}:outbox`) || '[]');
+    }
+    catch {
+        return [];
+    } }
+    writeOutbox(value) { if (typeof localStorage !== 'undefined')
+        localStorage.setItem(`${this.key()}:outbox`, JSON.stringify(value)); }
+    async request(path, body) { const response = await this.fetcher(`${this.config.endpoint || ''}/v1/sync/${path}`, { method: 'POST', credentials: 'include', headers: { 'content-type': 'application/json' }, body: JSON.stringify(body) }); const value = await response.json().catch(() => ({})); if (!response.ok)
+        throw new Error(value.error || `sync ${path} failed (${response.status})`); return value; }
+    async start() { this.status.set('connecting'); try {
+        if (!this.sessionId) {
+            const scope = { resources: this.config.scope.resources || this.config.scope.collections?.map(v => `flow://${this.config.device.application_id}/${v}/*`) || [], fields: this.config.scope.fields || {} };
+            const session = await this.request('session', { device: { ...this.config.device, created_at: Math.floor(Date.now() / 1000) }, scope, offline_grant: this.config.offlineGrant });
+            this.sessionId = session.session_id;
+            this.cursor = session.cursor;
+            this.persist();
+        }
+        await this.flush();
+        this.timer = setInterval(() => void this.flush(), 5000);
+        return this;
+    }
+    catch (error) {
+        this.error = String(error);
+        this.status.set('degraded');
+        this.persist();
+        throw error;
+    } }
+    async stop() { if (this.timer)
+        clearInterval(this.timer); if (this.sessionId)
+        await this.request('close', { session_id: this.sessionId }); this.status.set('offline'); }
+    enqueue(operation) { const outbox = this.readOutbox(); if (!outbox.some(v => v.operation_id === operation.operation_id)) {
+        outbox.push(operation);
+        this.writeOutbox(outbox);
+    } return operation.operation_id; }
+    async flush() { if (!this.sessionId || !this.cursor)
+        return; this.status.set('syncing'); try {
+        const pending = this.readOutbox();
+        if (pending.length) {
+            const result = await this.request('push', { session_id: this.sessionId, operations: pending });
+            const terminal = new Set([...result.acknowledgements.map(v => v.operation_id), ...result.rejections.filter(v => !v.retryable).map(v => v.operation_id)]);
+            this.writeOutbox(pending.filter(v => !terminal.has(v.operation_id)));
+            this.cursor = result.cursor;
+        }
+        const pulled = await this.request('pull', { session_id: this.sessionId, cursor: this.cursor, limit: 250 });
+        this.cursor = pulled.cursor;
+        await this.request('ack', { session_id: this.sessionId, cursor: this.cursor });
+        this.error = undefined;
+        this.status.set('synced');
+        this.persist();
+    }
+    catch (error) {
+        this.error = String(error);
+        this.status.set(typeof navigator !== 'undefined' && !navigator.onLine ? 'offline' : 'degraded');
+        this.persist();
+    } }
+    pending() { return this.readOutbox(); }
+    conflicts() { return this.readOutbox().filter((v) => v.status === 'CONFLICTED'); }
+    lastCursor() { return this.cursor; }
+    lastError() { return this.error; }
+}

package/dist/worker.d.ts

@@ -0,0 +1,90 @@
+import type { SignedGrant, AuthorizationSubject } from './authorization.js';
+export type WorkerLifecycle = 'REGISTERED' | 'READY' | 'BUSY' | 'DRAINING' | 'OFFLINE' | 'RECOVERING';
+export type WorkerHealth = 'HEALTHY' | 'DEGRADED' | 'UNHEALTHY' | 'UNKNOWN';
+export interface WorkerRegistration {
+    tenant_id: string;
+    application_id: string;
+    name: string;
+    runtime: 'wasm' | 'process' | 'container' | 'browser' | 'remote' | 'hosted' | 'edge' | 'customer';
+    version: string;
+    capabilities: string[];
+    workload_kinds?: string[];
+    resource_profile?: Record<string, number>;
+    labels?: Record<string, string>;
+    capacity: {
+        concurrency: number;
+        active?: number;
+    };
+    authorization_grant: SignedGrant;
+    registered_by: AuthorizationSubject;
+    registered_at?: number;
+}
+export interface Worker {
+    worker_id: string;
+    tenant_id: string;
+    application_id: string;
+    name: string;
+    runtime: string;
+    version: string;
+    declared_capabilities: string[];
+    granted_capabilities: string[];
+    workload_kinds: string[];
+    labels: Record<string, string>;
+    capacity: {
+        concurrency: number;
+        active: number;
+    };
+    health: WorkerHealth;
+    lifecycle: WorkerLifecycle;
+    last_seen: number;
+    capability_version: number;
+    claims: string[];
+}
+export interface WorkerPool {
+    pool_id: string;
+    tenant_id: string;
+    application_id?: string;
+    name: string;
+    capabilities: string[];
+    required_labels?: Record<string, string>;
+    worker_ids: string[];
+    max_concurrency?: number;
+    created_at: number;
+}
+declare class MeshTransport {
+    protected baseUrl: string;
+    protected fetcher: typeof fetch;
+    constructor(baseUrl?: string, fetcher?: typeof fetch);
+    protected json<T>(path: string, init?: RequestInit): Promise<T>;
+}
+export declare class WorkerClient extends MeshTransport {
+    register(input: WorkerRegistration): Promise<Worker>;
+    list(applicationId: string): Promise<{
+        workers: Worker[];
+    }>;
+    inspect(id: string): Promise<Worker>;
+    heartbeat(id: string, heartbeat: unknown, grant: SignedGrant): Promise<Worker>;
+    drain(id: string, grant: SignedGrant): Promise<Worker>;
+    recover(id: string, grant: SignedGrant): Promise<Worker>;
+    reconcile(id: string, reconciliation: unknown, grant: SignedGrant): Promise<unknown>;
+}
+export declare class WorkerPoolClient extends MeshTransport {
+    list(applicationId: string): Promise<{
+        pools: WorkerPool[];
+    }>;
+    create(pool: WorkerPool, grant: SignedGrant): Promise<WorkerPool>;
+    inspect(id: string): Promise<WorkerPool>;
+}
+export declare class MeshClient extends MeshTransport {
+    status(applicationId: string): Promise<{
+        workers: Worker[];
+        pools: WorkerPool[];
+        ready: number;
+        busy: number;
+    }>;
+    eligibleWorkers(workloadId: string): Promise<{
+        eligible_workers: string[];
+    }>;
+}
+export {};
+//# sourceMappingURL=worker.d.ts.map

package/dist/worker.d.ts.map

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

package/dist/worker.js

@@ -0,0 +1,26 @@
+class MeshTransport {
+    constructor(baseUrl = '', fetcher = fetch) {
+        this.baseUrl = baseUrl;
+        this.fetcher = fetcher;
+    }
+    async json(path, init) { const response = await this.fetcher(`${this.baseUrl}${path}`, { credentials: 'include', headers: { 'content-type': 'application/json', ...(init?.headers || {}) }, ...init }); const value = response.status === 204 ? undefined : await response.json(); if (!response.ok)
+        throw new Error(value?.error || `Mesh request failed (${response.status})`); return value; }
+}
+export class WorkerClient extends MeshTransport {
+    register(input) { return this.json('/v1/workers/register', { method: 'POST', body: JSON.stringify({ ...input, registered_at: input.registered_at || Math.floor(Date.now() / 1000) }) }); }
+    list(applicationId) { return this.json(`/v1/workers?application_id=${encodeURIComponent(applicationId)}`); }
+    inspect(id) { return this.json(`/v1/workers/${encodeURIComponent(id)}`); }
+    heartbeat(id, heartbeat, grant) { return this.json(`/v1/workers/${encodeURIComponent(id)}/heartbeat`, { method: 'POST', body: JSON.stringify({ heartbeat, grant }) }); }
+    drain(id, grant) { return this.json(`/v1/workers/${encodeURIComponent(id)}/drain`, { method: 'POST', body: JSON.stringify({ grant }) }); }
+    recover(id, grant) { return this.json(`/v1/workers/${encodeURIComponent(id)}/recover`, { method: 'POST', body: JSON.stringify({ grant }) }); }
+    reconcile(id, reconciliation, grant) { return this.json(`/v1/workers/${encodeURIComponent(id)}/reconcile`, { method: 'POST', body: JSON.stringify({ reconciliation, grant }) }); }
+}
+export class WorkerPoolClient extends MeshTransport {
+    list(applicationId) { return this.json(`/v1/worker-pools?application_id=${encodeURIComponent(applicationId)}`); }
+    create(pool, grant) { return this.json('/v1/worker-pools', { method: 'POST', body: JSON.stringify({ pool, grant }) }); }
+    inspect(id) { return this.json(`/v1/worker-pools/${encodeURIComponent(id)}`); }
+}
+export class MeshClient extends MeshTransport {
+    async status(applicationId) { const [workers, pools] = await Promise.all([new WorkerClient(this.baseUrl, this.fetcher).list(applicationId), new WorkerPoolClient(this.baseUrl, this.fetcher).list(applicationId)]); return { workers: workers.workers, pools: pools.pools, ready: workers.workers.filter(v => v.lifecycle === 'READY').length, busy: workers.workers.filter(v => v.lifecycle === 'BUSY').length }; }
+    eligibleWorkers(workloadId) { return this.json(`/v1/workloads/${encodeURIComponent(workloadId)}/eligible-workers`); }
+}

package/dist/workload.d.ts

@@ -0,0 +1,102 @@
+import type { AuthorizationSubject, SignedGrant } from './authorization.js';
+export type WorkloadState = 'CREATED' | 'READY' | 'CLAIMED' | 'RUNNING' | 'CHECKPOINTED' | 'RECOVERING' | 'CANCELLATION_REQUESTED' | 'SUCCEEDED' | 'FAILED' | 'CANCELLED' | 'TIMED_OUT' | 'DEAD_LETTER';
+export interface WorkloadRetryPolicy {
+    max_attempts: number;
+    initial_delay_ms: number;
+    max_delay_ms: number;
+    backoff: 'fixed' | 'exponential';
+    retry_on: string[];
+}
+export interface CreateWorkloadInput {
+    tenant_id: string;
+    application_id: string;
+    environment: string;
+    definition_id: string;
+    definition_revision: string;
+    trigger: string;
+    input: unknown;
+    requested_by: AuthorizationSubject;
+    authorization_snapshot: SignedGrant;
+    capability_snapshot: string[];
+    connection_scopes?: string[];
+    priority?: number;
+    idempotency_key: string;
+    retry_policy?: WorkloadRetryPolicy;
+    timeouts?: Record<string, number>;
+    dependencies?: Array<{
+        workload_id: string;
+        required_state?: WorkloadState;
+    }>;
+    created_at?: number;
+}
+export interface Workload {
+    workload_id: string;
+    tenant_id: string;
+    application_id: string;
+    definition_id: string;
+    input: unknown;
+    input_hash: string;
+    priority: number;
+    state: WorkloadState;
+    attempt_count: number;
+    retry_count: number;
+    next_attempt_at?: number;
+    last_failure?: string;
+    current_claim?: WorkloadClaim;
+    execution_history: unknown[];
+    attempts: unknown[];
+    checkpoints: unknown[];
+    result?: WorkloadResult;
+}
+export interface WorkloadClaim {
+    claim_id: string;
+    workload_id: string;
+    worker_id: string;
+    lease_id: string;
+    fencing_token: number;
+    claimed_at: number;
+    expires_at: number;
+}
+export interface WorkloadResult {
+    result_id: string;
+    workload_id: string;
+    attempt_id: string;
+    status: string;
+    output: unknown;
+    output_hash: string;
+    artifacts: string[];
+    produced_by: string;
+    created_at: number;
+}
+export declare class WorkloadClient {
+    private baseUrl;
+    private fetcher;
+    constructor(baseUrl?: string, fetcher?: typeof fetch);
+    private json;
+    create(input: CreateWorkloadInput): Promise<Workload>;
+    list(applicationId: string): Promise<{
+        workloads: Workload[];
+    }>;
+    inspect(id: string): Promise<Workload>;
+    claim(id: string, input: {
+        worker_id: string;
+        lease_ms: number;
+        grant: SignedGrant;
+    }): Promise<WorkloadClaim>;
+    start(id: string, fence: unknown): Promise<void>;
+    heartbeat(id: string, input: unknown): Promise<WorkloadClaim>;
+    checkpoint(id: string, input: unknown): Promise<unknown>;
+    complete(id: string, input: unknown): Promise<WorkloadResult>;
+    fail(id: string, input: unknown): Promise<{
+        state: WorkloadState;
+    }>;
+    confirmCancelled(id: string, fence: unknown): Promise<void>;
+    executionContext(id: string, input: unknown): Promise<unknown>;
+    cancel(id: string, grant: SignedGrant): Promise<{
+        state: WorkloadState;
+    }>;
+    retry(id: string, grant: SignedGrant): Promise<void>;
+    history(id: string): Promise<unknown>;
+    result(id: string): Promise<WorkloadResult | undefined>;
+}
+//# sourceMappingURL=workload.d.ts.map

package/dist/workload.d.ts.map

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

package/dist/workload.js

@@ -0,0 +1,23 @@
+export class WorkloadClient {
+    constructor(baseUrl = '', fetcher = fetch) {
+        this.baseUrl = baseUrl;
+        this.fetcher = fetcher;
+    }
+    async json(path, init) { const response = await this.fetcher(`${this.baseUrl}${path}`, { credentials: 'include', headers: { 'content-type': 'application/json', ...(init?.headers || {}) }, ...init }); const value = response.status === 204 ? undefined : await response.json(); if (!response.ok)
+        throw new Error(value?.error || `Workload request failed (${response.status})`); return value; }
+    create(input) { return this.json('/v1/workloads', { method: 'POST', body: JSON.stringify({ ...input, created_at: input.created_at || Math.floor(Date.now() / 1000) }) }); }
+    list(applicationId) { return this.json(`/v1/workloads?application_id=${encodeURIComponent(applicationId)}`); }
+    inspect(id) { return this.json(`/v1/workloads/${encodeURIComponent(id)}`); }
+    claim(id, input) { return this.json(`/v1/workloads/${encodeURIComponent(id)}/claim`, { method: 'POST', body: JSON.stringify(input) }); }
+    start(id, fence) { return this.json(`/v1/workloads/${encodeURIComponent(id)}/start`, { method: 'POST', body: JSON.stringify(fence) }); }
+    heartbeat(id, input) { return this.json(`/v1/workloads/${encodeURIComponent(id)}/heartbeat`, { method: 'POST', body: JSON.stringify(input) }); }
+    checkpoint(id, input) { return this.json(`/v1/workloads/${encodeURIComponent(id)}/checkpoint`, { method: 'POST', body: JSON.stringify(input) }); }
+    complete(id, input) { return this.json(`/v1/workloads/${encodeURIComponent(id)}/complete`, { method: 'POST', body: JSON.stringify(input) }); }
+    fail(id, input) { return this.json(`/v1/workloads/${encodeURIComponent(id)}/fail`, { method: 'POST', body: JSON.stringify(input) }); }
+    confirmCancelled(id, fence) { return this.json(`/v1/workloads/${encodeURIComponent(id)}/cancelled`, { method: 'POST', body: JSON.stringify(fence) }); }
+    executionContext(id, input) { return this.json(`/v1/workloads/${encodeURIComponent(id)}/context`, { method: 'POST', body: JSON.stringify(input) }); }
+    cancel(id, grant) { return this.json(`/v1/workloads/${encodeURIComponent(id)}/cancel`, { method: 'POST', body: JSON.stringify({ grant }) }); }
+    retry(id, grant) { return this.json(`/v1/workloads/${encodeURIComponent(id)}/retry`, { method: 'POST', body: JSON.stringify({ grant }) }); }
+    history(id) { return this.json(`/v1/workloads/${encodeURIComponent(id)}/history`); }
+    result(id) { return this.json(`/v1/workloads/${encodeURIComponent(id)}/result`); }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@feltdb/core",
-  "version": "0.2.0",
-  "description": "FeltDB Core - The application-facing database API",
+  "version": "0.3.0",
+  "description": "FeltDB Core - Application-facing database API with state-first reactivity",
   "license": "MIT",
   "type": "module",
   "main": "dist/index.js",
@@ -19,14 +19,26 @@
     }
   },
   "files": [
-    "dist/"
+    "dist/",
+    "README.md"
   ],
   "scripts": {
     "build": "rm -rf dist && tsc",
-    "test": "node ../../test-runner.ts"
+    "test": "node ../../test-runner.ts",
+    "type-check": "tsc --noEmit"
   },
+  "keywords": [
+    "feltdb",
+    "database",
+    "reactive",
+    "state-first",
+    "collections",
+    "workflows",
+    "sync"
+  ],
+  "author": "FeltDB Contributors",
   "dependencies": {
-    "@feltdb/wasm": "^0.2.0"
+    "@feltdb/wasm": "^0.3.0"
   },
   "devDependencies": {
     "typescript": "^5.0.0",