@appport/sdk 1.0.1

package/node_modules/@appport/core/dist/operations.js

@@ -0,0 +1,210 @@
+import { errors, isTerminalStatus, newOperationId } from "@appport/protocol";
+import { s } from "@appport/schema";
+import { defineCapability, defineStreamCapability } from "./capability.js";
+import { toWireError } from "./sanitize.js";
+import { AsyncChannel } from "./streams.js";
+export class MemoryOperationStore {
+    #records = new Map();
+    #listeners = new Set();
+    async create(input) {
+        const now = new Date().toISOString();
+        const record = {
+            operationId: input.operationId ?? newOperationId(),
+            capability: input.capability,
+            status: "pending",
+            createdAt: now,
+            updatedAt: now,
+            ...(input.attributes ? { attributes: input.attributes } : {})
+        };
+        this.#records.set(record.operationId, record);
+        this.#notify(record);
+        return record;
+    }
+    async get(operationId) {
+        return this.#records.get(operationId);
+    }
+    async update(operationId, patch) {
+        const existing = this.#records.get(operationId);
+        if (!existing)
+            throw errors.notFound(`Unknown operation: ${operationId}`);
+        const next = {
+            ...existing,
+            ...patch,
+            updatedAt: new Date().toISOString()
+        };
+        this.#records.set(operationId, next);
+        this.#notify(next);
+        return next;
+    }
+    async list() {
+        return [...this.#records.values()];
+    }
+    subscribe(listener) {
+        this.#listeners.add(listener);
+        return () => this.#listeners.delete(listener);
+    }
+    #notify(record) {
+        for (const listener of this.#listeners) {
+            try {
+                listener(record);
+            }
+            catch {
+                // A broken observer never breaks an operation.
+            }
+        }
+    }
+}
+/**
+ * Runs work in the background against an {@link OperationStore}, returning the
+ * reference a capability should answer with.
+ */
+export class OperationRunner {
+    #store;
+    #cancellations = new Map();
+    constructor(store) {
+        this.#store = store;
+    }
+    get store() {
+        return this.#store;
+    }
+    async start(capability, work, options = {}) {
+        const record = await this.#store.create({
+            capability,
+            ...(options.attributes ? { attributes: options.attributes } : {})
+        });
+        const controller = new AbortController();
+        this.#cancellations.set(record.operationId, controller);
+        await this.#store.update(record.operationId, { status: "running" });
+        void (async () => {
+            try {
+                const result = await work({
+                    operationId: record.operationId,
+                    signal: controller.signal,
+                    progress: async (value) => {
+                        await this.#store.update(record.operationId, { progress: Math.max(0, Math.min(1, value)) });
+                    }
+                });
+                if (controller.signal.aborted) {
+                    await this.#store.update(record.operationId, { status: "cancelled" });
+                }
+                else {
+                    await this.#store.update(record.operationId, {
+                        status: "succeeded",
+                        progress: 1,
+                        ...(result === undefined ? {} : { result })
+                    });
+                }
+            }
+            catch (error) {
+                const wire = toWireError(error, "production");
+                await this.#store.update(record.operationId, {
+                    status: controller.signal.aborted ? "cancelled" : "failed",
+                    error: wire
+                });
+            }
+            finally {
+                this.#cancellations.delete(record.operationId);
+            }
+        })();
+        return { operationId: record.operationId, status: "running" };
+    }
+    /** Best-effort cancellation (§21). */
+    async cancel(operationId) {
+        const record = await this.#store.get(operationId);
+        if (!record)
+            throw errors.notFound(`Unknown operation: ${operationId}`);
+        if (isTerminalStatus(record.status))
+            return record.status;
+        this.#cancellations.get(operationId)?.abort();
+        const updated = await this.#store.update(operationId, { status: "cancelled" });
+        return updated.status;
+    }
+}
+const operationRecordSchema = s.object({
+    operationId: s.string(),
+    capability: s.string(),
+    status: s.enum(["pending", "running", "succeeded", "failed", "cancelled"]),
+    createdAt: s.timestamp(),
+    updatedAt: s.timestamp(),
+    progress: s.optional(s.number({ minimum: 0, maximum: 1 })),
+    result: s.optional(s.unknown()),
+    error: s.optional(s.object({ code: s.string(), message: s.string(), details: s.optional(s.unknown()) }, { additionalProperties: true })),
+    attributes: s.optional(s.record(s.unknown()))
+}, { title: "OperationRecord" });
+/**
+ * The standard `operations.status`, `operations.cancel` and `operations.events`
+ * capabilities (§47). Registering them makes long-running work observable
+ * through the same protocol as everything else.
+ */
+export function createOperationCapabilities(runner, options = {}) {
+    const authorization = options.authorization ?? [];
+    const status = defineCapability({
+        name: "operations.status",
+        version: 1,
+        description: "Reads the current state of a long-running operation.",
+        authorization,
+        input: s.object({ operationId: s.string() }),
+        output: operationRecordSchema,
+        async handler(input) {
+            const record = await runner.store.get(input.operationId);
+            if (!record)
+                throw errors.notFound(`Unknown operation: ${input.operationId}`);
+            return record;
+        }
+    });
+    const cancel = defineCapability({
+        name: "operations.cancel",
+        version: 1,
+        description: "Requests best-effort cancellation of a long-running operation.",
+        authorization,
+        input: s.object({ operationId: s.string() }),
+        output: s.object({
+            operationId: s.string(),
+            status: s.enum(["pending", "running", "succeeded", "failed", "cancelled"])
+        }),
+        async handler(input) {
+            const status = await runner.cancel(input.operationId);
+            return { operationId: input.operationId, status };
+        }
+    });
+    const events = defineStreamCapability({
+        name: "operations.events",
+        version: 1,
+        description: "Streams state changes for one long-running operation until it reaches a terminal state.",
+        authorization,
+        input: s.object({ operationId: s.string() }),
+        output: operationRecordSchema,
+        async handler(input, context) {
+            const current = await runner.store.get(input.operationId);
+            if (!current)
+                throw errors.notFound(`Unknown operation: ${input.operationId}`);
+            const channel = new AsyncChannel(64);
+            const unsubscribe = runner.store.subscribe((record) => {
+                if (record.operationId !== input.operationId)
+                    return;
+                void channel.push(record).then(() => {
+                    if (isTerminalStatus(record.status))
+                        channel.end();
+                });
+            });
+            context.signal.addEventListener("abort", () => {
+                unsubscribe();
+                channel.end();
+            }, { once: true });
+            void channel.push(current).then(() => {
+                if (isTerminalStatus(current.status))
+                    channel.end();
+            });
+            return (async function* () {
+                try {
+                    yield* channel;
+                }
+                finally {
+                    unsubscribe();
+                }
+            })();
+        }
+    });
+    return [status, cancel, events];
+}
+//# sourceMappingURL=operations.js.map

