@opendatalabs/personal-server-ts-lite 0.0.1-canary.00328bf

package/dist/client.js

@@ -0,0 +1,408 @@
+import { accessLogsListPath, createOwnerSignedPersonalServerRequest, createPersonalServerInfoFromHealth, createPersonalServerRegistrationRequest, dataListPath, dataReadPath, dataVersionsPath, grantRevokePath, parsePersonalServerJsonResponse, requestPath, submitPersonalServerRegistration, } from "@opendatalabs/personal-server-ts-core/client";
+import { createGatewayClient, } from "@opendatalabs/vana-sdk/browser";
+import { createIndexedDbPsLiteRuntime, } from "./browser-runtime.js";
+import { createRelayDrainGatedReadFulfillmentReporter, psLiteRelayPublicUrl, startPsLiteRelayClient, } from "./relay.js";
+import { createIndexedDbPsLiteStateStore, loadPsLiteRelayState, savePsLiteRelayState, } from "./state.js";
+const DEFAULT_LITE_ORIGIN = "https://ps-lite.local";
+export async function startPersonalServer(options) {
+    if (options.persistence && options.runtime) {
+        throw new Error("runtime cannot be supplied with a complete persistence bundle");
+    }
+    if (options.persistence && options.relayStateStore) {
+        throw new Error("relayStateStore cannot be supplied with a complete persistence bundle");
+    }
+    const localOrigin = options.localOrigin ?? DEFAULT_LITE_ORIGIN;
+    const relayOptions = options.relay || undefined;
+    const relayStateStore = relayOptions
+        ? (options.relayStateStore ??
+            options.persistence?.state ??
+            (options.runtime
+                ? undefined
+                : createIndexedDbPsLiteStateStore({
+                    dbName: options.dbName ?? "personal-server-lite",
+                    storeName: options.stateStoreName ?? "state",
+                })))
+        : undefined;
+    const savedRelayState = relayStateStore
+        ? await loadPsLiteRelayState(relayStateStore).catch(() => null)
+        : null;
+    const resolvedRelayOptions = relayOptions
+        ? {
+            ...relayOptions,
+            sessionId: relayOptions.sessionId ??
+                savedRelaySessionId(savedRelayState, relayOptions) ??
+                randomSessionId(),
+        }
+        : undefined;
+    const initialPublicUrl = resolvedRelayOptions
+        ? psLiteRelayPublicUrl(resolvedRelayOptions.sessionId, resolvedRelayOptions.publicSuffix)
+        : null;
+    const runtimeOrigin = initialPublicUrl ?? localOrigin;
+    // Late-bound relay handle for the drain-gated fulfillment reporter: the
+    // runtime needs the (wrapped) reporter at construction time, but the relay
+    // client only starts further down. Until it exists, reports pass through.
+    let relayClientForDrain;
+    const readFulfillmentReporter = options.readFulfillmentReporter && resolvedRelayOptions
+        ? createRelayDrainGatedReadFulfillmentReporter(options.readFulfillmentReporter, () => relayClientForDrain)
+        : options.readFulfillmentReporter;
+    const runtimeBundle = options.runtime
+        ? null
+        : await createIndexedDbPsLiteRuntime({
+            ...options,
+            readFulfillmentReporter,
+            ownerSignature: requiredOwnerSignature(options.ownerSignature),
+            active: options.active ?? true,
+            runtimeOrigin,
+            configDefaults: configDefaultsWithOrigin(options.configDefaults, runtimeOrigin),
+        });
+    const runtime = options.runtime ?? runtimeBundle.runtime;
+    if (options.active ?? true) {
+        runtime.activate();
+    }
+    let status = "ready";
+    let relayStatus = "closed";
+    let relayClient;
+    let publicUrl = null;
+    let lastInfo = null;
+    let lastPreparedRegistration = null;
+    const gateway = options.gateway;
+    const setStatus = (nextStatus) => {
+        status = nextStatus;
+        options.onStatus?.(nextStatus);
+    };
+    if (resolvedRelayOptions) {
+        relayStatus = "connecting";
+        publicUrl = initialPublicUrl;
+        relayClient = startPsLiteRelayClient({
+            ...resolvedRelayOptions,
+            runtime,
+            origin: runtimeOrigin,
+            tlsIdentityStore: options.persistence?.relayTlsIdentity ??
+                resolvedRelayOptions.tlsIdentityStore,
+            onStatus(nextRelayStatus, detail) {
+                relayStatus = nextRelayStatus;
+                if (nextRelayStatus === "error")
+                    setStatus("error");
+                resolvedRelayOptions.onStatus?.(nextRelayStatus, detail);
+            },
+        });
+        relayClientForDrain = relayClient;
+    }
+    async function info() {
+        if (status === "stopped" && lastInfo) {
+            return { ...lastInfo, status: "stopped" };
+        }
+        const response = await runtime.fetch(new Request(`${localOrigin}/health`));
+        const body = await response.json();
+        lastInfo = createPersonalServerInfoFromHealth({
+            kind: "lite",
+            status,
+            health: {
+                ...body,
+                relay: { status: relayStatus, publicUrl },
+            },
+            localUrl: localOrigin,
+            publicUrl,
+        });
+        return lastInfo;
+    }
+    async function prepareRegistration(prepareOptions = {}) {
+        const current = await info();
+        const serverUrl = prepareOptions.serverUrl ?? current.urls.registration;
+        if (!current.ownerAddress || !current.server || !serverUrl) {
+            throw new Error("Personal Server identity and URL are required");
+        }
+        if (!current.gatewayConfig) {
+            throw new Error("Personal Server gateway config is required");
+        }
+        const request = createPersonalServerRegistrationRequest({
+            gatewayConfig: current.gatewayConfig,
+            ownerAddress: current.ownerAddress,
+            serverAddress: current.server.address,
+            publicKey: current.server.publicKey,
+            serverUrl,
+        });
+        lastPreparedRegistration = request;
+        return request;
+    }
+    async function submitRegistration(submitOptions) {
+        const request = submitOptions.request ??
+            (submitOptions.serverUrl
+                ? await prepareRegistration({ serverUrl: submitOptions.serverUrl })
+                : (lastPreparedRegistration ?? (await prepareRegistration())));
+        const gatewayClient = gateway ?? createGatewayClient(requiredGatewayUrl(await info()));
+        return submitPersonalServerRegistration({
+            gateway: gatewayClient,
+            request,
+            signature: submitOptions.signature,
+        }).then(async (result) => {
+            await rememberRegisteredRelay(request.candidate.serverUrl);
+            return result;
+        });
+    }
+    async function callFetch(input, init) {
+        const origin = (await info()).urls.apiOrigin ?? localOrigin;
+        return runtime.fetch(await toRuntimeRequest(input, origin, init));
+    }
+    async function postData(scope, body, postOptions) {
+        const current = await info();
+        const origin = requiredApiOrigin(current);
+        const path = `/v1/data/${encodeURIComponent(scope)}`;
+        const request = await createOwnerRequest({
+            origin,
+            path,
+            method: "POST",
+            body,
+            authOptions: postOptions,
+            headers: {
+                "Content-Type": "application/json",
+                ...postOptions.headers,
+            },
+        });
+        return parsePersonalServerJsonResponse(await callFetch(request), "data write");
+    }
+    async function listData(listOptions = {}) {
+        const current = await info();
+        const request = await createOwnerRequest({
+            origin: requiredApiOrigin(current),
+            path: dataListPath(listOptions),
+            method: "GET",
+            authOptions: listOptions,
+            headers: listOptions.headers,
+        });
+        return parsePersonalServerJsonResponse(await callFetch(request), "data list");
+    }
+    async function listAccessLogs(accessLogOptions = {}) {
+        const current = await info();
+        const request = await createOwnerRequest({
+            origin: requiredApiOrigin(current),
+            path: accessLogsListPath(accessLogOptions),
+            method: "GET",
+            authOptions: accessLogOptions,
+            headers: accessLogOptions.headers,
+        });
+        return parsePersonalServerJsonResponse(await callFetch(request), "access logs list");
+    }
+    async function listVersions(scope, versionOptions = {}) {
+        const current = await info();
+        const request = await createOwnerRequest({
+            origin: requiredApiOrigin(current),
+            path: dataVersionsPath(scope, versionOptions),
+            method: "GET",
+            authOptions: versionOptions,
+            headers: versionOptions.headers,
+        });
+        return parsePersonalServerJsonResponse(await callFetch(request), "data versions list");
+    }
+    async function readData(scope, readOptions = {}) {
+        const current = await info();
+        const request = await createOwnerRequest({
+            origin: requiredApiOrigin(current),
+            path: dataReadPath(scope, readOptions),
+            method: "GET",
+            authOptions: readOptions,
+            headers: readOptions.headers,
+        });
+        return parsePersonalServerJsonResponse(await callFetch(request), "data read");
+    }
+    async function syncStatus(syncOptions = {}) {
+        const current = await info();
+        const request = await createOwnerRequest({
+            origin: requiredApiOrigin(current),
+            path: "/v1/sync/status",
+            method: "GET",
+            authOptions: syncOptions,
+            headers: syncOptions.headers,
+        });
+        return parsePersonalServerJsonResponse(await callFetch(request), "sync status");
+    }
+    async function createGrant(grantOptions) {
+        const current = await info();
+        const request = await createOwnerRequest({
+            origin: requiredApiOrigin(current),
+            path: "/v1/grants",
+            method: "POST",
+            body: {
+                granteeAddress: grantOptions.granteeAddress,
+                scopes: grantOptions.scopes,
+                ...(grantOptions.expiresAt === undefined
+                    ? {}
+                    : { expiresAt: grantOptions.expiresAt }),
+                ...(grantOptions.grantVersion === undefined
+                    ? {}
+                    : { grantVersion: grantOptions.grantVersion }),
+            },
+            authOptions: grantOptions,
+            headers: {
+                "Content-Type": "application/json",
+                ...grantOptions.headers,
+            },
+        });
+        return parsePersonalServerJsonResponse(await callFetch(request), "grant create");
+    }
+    async function listGrants(grantOptions = {}) {
+        const current = await info();
+        const request = await createOwnerRequest({
+            origin: requiredApiOrigin(current),
+            path: "/v1/grants",
+            method: "GET",
+            authOptions: grantOptions,
+            headers: grantOptions.headers,
+        });
+        return parsePersonalServerJsonResponse(await callFetch(request), "grant list");
+    }
+    async function revokeGrant(grantId, grantOptions = {}) {
+        const current = await info();
+        const request = await createOwnerRequest({
+            origin: requiredApiOrigin(current),
+            path: grantRevokePath(grantId),
+            method: "DELETE",
+            authOptions: grantOptions,
+            headers: grantOptions.headers,
+        });
+        return parsePersonalServerJsonResponse(await callFetch(request), "grant revoke");
+    }
+    async function syncNow(syncOptions = {}) {
+        const current = await info();
+        const request = await createOwnerRequest({
+            origin: requiredApiOrigin(current),
+            path: "/v1/sync/trigger",
+            method: "POST",
+            authOptions: syncOptions,
+            headers: syncOptions.headers,
+        });
+        return parsePersonalServerJsonResponse(await callFetch(request), "sync trigger");
+    }
+    async function rememberRegisteredRelay(serverUrl) {
+        if (!resolvedRelayOptions || !relayStateStore)
+            return;
+        await savePsLiteRelayState(relayStateStore, {
+            sessionId: resolvedRelayOptions.sessionId,
+            controlUrl: resolvedRelayOptions.controlUrl,
+            publicSuffix: resolvedRelayOptions.publicSuffix,
+            publicUrl: serverUrl,
+        });
+    }
+    async function createOwnerRequest(params) {
+        const encoded = params.body === undefined
+            ? undefined
+            : new TextEncoder().encode(JSON.stringify(params.body));
+        const auth = authFromOptions(params.authOptions);
+        if (auth) {
+            return createOwnerSignedPersonalServerRequest({
+                origin: params.origin,
+                path: params.path,
+                method: params.method,
+                body: encoded,
+                auth,
+                headers: params.headers,
+            });
+        }
+        return new Request(`${params.origin}${params.path}`, {
+            method: params.method,
+            body: encoded,
+            headers: params.headers,
+        });
+    }
+    async function stop() {
+        if (status === "stopped")
+            return;
+        relayClient?.close("personal-server-stop");
+        relayClient = undefined;
+        runtime.deactivate();
+        await runtimeBundle?.syncManager?.stop?.();
+        setStatus("stopped");
+    }
+    return {
+        kind: "lite",
+        ready: (_options) => info(),
+        info,
+        prepareRegistration,
+        submitRegistration,
+        fetch: callFetch,
+        postData,
+        listData,
+        listAccessLogs,
+        listVersions,
+        readData,
+        createGrant,
+        listGrants,
+        revokeGrant,
+        syncStatus,
+        syncNow,
+        stop,
+    };
+}
+function savedRelaySessionId(state, options) {
+    if (!state?.sessionId)
+        return null;
+    if (options.controlUrl && state.controlUrl !== options.controlUrl)
+        return null;
+    if (options.publicSuffix && state.publicSuffix !== options.publicSuffix) {
+        return null;
+    }
+    return state.sessionId;
+}
+function randomSessionId() {
+    const bytes = crypto.getRandomValues(new Uint8Array(12));
+    return Array.from(bytes, (byte) => byte.toString(16).padStart(2, "0")).join("");
+}
+function authFromOptions(options) {
+    if ("auth" in options && options.auth)
+        return options.auth;
+    if ("signMessage" in options)
+        return { signMessage: options.signMessage };
+    if ("bearerToken" in options)
+        return { bearerToken: options.bearerToken };
+    return undefined;
+}
+function requiredOwnerSignature(ownerSignature) {
+    if (!ownerSignature) {
+        throw new Error("ownerSignature is required to start PS Lite");
+    }
+    return ownerSignature;
+}
+function configDefaultsWithOrigin(defaults, origin) {
+    return {
+        ...defaults,
+        server: {
+            ...defaults?.server,
+            origin,
+        },
+    };
+}
+function requiredGatewayUrl(info) {
+    if (!info.gatewayUrl) {
+        throw new Error("Personal Server gateway URL is required");
+    }
+    return info.gatewayUrl;
+}
+function requiredApiOrigin(info) {
+    if (!info.urls.apiOrigin) {
+        throw new Error("Personal Server API origin is required");
+    }
+    return info.urls.apiOrigin;
+}
+async function toRuntimeRequest(input, origin, init) {
+    const url = `${origin}${requestPath(input)}`;
+    if (input instanceof Request) {
+        // Rebuild onto the runtime origin with an explicitly buffered body.
+        // `new Request(url, request)` treats the request as an init bag and reads
+        // its body via the `Request.prototype.body` getter, which Firefox does
+        // not implement (no fetch upload streaming) - the body silently drops and
+        // every POST reaches the runtime empty ("Request body must be valid
+        // JSON"). Buffering via arrayBuffer() works in every engine.
+        const buffered = input.method === "GET" || input.method === "HEAD"
+            ? undefined
+            : await input.clone().arrayBuffer();
+        const base = new Request(url, {
+            method: input.method,
+            headers: input.headers,
+            body: buffered && buffered.byteLength > 0 ? buffered : undefined,
+            signal: input.signal,
+        });
+        return init ? new Request(base, init) : base;
+    }
+    return new Request(url, init);
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/derivatives.d.ts

@@ -0,0 +1,51 @@
+/**
+ * PS-Lite wiring for the derivative compute layer: a question store that
+ * persists through the runtime's state store, and the compute + scheduler
+ * built on the browser-safe core pieces (fetch-based inference provider).
+ */
+import type { ServerConfig } from "@opendatalabs/personal-server-ts-core/schemas";
+import type { DataStoragePort, RuntimeAvailabilityPort } from "@opendatalabs/personal-server-ts-core/ports";
+import type { ScopeDeletionTracker } from "@opendatalabs/personal-server-ts-core/sync";
+import type { DataWritePolicyPorts } from "@opendatalabs/personal-server-ts-core/policy";
+import { type ComputeSyncNotifier, type InferenceProvider, type QuestionStore, type RecomputeScheduler } from "@opendatalabs/personal-server-ts-core/derivatives";
+import type { Logger } from "@opendatalabs/personal-server-ts-core/logger";
+import type { RequestSigner } from "@opendatalabs/personal-server-ts-core/signing";
+import type { PsLiteStateStore } from "./state.js";
+/** A question store persisted as one JSON value in the PS-Lite state store. */
+export declare function createPsLiteQuestionStore(stateStore: PsLiteStateStore): Promise<QuestionStore>;
+/**
+ * The browser build must not call a provider directly with no key: the
+ * default base URL is a direct provider, so the compute layer only comes up
+ * when `inference.baseUrl` names a relay (or a provider is injected).
+ */
+export declare function psLiteInferenceConfigured(config: ServerConfig): boolean;
+export interface PsLiteDerivativeComputeOptions {
+    config: ServerConfig;
+    storage: DataStoragePort;
+    store: QuestionStore;
+    serverOwner: `0x${string}` | undefined;
+    /** Resolved per compute so a sync manager created later is still seen. */
+    syncManager?: () => ComputeSyncNotifier | null | undefined;
+    /** Same: the tracker is built together with the sync manager. */
+    scopeDeletions?: () => ScopeDeletionTracker | undefined;
+    writePolicyPorts?: DataWritePolicyPorts;
+    /** Computes are skipped (status untouched) while the runtime is inactive. */
+    runtimeAvailability?: RuntimeAvailabilityPort;
+    /** Defaults to the OpenAI-compatible client on `config.inference`. */
+    provider?: InferenceProvider;
+    /**
+     * Signs the relay calls (chat completion and attested-key fetch) as this
+     * personal server: the same signer the gateway registration and the
+     * lineage reads use in the browser. Without it the relay answers 401.
+     */
+    requestSigner?: RequestSigner;
+    logger?: Logger;
+    now?: () => Date;
+}
+export interface PsLiteDerivativeCompute {
+    store: QuestionStore;
+    scheduler: RecomputeScheduler;
+    provider: InferenceProvider;
+}
+export declare function createPsLiteDerivativeCompute(options: PsLiteDerivativeComputeOptions): PsLiteDerivativeCompute;
+//# sourceMappingURL=derivatives.d.ts.map

package/dist/derivatives.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"derivatives.d.ts","sourceRoot":"","sources":["../src/derivatives.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+CAA+C,CAAC;AAClF,OAAO,KAAK,EACV,eAAe,EACf,uBAAuB,EACxB,MAAM,6CAA6C,CAAC;AACrD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4CAA4C,CAAC;AACvF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8CAA8C,CAAC;AACzF,OAAO,EAOL,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EAEtB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACxB,MAAM,mDAAmD,CAAC;AAC3D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,8CAA8C,CAAC;AAC3E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+CAA+C,CAAC;AACnF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAmBnD,+EAA+E;AAC/E,wBAAsB,yBAAyB,CAC7C,UAAU,EAAE,gBAAgB,GAC3B,OAAO,CAAC,aAAa,CAAC,CAoBxB;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAKvE;AAED,MAAM,WAAW,8BAA8B;IAC7C,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,EAAE,eAAe,CAAC;IACzB,KAAK,EAAE,aAAa,CAAC;IACrB,WAAW,EAAE,KAAK,MAAM,EAAE,GAAG,SAAS,CAAC;IACvC,0EAA0E;IAC1E,WAAW,CAAC,EAAE,MAAM,mBAAmB,GAAG,IAAI,GAAG,SAAS,CAAC;IAC3D,iEAAiE;IACjE,cAAc,CAAC,EAAE,MAAM,oBAAoB,GAAG,SAAS,CAAC;IACxD,gBAAgB,CAAC,EAAE,oBAAoB,CAAC;IACxC,6EAA6E;IAC7E,mBAAmB,CAAC,EAAE,uBAAuB,CAAC;IAC9C,sEAAsE;IACtE,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B;;;;OAIG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,aAAa,CAAC;IACrB,SAAS,EAAE,kBAAkB,CAAC;IAC9B,QAAQ,EAAE,iBAAiB,CAAC;CAC7B;AAED,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,8BAA8B,GACtC,uBAAuB,CAuDzB"}

package/dist/derivatives.js

@@ -0,0 +1,87 @@
+/**
+ * PS-Lite wiring for the derivative compute layer: a question store that
+ * persists through the runtime's state store, and the compute + scheduler
+ * built on the browser-safe core pieces (fetch-based inference provider).
+ */
+import { computeQuestion, createInMemoryQuestionStore, createOpenAiCompatibleInferenceProvider, createPhalaE2eeEncryption, createRecomputeScheduler, DEFAULT_INFERENCE_BASE_URL, } from "@opendatalabs/personal-server-ts-core/derivatives";
+const QUESTIONS_KEY = "derivative-questions-v1";
+/** A question store persisted as one JSON value in the PS-Lite state store. */
+export async function createPsLiteQuestionStore(stateStore) {
+    const saved = await stateStore.get(QUESTIONS_KEY);
+    // Registrations saved before the recompute policy existed keep the old
+    // follow-every-change behavior, and ones saved before answer shapes keep
+    // the free-text answer.
+    const initial = (saved?.version === 1 ? saved.questions : []).map((question) => ({
+        ...question,
+        recompute: question.recompute ?? "on-change",
+        answerShape: question.answerShape ?? null,
+    }));
+    return createInMemoryQuestionStore({
+        initial,
+        onChange: (questions) => stateStore.set(QUESTIONS_KEY, {
+            version: 1,
+            questions,
+        }),
+    });
+}
+/**
+ * The browser build must not call a provider directly with no key: the
+ * default base URL is a direct provider, so the compute layer only comes up
+ * when `inference.baseUrl` names a relay (or a provider is injected).
+ */
+export function psLiteInferenceConfigured(config) {
+    return (config.inference.baseUrl.replace(/\/+$/, "") !==
+        DEFAULT_INFERENCE_BASE_URL.replace(/\/+$/, ""));
+}
+export function createPsLiteDerivativeCompute(options) {
+    const logger = options.logger
+        ? {
+            info: (payload, message) => options.logger?.info(payload, message),
+            warn: (payload, message) => options.logger?.warn(payload, message),
+        }
+        : undefined;
+    const provider = options.provider ??
+        createOpenAiCompatibleInferenceProvider({
+            baseUrl: options.config.inference.baseUrl,
+            model: options.config.inference.model,
+            // PS-Lite holds no provider key: it always talks to the Vana relay,
+            // which forwards only requests signed as the owner's server.
+            requestSigner: options.requestSigner,
+            // E2EE v2 to the Phala gateway (WebCrypto only, so it runs in the
+            // browser): the relay sees ciphertext. `inference.e2ee: false` turns
+            // it off for local development against a provider without ACI.
+            encryption: options.config.inference.e2ee
+                ? createPhalaE2eeEncryption({
+                    baseUrl: options.config.inference.baseUrl,
+                    requestSigner: options.requestSigner,
+                    logger,
+                })
+                : undefined,
+        });
+    const scheduler = createRecomputeScheduler({
+        store: options.store,
+        debounceMs: options.config.inference.recomputeDebounceMs,
+        serverOwner: options.serverOwner,
+        now: options.now,
+        logger,
+        compute: (questionId) => computeQuestion(questionId, {
+            // A -> B -> C: a question reading this derived scope goes stale.
+            onDerivedWritten: (event) => scheduler.markSourceChanged(event.scope, {
+                lineageSources: event.lineageSources,
+            }),
+            runtimeAvailability: options.runtimeAvailability,
+            storage: options.storage,
+            store: options.store,
+            provider,
+            serverOwner: options.serverOwner,
+            maxSourceItems: options.config.inference.maxSourceItems,
+            syncManager: options.syncManager?.() ?? null,
+            scopeDeletions: options.scopeDeletions?.(),
+            writePolicyPorts: options.writePolicyPorts,
+            now: options.now,
+            logger,
+        }),
+    });
+    return { store: options.store, scheduler, provider };
+}
+//# sourceMappingURL=derivatives.js.map

package/dist/derivatives.js.map

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