@peers-app/peers-sdk 0.26.5 → 0.27.0

package/dist/data/tools.d.ts

@@ -18,45 +18,15 @@ export declare const ioSchema: z.ZodObject<{
         optional: z.ZodOptional<z.ZodBoolean>;
         isArray: z.ZodOptional<z.ZodBoolean>;
         subType: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        name: string;
-        type: import("../types/field-type").FieldType;
-        optional?: boolean | undefined;
-        description?: string | undefined;
-        defaultValue?: any;
-        isArray?: boolean | undefined;
-        subType?: string | undefined;
-    }, {
-        name: string;
-        type: import("../types/field-type").FieldType;
-        optional?: boolean | undefined;
-        description?: string | undefined;
-        defaultValue?: any;
-        isArray?: boolean | undefined;
-        subType?: string | undefined;
-    }>, "many">>;
+        fields: z.ZodOptional<z.ZodLazy<z.ZodArray<z.ZodType<import("../types/field-type").IField>>>>;
+        enumValues: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+    }, "strip", z.ZodTypeAny, import("../types/field-type").IField, import("../types/field-type").IField>, "many">>;
 }, "strip", z.ZodTypeAny, {
     type: IOSchemaType;
-    fields: {
-        name: string;
-        type: import("../types/field-type").FieldType;
-        optional?: boolean | undefined;
-        description?: string | undefined;
-        defaultValue?: any;
-        isArray?: boolean | undefined;
-        subType?: string | undefined;
-    }[];
+    fields: import("../types/field-type").IField[];
 }, {
     type: IOSchemaType;
-    fields?: {
-        name: string;
-        type: import("../types/field-type").FieldType;
-        optional?: boolean | undefined;
-        description?: string | undefined;
-        defaultValue?: any;
-        isArray?: boolean | undefined;
-        subType?: string | undefined;
-    }[] | undefined;
+    fields?: import("../types/field-type").IField[] | undefined;
 }>;
 /** Field list plus complexity for a tool IO surface. */
 export type IOSchema = z.infer<typeof ioSchema>;