package/node_modules/@appport/core/dist/operations.js.map

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

package/node_modules/@appport/core/dist/public.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Application-developer API consumed by `@appport/sdk`.
+ *
+ * This is deliberately narrower than core's internal index. Durable authority,
+ * persistence, lifecycle, binding, ledger, artifact storage, and execution
+ * engine modules are not part of the npm API contract.
+ */
+export * from "./application.js";
+export * from "./assembly.js";
+export * from "./capability.js";
+export * from "./context.js";
+export * from "./implementation.js";
+export * from "./manifest.js";
+export * from "./contract-artifact.js";
+export * from "./appboundry-contract.js";
+export * from "./runtime-manifest.js";
+export * from "./streams.js";
+export type { CapabilityInvocationContext, CapabilityInvocationRequest, CapabilityInvocationResult, CancelledInvocationResult, FailedInvocationResult, SuccessfulInvocationResult, TimedOutInvocationResult } from "./invocation.js";
+//# sourceMappingURL=public.d.ts.map

package/node_modules/@appport/core/dist/public.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../src/public.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,YAAY,EACV,2BAA2B,EAC3B,2BAA2B,EAC3B,0BAA0B,EAC1B,yBAAyB,EACzB,sBAAsB,EACtB,0BAA0B,EAC1B,wBAAwB,EACzB,MAAM,iBAAiB,CAAC"}

package/node_modules/@appport/core/dist/public.js

@@ -0,0 +1,18 @@
+/**
+ * Application-developer API consumed by `@appport/sdk`.
+ *
+ * This is deliberately narrower than core's internal index. Durable authority,
+ * persistence, lifecycle, binding, ledger, artifact storage, and execution
+ * engine modules are not part of the npm API contract.
+ */
+export * from "./application.js";
+export * from "./assembly.js";
+export * from "./capability.js";
+export * from "./context.js";
+export * from "./implementation.js";
+export * from "./manifest.js";
+export * from "./contract-artifact.js";
+export * from "./appboundry-contract.js";
+export * from "./runtime-manifest.js";
+export * from "./streams.js";
+//# sourceMappingURL=public.js.map

package/node_modules/@appport/core/dist/public.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public.js","sourceRoot":"","sources":["../src/public.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC"}

package/node_modules/@appport/core/dist/registration.d.ts

