Timothy J. Aveni
ce6ae8f662
Enable evolution by default for source-backed workspaces. Add stable conformance ownership, semantic-major review, candidate typechecking, and durable fenced cutover with explicit migrations and forward recovery. Independently supervise package runtimes so unchanged resource owners keep their processes and connections across cutover. Add scoped invocation authority, resource sessions, and typed callback rebinding. Wire opaque object references through generated bindings and RPCs. Add canonical relationship sets, keyed maps, and ordered lists with scoped transactional mutations, revision checks, and inverse consistency. Support planned cascade deletion, protection, tombstones, and lifecycle foundations. Add journaled structural edits, package/function/migration scaffolding, managed repository creation, and resumable bottom-up dependency pin publication. Document lifetime boundaries, revision pinning, prototype compatibility policy, commands, and deferred work. Validate with 210 tests, user-systemd process/connection continuity, generated-package TypeScript checks, and Nix host/protocol checks. TTL handoff, physical reclamation, general multi-step migrations, and root-systemd migration isolation acceptance remain deferred.
79 lines
2.4 KiB
TypeScript
79 lines
2.4 KiB
TypeScript
import { type Value } from "./camino/api_pb.js";
|
|
import { type RuntimeHandler, type DerivedHandler } from "./index.js";
|
|
export type { QxObjectRef } from "./references.js";
|
|
declare const watchBrand: unique symbol;
|
|
export type QxWatchHandle = string & {
|
|
readonly [watchBrand]: true;
|
|
};
|
|
export type MessageBinding<T> = {
|
|
encode(value: T): Value;
|
|
decode(value: Value): T;
|
|
};
|
|
export type BindingValue<B> = B extends MessageBinding<infer T> ? T : never;
|
|
export type QxHandler<C, O> = (context: C) => O | Promise<O>;
|
|
export type QxDerived<C, O> = {
|
|
kind: "derived";
|
|
get: QxHandler<C, O>;
|
|
};
|
|
export type QxSession<C> = {
|
|
id: string;
|
|
run<T>(work: (context: C) => Promise<T>): Promise<T>;
|
|
close(): Promise<void>;
|
|
};
|
|
export type QxContextLifecycle<C> = {
|
|
signal?: AbortSignal;
|
|
openSession?: () => Promise<QxSession<C>>;
|
|
};
|
|
export declare const qxDerived: <C, O>(get: QxHandler<C, O>) => QxDerived<C, O>;
|
|
/** Versioned binding ABI. This mirrors the language-neutral value IR. */
|
|
export type QxValueType = {
|
|
kind: "builtin";
|
|
name: "unit" | "watch-handle";
|
|
} | {
|
|
kind: "scalar";
|
|
name: string;
|
|
} | {
|
|
kind: "message";
|
|
descriptorId: string;
|
|
} | {
|
|
kind: "object-ref";
|
|
expectation: unknown;
|
|
} | {
|
|
kind: "optional" | "list";
|
|
value: QxValueType;
|
|
};
|
|
export type QxOperationSpec = {
|
|
id: string;
|
|
inputType: QxValueType;
|
|
outputType: QxValueType;
|
|
};
|
|
export type QxPortSpec = {
|
|
kind: "state";
|
|
id: string;
|
|
valueType: QxValueType;
|
|
primitives: string[];
|
|
} | {
|
|
kind: "edge";
|
|
id: string;
|
|
primitives: string[];
|
|
} | {
|
|
kind: "interface";
|
|
id: string;
|
|
operations: Record<string, QxOperationSpec>;
|
|
} | {
|
|
kind: "constructor";
|
|
id: string;
|
|
inputType: QxValueType;
|
|
};
|
|
export type QxHandlerSpec = {
|
|
inputType: QxValueType;
|
|
outputType: QxValueType;
|
|
eventType?: QxValueType;
|
|
ports: Record<string, QxPortSpec>;
|
|
};
|
|
export type QxMessages = Record<string, MessageBinding<any>>;
|
|
export declare const decodeQxValue: (type: QxValueType, value: Value | undefined, messages: QxMessages) => any;
|
|
export declare const encodeQxValue: (type: QxValueType, value: any, messages: QxMessages) => Value;
|
|
/** The sole unchecked cast connects generated contracts to the dynamic RPC runtime. */
|
|
export declare const bindQxHandler: <C, O>(spec: QxHandlerSpec, handler: QxHandler<C, O> | QxDerived<C, O>, messages: QxMessages) => RuntimeHandler | DerivedHandler;
|
|
//# sourceMappingURL=bindings.d.ts.map
|