@@ -82,45 +52,15 @@ export declare const toolSchema: z.ZodObject<{
             optional: z.ZodOptional<z.ZodBoolean>;
             isArray: z.ZodOptional<z.ZodBoolean>;
             subType: z.ZodOptional<z.ZodString>;
-        }, "strip", z.ZodTypeAny, {
-            name: string;
-            type: import("../types/field-type").FieldType;
-            optional?: boolean | undefined;
-            description?: string | undefined;
-            defaultValue?: any;
-            isArray?: boolean | undefined;
-            subType?: string | undefined;
-        }, {
-            name: string;
-            type: import("../types/field-type").FieldType;
-            optional?: boolean | undefined;
-            description?: string | undefined;
-            defaultValue?: any;
-            isArray?: boolean | undefined;
-            subType?: string | undefined;
-        }>, "many">>;
+            fields: z.ZodOptional<z.ZodLazy<z.ZodArray<z.ZodType<import("../types/field-type").IField>>>>;
+            enumValues: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+        }, "strip", z.ZodTypeAny, import("../types/field-type").IField, import("../types/field-type").IField>, "many">>;
     }, "strip", z.ZodTypeAny, {
         type: IOSchemaType;
-        fields: {
-            name: string;
-            type: import("../types/field-type").FieldType;
-            optional?: boolean | undefined;
-            description?: string | undefined;
-            defaultValue?: any;
-            isArray?: boolean | undefined;
-            subType?: string | undefined;
-        }[];
+        fields: import("../types/field-type").IField[];
     }, {
         type: IOSchemaType;
-        fields?: {
-            name: string;
-            type: import("../types/field-type").FieldType;
-            optional?: boolean | undefined;
-            description?: string | undefined;
-            defaultValue?: any;
-            isArray?: boolean | undefined;
-            subType?: string | undefined;
-        }[] | undefined;
+        fields?: import("../types/field-type").IField[] | undefined;
     }>;
     outputSchema: z.ZodObject<{
         type: z.ZodNativeEnum<typeof IOSchemaType>;
@@ -132,45 +72,15 @@ export declare const toolSchema: z.ZodObject<{
             optional: z.ZodOptional<z.ZodBoolean>;
             isArray: z.ZodOptional<z.ZodBoolean>;
             subType: z.ZodOptional<z.ZodString>;
-        }, "strip", z.ZodTypeAny, {
-            name: string;
-            type: import("../types/field-type").FieldType;
-            optional?: boolean | undefined;
-            description?: string | undefined;
-            defaultValue?: any;
-            isArray?: boolean | undefined;
-            subType?: string | undefined;
-        }, {
-            name: string;
-            type: import("../types/field-type").FieldType;
-            optional?: boolean | undefined;
-            description?: string | undefined;
-            defaultValue?: any;
-            isArray?: boolean | undefined;
-            subType?: string | undefined;
-        }>, "many">>;
+            fields: z.ZodOptional<z.ZodLazy<z.ZodArray<z.ZodType<import("../types/field-type").IField>>>>;
+            enumValues: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+        }, "strip", z.ZodTypeAny, import("../types/field-type").IField, import("../types/field-type").IField>, "many">>;
     }, "strip", z.ZodTypeAny, {
         type: IOSchemaType;
-        fields: {
-            name: string;
-            type: import("../types/field-type").FieldType;
-            optional?: boolean | undefined;
-            description?: string | undefined;
-            defaultValue?: any;
-            isArray?: boolean | undefined;
-            subType?: string | undefined;
-        }[];
+        fields: import("../types/field-type").IField[];
     }, {
         type: IOSchemaType;
-        fields?: {
-            name: string;
-            type: import("../types/field-type").FieldType;
-            optional?: boolean | undefined;
-            description?: string | undefined;
-            defaultValue?: any;
-            isArray?: boolean | undefined;
-            subType?: string | undefined;
-        }[] | undefined;
+        fields?: import("../types/field-type").IField[] | undefined;
     }>;
     configSchema: z.ZodOptional<z.ZodObject<{
         type: z.ZodNativeEnum<typeof IOSchemaType>;
@@ -182,45 +92,15 @@ export declare const toolSchema: z.ZodObject<{
             optional: z.ZodOptional<z.ZodBoolean>;
             isArray: z.ZodOptional<z.ZodBoolean>;
             subType: z.ZodOptional<z.ZodString>;
-        }, "strip", z.ZodTypeAny, {
-            name: string;
-            type: import("../types/field-type").FieldType;
-            optional?: boolean | undefined;
-            description?: string | undefined;
-            defaultValue?: any;
-            isArray?: boolean | undefined;
-            subType?: string | undefined;
-        }, {
-            name: string;
-            type: import("../types/field-type").FieldType;
-            optional?: boolean | undefined;
-            description?: string | undefined;
-            defaultValue?: any;
-            isArray?: boolean | undefined;
-            subType?: string | undefined;
-        }>, "many">>;
+            fields: z.ZodOptional<z.ZodLazy<z.ZodArray<z.ZodType<import("../types/field-type").IField>>>>;
+            enumValues: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+        }, "strip", z.ZodTypeAny, import("../types/field-type").IField, import("../types/field-type").IField>, "many">>;
     }, "strip", z.ZodTypeAny, {
         type: IOSchemaType;
-        fields: {
-            name: string;
-            type: import("../types/field-type").FieldType;
-            optional?: boolean | undefined;
-            description?: string | undefined;
-            defaultValue?: any;
-            isArray?: boolean | undefined;
-            subType?: string | undefined;
-        }[];
+        fields: import("../types/field-type").IField[];
     }, {
         type: IOSchemaType;
-        fields?: {
-            name: string;
-            type: import("../types/field-type").FieldType;
-            optional?: boolean | undefined;
-            description?: string | undefined;
-            defaultValue?: any;
-            isArray?: boolean | undefined;
-            subType?: string | undefined;
-        }[] | undefined;
+        fields?: import("../types/field-type").IField[] | undefined;
     }>>;
     code: z.ZodDefault<z.ZodString>;
     codeRepository: z.ZodOptional<z.ZodString>;