@@ -0,0 +1,165 @@
+/**
+ * Application Registry: FeltDB-backed application state management
+ *
+ * Handles registration, lookup, listing, and state persistence of
+ * tracked applications. Integrates with FeltDB via the adapter pattern.
+ *
+ * The registry is the authoritative source for:
+ * - Application identity and manifests
+ * - Fingerprints and verification state
+ * - Application lifecycle and revisions
+ * - Application discovery
+ */
+import type { ApplicationState, RegisterApplicationOptions } from "./state.js";
+/**
+ * Storage interface for application state.
+ *
+ * This is similar to {@link FeltDbLike} but purpose-specific for applications.
+ * Implementations can use FeltDB, memory storage, or any persistent backend.
+ */
+export interface ApplicationStateStore {
+    /**
+     * Retrieve an application state by ID.
+     *
+     * Returns undefined if the application is not found.
+     */
+    get(id: string): Promise<ApplicationState | undefined>;
+    /**
+     * Store an application state.
+     *
+     * If an application with this ID already exists, its state is updated.
+     */
+    put(state: ApplicationState): Promise<void>;
+    /**
+     * Remove an application from storage.
+     */
+    delete(id: string): Promise<void>;
+    /**
+     * List all registered applications.
+     *
+     * Options:
+     * - prefix: Filter applications by ID prefix
+     * - limit: Maximum number of results
+     */
+    list(options?: {
+        prefix?: string;
+        limit?: number;
+    }): Promise<ApplicationState[]>;
+}
+/**
+ * In-memory application state store.
+ *
+ * Useful for testing and development without a persistent backend.
+ */
+export declare class MemoryApplicationStateStore implements ApplicationStateStore {
+    #private;
+    get(id: string): Promise<ApplicationState | undefined>;
+    put(state: ApplicationState): Promise<void>;
+    delete(id: string): Promise<void>;
+    list(options?: {
+        prefix?: string;
+        limit?: number;
+    }): Promise<ApplicationState[]>;
+}
+/**
+ * Application registry: manages registration, lookup, and tracking of
+ * applications via a persistent store.
+ *
+ * The registry enforces:
+ * - Only verified applications can be registered
+ * - Fingerprint verification for idempotency
+ * - No implementation persistence
+ * - Manifest as canonical contract
+ */
+export declare class ApplicationRegistry {
+    #private;
+    constructor(store: ApplicationStateStore);
+    /**
+     * Register a verified application.
+     *
+     * @param options - Identity, manifest, fingerprint, and verification state
+     * @returns The registered application state
+     *
+     * Throws if application is not verified or if registration is invalid.
+     */
+    register(options: RegisterApplicationOptions): Promise<ApplicationState>;
+    /**
+     * Register an application, validating manifest and fingerprint match.
+     *
+     * This is the same as {@link register} but additionally validates that
+     * the provided fingerprint matches the manifest hash.
+     *
+     * @throws If fingerprint does not match manifest
+     */
+    registerWithValidation(options: RegisterApplicationOptions): Promise<ApplicationState>;
+    /**
+     * Retrieve a registered application by ID.
+     *
+     * @returns The application state, or undefined if not registered
+     */
+    get(id: string): Promise<ApplicationState | undefined>;
+    /**
+     * Check if an application is registered.
+     */
+    has(id: string): Promise<boolean>;
+    /**
+     * List all registered applications.
+     *
+     * @param options - Query options (prefix, limit)
+     * @returns Array of registered application states
+     */
+    list(options?: {
+        prefix?: string;
+        limit?: number;
+    }): Promise<ApplicationState[]>;
+    /**
+     * Find applications by name.
+     *
+     * Returns all versions of an application with the given name (deterministically sorted by ID).
+     */
+    findByName(name: string): Promise<ApplicationState[]>;
+    /**
+     * Find the latest version of an application by name.
+     *
+     * Returns undefined if no application with this name is registered.
+     */
+    getLatestByName(name: string): Promise<ApplicationState | undefined>;
+    /**
+     * Delete a registered application.
+     *
+     * This marks an application as no longer tracked. The state is
+     * permanently removed from storage.
+     */
+    delete(id: string): Promise<void>;
+    /** Persist an authoritative activation transition. */
+    activate(id: string): Promise<ApplicationState>;
+    /** Retire without deleting identity, contract, state, or history. */
+    retire(id: string): Promise<ApplicationState>;
+    /**
+     * Find an application by its manifest fingerprint.
+     *
+     * @param fingerprint - SHA256 fingerprint of the manifest
+     * @returns Array of applications with matching fingerprint (deterministically sorted by ID)
+     *
+     * Note: Applications should have unique fingerprints in practice, but this method
+     * returns an array for consistency with other discovery methods.
+     */
+    findByFingerprint(fingerprint: string): Promise<ApplicationState[]>;
+    /**
+     * Find applications that provide a given capability.
+     *
+     * @param name - Capability name (e.g., "invoices.read")
+     * @param version - Optional specific capability version. If omitted, matches any version of the capability.
+     * @returns Array of applications providing this capability (deterministically sorted by ID)
+     */
+    findByCapability(name: string, version?: number): Promise<ApplicationState[]>;
+    /**
+     * Find applications that require a given capability.
+     *
+     * @param name - Capability name (e.g., "invoices.read")
+     * @param version - Optional specific capability version. If omitted, matches any version of the requirement.
+     * @returns Array of applications requiring this capability (deterministically sorted by ID)
+     */
+    findByRequirement(name: string, version?: number): Promise<ApplicationState[]>;
+}
+//# sourceMappingURL=registration.d.ts.map

package/node_modules/@appport/core/dist/registration.d.ts.map

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