@peers-app/peers-sdk 0.16.6 → 0.17.0

package/dist/contracts/__tests__/builder.test.js

@@ -286,12 +286,27 @@ describe("definePackage — error cases", () => {
             });
         }).toThrow("valid peer ID");
     });
-    it("throws when no contracts are defined", () => {
-        expect(() => {
-            (0, builder_1.definePackage)((pkg) => {
-                pkg.packageId = TEST_PKG_ID;
-            });
-        }).toThrow("at least one contract");
+    it("allows package with no contracts (UI-only)", () => {
+        const nav = { name: "Game", iconClassName: "bi-controller", navigationPath: "play" };
+        const result = (0, builder_1.definePackage)((pkg) => {
+            pkg.packageId = TEST_PKG_ID;
+            pkg.appNavs = [nav];
+        });
+        expect(result.contracts).toHaveLength(0);
+        expect(result.consumes).toHaveLength(0);
+        expect(result.toolInstances).toHaveLength(0);
+        expect(result.tableDefinitions).toHaveLength(0);
+        expect(result.appNavs).toEqual([nav]);
+    });
+    it("allows consumes-only package with no defined contracts", () => {
+        const result = (0, builder_1.definePackage)((pkg) => {
+            pkg.packageId = TEST_PKG_ID;
+            pkg.consumes(TASKS_ID, 1);
+        });
+        expect(result.contracts).toHaveLength(0);
+        expect(result.consumes).toHaveLength(1);
+        expect(result.toolInstances).toHaveLength(0);
+        expect(result.tableDefinitions).toHaveLength(0);
     });
     it("throws on duplicate contract ID + version", () => {
         const dupId = (0, utils_1.newid)();

package/dist/contracts/builder.d.ts

@@ -50,8 +50,13 @@ export declare class ContractBuilder {
     };
 }
 /**
- * Top-level builder passed to the `definePackage` callback. Each package must
- * define at least one contract.
+ * Top-level builder passed to the `definePackage` callback.
+ *
+ * Packages may define **zero** contracts (e.g. UI-only apps with no persisted
+ * tables). Tables, tool shapes, and executable `toolInstances` /
+ * `tableDefinitions` are only attached via {@link PackageBuilder.contract} —
+ * there is no package-level API for them, so persistence always implies a
+ * contract.
  */
 export declare class PackageBuilder {
     private _packageId?;

package/dist/contracts/builder.js

@@ -93,8 +93,13 @@ class ContractBuilder {
 }
 exports.ContractBuilder = ContractBuilder;
 /**
- * Top-level builder passed to the `definePackage` callback. Each package must
- * define at least one contract.
+ * Top-level builder passed to the `definePackage` callback.
+ *
+ * Packages may define **zero** contracts (e.g. UI-only apps with no persisted
+ * tables). Tables, tool shapes, and executable `toolInstances` /
+ * `tableDefinitions` are only attached via {@link PackageBuilder.contract} —
+ * there is no package-level API for them, so persistence always implies a
+ * contract.
  */
 class PackageBuilder {
     _packageId;
@@ -168,9 +173,6 @@ class PackageBuilder {
         if (!this._packageId) {
             throw new Error("A package must set packageId before building");
         }
-        if (this._contracts.length === 0) {
-            throw new Error("A package must define at least one contract");
-        }
         const contracts = [];
         const alsoImplementsMap = new Map();
         const allToolInstances = [];
@@ -184,6 +186,9 @@ class PackageBuilder {
             allToolInstances.push(...toolInstances);
             allTableDefinitions.push(...tableDefinitions);
         }
+        if (contracts.length === 0 && (allToolInstances.length > 0 || allTableDefinitions.length > 0)) {
+            throw new Error("Tables and executable tools must be declared on a contract (use pkg.contract(...), then assign .tables, .tools, .toolInstances, or .tableDefinitions on that builder). UI-only packages omit contracts and do not register tables or tools.");
+        }
         return {
             packageId: this._packageId,
             version: this._version,

package/dist/data/tools.d.ts

@@ -3,8 +3,7 @@ import type { DataContext } from "../context/data-context";
 export declare enum IOSchemaType {
     none = "none",
     simple = "simple",
-    complex = "complex",
-    code = "code"
+    complex = "complex"
 }
 export declare const ioSchema: z.ZodObject<{
     type: z.ZodNativeEnum<typeof IOSchemaType>;

package/dist/data/tools.js

@@ -13,7 +13,6 @@ var IOSchemaType;
     IOSchemaType["none"] = "none";
     IOSchemaType["simple"] = "simple";
     IOSchemaType["complex"] = "complex";
-    IOSchemaType["code"] = "code";
 })(IOSchemaType || (exports.IOSchemaType = IOSchemaType = {}));
 exports.ioSchema = zod_1.z.object({
     type: zod_1.z.nativeEnum(IOSchemaType),

package/dist/rpc-types.d.ts

@@ -61,6 +61,13 @@ export declare const rpcServerCalls: {
     /** Clear change tracking and rebuild from current rows for the default data context (same as Data Explorer). */
     resetChangeTracking: () => Promise<void>;
     deleteLocalDatabase: () => Promise<void>;
+    /** Returns info about the pre-migration data directory, or `null` if already cleaned up. */
+    getOldDataDirInfo: () => Promise<{
+        path: string;
+        sizeMB: number;
+    } | null>;
+    /** Deletes the pre-migration data directory after the user confirms. */
+    cleanupOldDataDir: () => Promise<void>;
     importGroupShare: (groupShareJson: string) => Promise<string>;
     registerWithPeersServices: () => Promise<string>;
     appQuit: () => Promise<void>;

package/dist/rpc-types.js

@@ -34,6 +34,10 @@ exports.rpcServerCalls = {
     /** Clear change tracking and rebuild from current rows for the default data context (same as Data Explorer). */
     resetChangeTracking: rpcStub("resetChangeTracking"),
     deleteLocalDatabase: rpcStub("deleteLocalDatabase"),
+    /** Returns info about the pre-migration data directory, or `null` if already cleaned up. */
+    getOldDataDirInfo: rpcStub("getOldDataDirInfo"),
+    /** Deletes the pre-migration data directory after the user confirms. */
+    cleanupOldDataDir: rpcStub("cleanupOldDataDir"),
     importGroupShare: rpcStub("importGroupShare"),
     registerWithPeersServices: rpcStub("registerWithPeersServices"),
     // App lifecycle commands (for CLI control)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@peers-app/peers-sdk",
-  "version": "0.16.6",
+  "version": "0.17.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/peers-app/peers-sdk.git"