@@ -235,27 +115,11 @@ export declare const toolSchema: z.ZodObject<{
     usageDescription: string;
     inputSchema: {
         type: IOSchemaType;
-        fields: {
-            name: string;
-            type: import("../types/field-type").FieldType;
-            optional?: boolean | undefined;
-            description?: string | undefined;
-            defaultValue?: any;
-            isArray?: boolean | undefined;
-            subType?: string | undefined;
-        }[];
+        fields: import("../types/field-type").IField[];
     };
     outputSchema: {
         type: IOSchemaType;
-        fields: {
-            name: string;
-            type: import("../types/field-type").FieldType;
-            optional?: boolean | undefined;
-            description?: string | undefined;
-            defaultValue?: any;
-            isArray?: boolean | undefined;
-            subType?: string | undefined;
-        }[];
+        fields: import("../types/field-type").IField[];
     };
     toolId: string;
     contractId?: string | undefined;
@@ -266,15 +130,7 @@ export declare const toolSchema: z.ZodObject<{
     catalogReason?: string | undefined;
     configSchema?: {
         type: IOSchemaType;
-        fields: {
-            name: string;
-            type: import("../types/field-type").FieldType;
-            optional?: boolean | undefined;
-            description?: string | undefined;
-            defaultValue?: any;
-            isArray?: boolean | undefined;
-            subType?: string | undefined;
-        }[];
+        fields: import("../types/field-type").IField[];
     } | undefined;
     isAssistantRunner?: boolean | undefined;
     detailedDescription?: string | undefined;
@@ -288,27 +144,11 @@ export declare const toolSchema: z.ZodObject<{
     usageDescription: string;
     inputSchema: {
         type: IOSchemaType;
-        fields?: {
-            name: string;
-            type: import("../types/field-type").FieldType;
-            optional?: boolean | undefined;
-            description?: string | undefined;
-            defaultValue?: any;
-            isArray?: boolean | undefined;
-            subType?: string | undefined;
-        }[] | undefined;
+        fields?: import("../types/field-type").IField[] | undefined;
     };
     outputSchema: {
         type: IOSchemaType;
-        fields?: {
-            name: string;
-            type: import("../types/field-type").FieldType;
-            optional?: boolean | undefined;
-            description?: string | undefined;
-            defaultValue?: any;
-            isArray?: boolean | undefined;
-            subType?: string | undefined;
-        }[] | undefined;
+        fields?: import("../types/field-type").IField[] | undefined;
     };
     toolId: string;
     code?: string | undefined;
@@ -320,15 +160,7 @@ export declare const toolSchema: z.ZodObject<{
     catalogReason?: string | undefined;
     configSchema?: {
         type: IOSchemaType;
-        fields?: {
-            name: string;
-            type: import("../types/field-type").FieldType;
-            optional?: boolean | undefined;
-            description?: string | undefined;
-            defaultValue?: any;
-            isArray?: boolean | undefined;
-            subType?: string | undefined;
-        }[] | undefined;
+        fields?: import("../types/field-type").IField[] | undefined;
     } | undefined;
     isAssistantRunner?: boolean | undefined;
     detailedDescription?: string | undefined;
@@ -361,27 +193,11 @@ export declare function Tools(dataContext?: DataContext): import("..").Table<{
     usageDescription: string;
     inputSchema: {
         type: IOSchemaType;
-        fields: {
-            name: string;
-            type: import("../types/field-type").FieldType;
-            optional?: boolean | undefined;
-            description?: string | undefined;
-            defaultValue?: any;
-            isArray?: boolean | undefined;
-            subType?: string | undefined;
-        }[];
+        fields: import("../types/field-type").IField[];
     };
     outputSchema: {
         type: IOSchemaType;
-        fields: {
-            name: string;
-            type: import("../types/field-type").FieldType;
-            optional?: boolean | undefined;
-            description?: string | undefined;
-            defaultValue?: any;
-            isArray?: boolean | undefined;
-            subType?: string | undefined;
-        }[];
+        fields: import("../types/field-type").IField[];
     };
     toolId: string;
     contractId?: string | undefined;
@@ -392,15 +208,7 @@ export declare function Tools(dataContext?: DataContext): import("..").Table<{
     catalogReason?: string | undefined;
     configSchema?: {
         type: IOSchemaType;
-        fields: {
-            name: string;
-            type: import("../types/field-type").FieldType;
-            optional?: boolean | undefined;
-            description?: string | undefined;
-            defaultValue?: any;
-            isArray?: boolean | undefined;
-            subType?: string | undefined;
-        }[];
+        fields: import("../types/field-type").IField[];
     } | undefined;
     isAssistantRunner?: boolean | undefined;
     detailedDescription?: string | undefined;

package/dist/data/users.d.ts

@@ -84,8 +84,7 @@ export declare class UsersTable extends Table<IUser> {
      */
     save(user: IUser, opts?: ISaveOptions): Promise<IUser>;
     signAndSave(user: IUser, opts?: ISaveOptions): Promise<IUser>;
-    private static addSignatureToUser;
-    /** Enables signing for proxied `signAndSave` calls. */
+    /** Registers the signer for all SDK copies in this JavaScript realm. Replaces any prior signer. */
     static enableUserSigning(fn: (user: IUser) => IUser): void;
     /** @deprecated Forbidden on UsersTable; use save() */
     insert(..._args: Parameters<Table<IUser>["insert"]>): never;

package/dist/data/users.js

@@ -102,6 +102,9 @@ let userRowChangeGuard = refuseIdentityChanges;
 function setUserRowChangeGuard(guard) {
     userRowChangeGuard = guard ?? refuseIdentityChanges;
 }
+// Symbol.for keeps signer registration shared by separately installed SDK copies.
+const signingKey = Symbol.for("@peers-app/peers-sdk/user-signing");
+const signingGlobals = globalThis;
 /** User table with owner-signature enforcement outside the personal context. */
 let UsersTable = (() => {
     let _classSuper = table_1.Table;
@@ -170,20 +173,20 @@ let UsersTable = (() => {
             return super.save(verdict.row, opts);
         }
         async signAndSave(user, opts) {
-            if (!UsersTable.addSignatureToUser) {
+            const sign = signingGlobals[signingKey];
+            if (!sign) {
                 throw new Error("User signing must be enabled to sign and save users. Call UsersTable.enableUserSigning(fn) to enable it.");
             }
             user = {
                 ...user,
                 name: user.name.slice(0, devices_1.DISPLAY_NAME_MAX_LENGTH),
             };
-            user = UsersTable.addSignatureToUser(user);
+            user = sign.call(UsersTable, user);
             return this.save(user, opts);
         }
-        static addSignatureToUser = undefined;
-        /** Enables signing for proxied `signAndSave` calls. */
+        /** Registers the signer for all SDK copies in this JavaScript realm. Replaces any prior signer. */
         static enableUserSigning(fn) {
-            UsersTable.addSignatureToUser = fn;
+            signingGlobals[signingKey] = fn;
         }
         /** @deprecated Forbidden on UsersTable; use save() */
         insert(..._args) {

package/dist/define/also-implements.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/define/also-implements.test.js

@@ -0,0 +1,123 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const frozen_contracts_1 = require("../contracts/frozen-contracts");
+const registry_1 = require("../contracts/registry");
+const isolated_artifact_1 = require("../package-loader/isolated-artifact");
+const peer_id_1 = require("../peer-id");
+const index_1 = require("./index");
+const manifest_1 = require("./manifest");
+const packageId = (0, peer_id_1.newid)();
+const contractId = (0, peer_id_1.newid)();
+/** Notes vN: `add` takes a title, and each later version adds an optional field. */
+function notes(version, extra = {}, alsoImplements) {
+    return (0, index_1.defineContract)({
+        contractId,
+        version,
+        name: "Notes",
+        tools: [
+            (0, index_1.defineTool)({
+                name: "add",
+                usageDescription: "Add a note.",
+                accessLevel: index_1.AccessLevel.Writer,
+                inputSchema: index_1.z.object({ title: index_1.z.string(), ...extra }),
+                outputSchema: index_1.z.object({ id: index_1.z.string() }),
+                handler: () => ({ id: "n1" }),
+            }),
+        ],
+        ...(alsoImplements ? { alsoImplements } : {}),
+    });
+}
+const pkg = (...contracts) => (0, index_1.definePackage)((builder) => {
+    builder.packageId = packageId;
+    builder.version = "2.0.0";
+    for (const contract of contracts)
+        builder.provides(contract);
+});
+/** What `frozen-contracts.json` holds after a stable release that provided `contracts`. */
+function frozenAfter(...contracts) {
+    const manifest = (0, manifest_1.buildPackageManifest)(pkg(...contracts));
+    return (0, frozen_contracts_1.freezeContracts)(undefined, manifest.provides.map((contract) => (0, isolated_artifact_1.isolatedContractToDefinition)(contract, [])), "1.0.0").frozen;
+}
+describe("alsoImplements in /define", () => {
+    it("takes older versions by number and declarations, and refuses itself, repeats, and the rest", () => {
+        expect(notes(2, {}, [1]).alsoImplements).toEqual([1]);
+        expect(() => notes(2, {}, [2])).toThrow("can't also implement itself");
+        expect(() => notes(2, {}, [3])).toThrow("alsoImplements v3 must be older than v2");
+        expect(() => notes(3, {}, [1, 1])).toThrow(`also implements ${contractId}@1 twice`);
+        expect(() => notes(2, {}, [0])).toThrow("must be a positive integer");
+        expect(() => (0, index_1.defineContract)({ contractId, version: 2, name: "Notes", alsoImplements: [{}] })).toThrow("takes version numbers and declarations from declareContract");
+        // Its own older version by declaration would skip the shape its stable release froze.
+        const NotesV1 = (0, index_1.declareContract)({ contractId, version: 1, name: "Notes" });
+        expect(() => (0, index_1.defineContract)({ contractId, version: 2, name: "Notes", alsoImplements: [NotesV1] })).toThrow("takes its own contract's older versions by number, not by declaration");
+    });
+    it("carries an older version's frozen shape in the manifest, so the host can register it", () => {
+        const frozen = frozenAfter(notes(1));
+        const manifest = (0, manifest_1.buildPackageManifest)(pkg(notes(2, { tag: index_1.z.string().optional() }, [1])), {
+            frozen,
+        });
+        const [entry] = manifest.provides[0].alsoImplements ?? [];
+        expect(entry).toMatchObject({ contractId, version: 1, definition: { contractId, version: 1 } });
+        expect(entry.definition).not.toHaveProperty("frozenBy");
+        expect(() => (0, isolated_artifact_1.validateIsolatedPackageArtifact)({ manifest, providerSource: "void 0;" }, { strict: true })).not.toThrow();
+        // A cold start: the registry has never seen v1, and still routes it to v2.
+        const registry = new registry_1.ContractRegistry();
+        registry.registerBatch(packageId, manifest.provides.map((contract) => ({
+            definition: (0, isolated_artifact_1.isolatedContractToDefinition)(contract, []),
+            alsoImplements: contract.alsoImplements,
+        })));
+        expect(registry.getProviderPackageId(contractId, 1)).toBe(packageId);
+        expect(registry.getProviderImplementation(contractId, 1, packageId)).toEqual({
+            contractId,
+            version: 2,
+        });
+    });
+    it("needs the older version frozen, and refuses one the contract no longer satisfies", () => {
+        expect(() => (0, manifest_1.buildPackageManifest)(pkg(notes(2, {}, [1])))).toThrow("also implements v1, which frozen-contracts.json doesn't record");
+        const frozen = frozenAfter(notes(1));
+        // v1 callers may leave out an optional field, so v2 can't require one.
+        expect(() => (0, manifest_1.buildPackageManifest)(pkg(notes(2, { tag: index_1.z.string() }, [1])), { frozen })).toThrow(/doesn't satisfy Notes .*@1.*extra required input field 'tag'/);
+        expect(() => (0, manifest_1.buildPackageManifest)(pkg(notes(1), notes(2, {}, [1])), { frozen })).toThrow(`also implements ${contractId}@1, which the package provides with pkg.provides`);
+    });
+    it("takes another contract's declaration, and implementContract takes alsoImplements too", () => {
+        const otherId = (0, peer_id_1.newid)();
+        const Other = (0, index_1.declareContract)({
+            contractId: otherId,
+            version: 1,
+            name: "Other",
+            tools: [
+                (0, index_1.declareTool)({
+                    name: "add",
+                    usageDescription: "Add.",
+                    accessLevel: index_1.AccessLevel.Writer,
+                    inputSchema: index_1.z.object({ title: index_1.z.string() }),
+                    outputSchema: index_1.z.object({ id: index_1.z.string() }),
+                }),
+            ],
+        });
+        const manifest = (0, manifest_1.buildPackageManifest)(pkg(notes(2, {}, [Other])));
+        expect(manifest.provides[0].alsoImplements?.[0]).toMatchObject({
+            contractId: otherId,
+            version: 1,
+            definition: { name: "Other", tools: [expect.objectContaining({ name: "add" })] },
+        });
+        const NotesV2 = (0, index_1.declareContract)({
+            contractId,
+            version: 2,
+            name: "Notes",
+            tools: [
+                (0, index_1.declareTool)({
+                    name: "add",
+                    usageDescription: "Add a note.",
+                    accessLevel: index_1.AccessLevel.Writer,
+                    inputSchema: index_1.z.object({ title: index_1.z.string() }),
+                    outputSchema: index_1.z.object({ id: index_1.z.string() }),
+                }),
+            ],
+        });
+        const implemented = (0, index_1.implementContract)(NotesV2, {
+            tools: { add: () => ({ id: "n1" }) },
+            alsoImplements: [1],
+        });
+        expect(implemented.alsoImplements).toEqual([1]);
+    });
+});

package/dist/define/context.d.ts

@@ -0,0 +1,77 @@
+import type { PersistentVarScope } from "../data/persistent-var-identity";
+import type { IsolatedContractTableOperation } from "../package-loader/isolated-runtime";
+/**
+ * Ends a subscription or a watch. Unsubscribing from a consumed contract waits for the provider
+ * and rejects if it fails, so await it or catch the rejection.
+ */
+export type PackageUnsubscribe = () => unknown;
+/** A consumed-event callback. `ctx` belongs to that delivery. */
+export type PackageEventHandler = (payload: unknown, ctx: IPackageContext) => unknown;
+/** Picks one provider of a consumed contract. */
+export interface IPackageProviderOptions {
+    /** Package that serves the contract. Omit for the group's default provider. */
+    providerPackageId?: string;
+}
+/**
+ * The host functions the Runtime gives one handler call (guest API 2 and 3).
+ *
+ * Every tool handler gets its own `ctx`, and host calls made through it act for that call's
+ * caller, even while other calls run. The table and contract handles in this module take a
+ * `ctx` and make these calls for you, and the package's variables (`deviceVar` and the rest),
+ * events, and observables need none; use these directly only for what those don't cover yet.
+ */
+export interface IPackageContext {
+    /** Run a tool on a contract this package consumes (or provides), as this call's caller. */
+    callConsumedTool(contractId: string, version: number, toolName: string, args?: unknown, options?: IPackageProviderOptions): Promise<unknown>;
+    /** Run a tool on another device. The remote device authorizes the call. */
+    callRemoteTool(contractId: string, version: number, deviceId: string, toolName: string, args?: unknown): Promise<unknown>;
+    /** Subscribe to an event on a consumed or provided contract. */
+    subscribeConsumedEvent(contractId: string, version: number, eventName: string, handler: PackageEventHandler): Promise<PackageUnsubscribe>;
+    /** Subscribe to `dataChanged` on a table another package exposes through a contract. */
+    subscribeConsumedTableEvent(contractId: string, version: number, tableName: string, eventName: "dataChanged", handler: PackageEventHandler): Promise<PackageUnsubscribe>;
+    /** Emit an event declared on one of this package's provided contracts. */
+    emitContractEvent(contractId: string, version: number, eventName: string, payload: unknown): Promise<unknown>;
+    /** Call a standard method on a table another package exposes through a contract. */
+    callConsumedTable(contractId: string, version: number, tableName: string, operation: IsolatedContractTableOperation, args?: unknown[]): Promise<unknown>;
+    /** Read one row from a consumed contract table. */
+    getConsumedTableRecord(contractId: string, version: number, tableName: string, recordId: string): Promise<unknown>;
+    /** Save one row to a consumed contract table. */
+    saveConsumedTableRecord(contractId: string, version: number, tableName: string, record: unknown): Promise<unknown>;
+    /** Read a consumed contract's observable. */
+    getConsumedObservable(contractId: string, version: number, observableName: string, options?: IPackageProviderOptions): Promise<unknown>;
+    /** Write a consumed contract's writable observable. */
+    setConsumedObservable(contractId: string, version: number, observableName: string, value: unknown, options?: IPackageProviderOptions): Promise<unknown>;
+    /** Call a standard method on one of this package's own tables, with its arguments. */
+    callOwnedTable(tableName: string, operation: IsolatedContractTableOperation, args?: unknown[]): Promise<unknown>;
+    /** Read one owned row by id. */
+    getOwnedTableRecord(tableName: string, recordId: string): Promise<unknown>;
+    /** Insert or replace one owned row. */
+    saveOwnedTableRecord(tableName: string, record: unknown): Promise<unknown>;
+    /** List owned rows (at most 500; use `callOwnedTable` to filter or page). */
+    listOwnedTableRecords(tableName: string): Promise<unknown>;
+    /** Delete one owned row by id. */
+    deleteOwnedTableRecord(tableName: string, recordId: string): Promise<unknown>;
+    /** Read a package-owned persistent variable. The host applies the package prefix. */
+    getOwnedPersistentVar(scope: PersistentVarScope, name: string): Promise<unknown>;
+    /** Replace a package-owned persistent variable. */
+    setOwnedPersistentVar(scope: PersistentVarScope, name: string, value: unknown): Promise<unknown>;
+    /**
+     * Call `handler` when a package-owned persistent variable changes, including through device
+     * sync, until the returned function is called or the worker stops. `handler` gets no value:
+     * read it again.
+     */
+    watchOwnedPersistentVar(scope: PersistentVarScope, name: string, handler: () => unknown): Promise<PackageUnsubscribe>;
+    /**
+     * Set the value of an in-memory observable this package provides (one declared without a
+     * `persistentVar`). The host checks it against the observable's `valueType`, keeps it for
+     * readers, and pushes it to subscribers. Allowed at any time while the worker runs.
+     */
+    publishOwnedObservable(contractId: string, version: number, observableName: string, value: unknown): Promise<unknown>;
+    /**
+     * Take guest API 2 consumers' writes to a writable in-memory observable this package
+     * provides. `handler` gets the value with no caller authority, stores and publishes it, and
+     * returns what it stored. A later call replaces the handler. Guest API 3 instead routes
+     * writes through the contract member handler under the caller's authority.
+     */
+    onOwnedObservableSet(contractId: string, version: number, observableName: string, handler: (value: unknown) => unknown): void;
+}

package/dist/define/context.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });