@peers-app/peers-sdk 0.14.0 → 0.15.0

package/dist/context/data-context.d.ts

@@ -1,8 +1,8 @@
-import { EventRegistry, TableContainer, ITableDependencies, ITableMetaData, Table } from "../data/orm";
-import { DataSourceFactory } from "../data/orm/table-definitions.type";
+import type { z } from "zod";
+import { EventRegistry, type ITableDependencies, type ITableMetaData, Table, TableContainer } from "../data/orm";
+import type { DataSourceFactory } from "../data/orm/table-definitions.type";
 import { PackageLoader } from "../package-loader/package-loader";
-import { UserContext } from "./user-context";
-import { z } from "zod";
+import type { UserContext } from "./user-context";
 export declare class DataContext {
     readonly userContext: UserContext;
     readonly groupId?: string | undefined;

package/dist/context/data-context.js

@@ -40,7 +40,7 @@ class DataContext {
             dataSource: this.dataSourceFactory(metaData, schema),
             eventRegistry: this.eventRegistry,
             schema,
-            groupId: this.groupId
+            groupId: this.groupId,
         };
     }
     /**

package/dist/context/index.d.ts

@@ -1,3 +1,3 @@
-export * from './user-context-singleton';
-export * from './data-context';
-export * from './user-context';
+export * from "./user-context-singleton";
+export * from "./data-context";
+export * from "./user-context";

package/dist/context/index.js

@@ -14,6 +14,10 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+// Order matters: user-context-singleton must load first so the circular
+// chain context → data-context → package-loader → data/files resolves
+// before data/index.js is pulled in via user-context. Do not alphabetize.
+// biome-ignore assist/source/organizeImports: export order is load-order-sensitive
 __exportStar(require("./user-context-singleton"), exports);
 __exportStar(require("./data-context"), exports);
 __exportStar(require("./user-context"), exports);

package/dist/context/user-context-singleton.js

@@ -9,11 +9,11 @@ exports.setDefaultClientUserContext = setDefaultClientUserContext;
 exports.getAllTables = getAllTables;
 const client_proxy_data_source_1 = require("../data/orm/client-proxy.data-source");
 const rpc_types_1 = require("../rpc-types");
-const user_context_1 = require("./user-context");
 const utils_1 = require("../utils");
+const user_context_1 = require("./user-context");
 // This should be the only singleton pattern in the application
 // everything should be driven off the UserContext instance
-var userContextInstance = undefined;
+var userContextInstance;
 var userContextResolved;
 var userContextPromise;
 async function getUserContext() {
@@ -21,7 +21,7 @@ async function getUserContext() {
         return userContextInstance.loadingPromise;
     }
     if (!userContextPromise) {
-        userContextPromise = new Promise(resolve => {
+        userContextPromise = new Promise((resolve) => {
             userContextResolved = resolve;
             if (userContextInstance) {
                 resolve(userContextInstance.loadingPromise);
@@ -32,11 +32,11 @@ async function getUserContext() {
 }
 function setUserContext(userContext) {
     if (userContextInstance) {
-        if (typeof window !== 'undefined') {
+        if (typeof window !== "undefined") {
             // In a browser/PWA context the module singleton persists across navigations
             // and HMR re-runs. Allow replacing it — the new context is authoritative.
             userContextInstance = userContext;
-            // @ts-ignore
+            // @ts-expect-error
             window.userContext = userContext;
             return;
         }
@@ -46,8 +46,8 @@ function setUserContext(userContext) {
     if (userContextResolved) {
         userContextResolved(userContext.loadingPromise);
     }
-    if (typeof window !== 'undefined') {
-        // @ts-ignore
+    if (typeof window !== "undefined") {
+        // @ts-expect-error
         window.userContext = userContext;
     }
 }
@@ -58,7 +58,7 @@ async function getDefaultDataContext() {
 function getTableContainer(dataContext) {
     dataContext ??= userContextInstance?.defaultDataContext();
     if (!dataContext) {
-        throw new Error('dataContext not provided and user context singleton not yet set');
+        throw new Error("dataContext not provided and user context singleton not yet set");
     }
     return dataContext.tableContainer;
 }
@@ -97,24 +97,23 @@ if (!rpc_types_1.isClient) {
         const userContext = await getUserContext();
         const table = userContext
             .getDataContext(dataContextId || userContext.userId)
-            .tableContainer
-            .getTable(tableName);
+            .tableContainer.getTable(tableName);
         return table;
     }
     // TODO: add check that client has permission to make this call
     rpc_types_1.rpcServerCalls.tableMethodCall = async (dataContextId, tableName, methodName, ...args) => {
         if (!tableName) {
-            throw new Error('tableName is required for tableMethodCall');
+            throw new Error("tableName is required for tableMethodCall");
         }
         if (!dataContextId) {
-            console.warn('dataContextId not provided to tableMethodCall - defaulting to user context.  This is discouraged. If userDataContext was intended then pass it in explicitly.');
+            console.warn("dataContextId not provided to tableMethodCall - defaulting to user context.  This is discouraged. If userDataContext was intended then pass it in explicitly.");
         }
         const table = await getTable(dataContextId, tableName);
         const method = table[methodName];
-        if (typeof method !== 'function') {
+        if (typeof method !== "function") {
             throw new Error(`Method ${methodName} not found on table ${tableName}`);
         }
-        // @ts-ignore - call this way to ensure 'this' is correct
+        // @ts-expect-error - call this way to ensure 'this' is correct
         return table[methodName](...args);
     };
 }

package/dist/context/user-context.d.ts

@@ -1,8 +1,8 @@
 import { DataContext } from "../context/data-context";
-import { IUser } from "../data";
+import { type IUser } from "../data";
 import type { DataSourceFactory, IDataChangedEvent, Table } from "../data/orm";
-import { IPublicPrivateKeys } from "../keys";
-import { Observable } from "../observable";
+import { type IPublicPrivateKeys } from "../keys";
+import { type Observable } from "../observable";
 export declare class UserContext {
     readonly userId: string;
     readonly dataSourceFactory: DataSourceFactory;
@@ -37,8 +37,8 @@ export declare class UserContext {
     getMe(): Promise<{
         name: string;
         publicKey: string;
-        userId: string;
         publicBoxKey: string;
+        userId: string;
         signature?: string | undefined;
     } | undefined>;
     syncUserAndGroupObjects(userId: string, keys: IPublicPrivateKeys, me?: IUser): Promise<void>;

package/dist/context/user-context.js

@@ -12,7 +12,7 @@ class UserContext {
     userId;
     dataSourceFactory;
     ephemeral;
-    deviceId = (0, observable_1.observable)('');
+    deviceId = (0, observable_1.observable)("");
     currentlyActiveGroupId = (0, observable_1.observable)();
     reloadPackagesOnPageRefresh = (0, observable_1.observable)(false);
     groupIds = (0, observable_1.observable)([]);
@@ -26,7 +26,9 @@ class UserContext {
         this.userId = userId;
         this.dataSourceFactory = dataSourceFactory;
         this.ephemeral = ephemeral;
-        if (ephemeral === undefined && typeof process !== 'undefined' && process.env.NODE_ENV === 'test') {
+        if (ephemeral === undefined &&
+            typeof process !== "undefined" &&
+            process.env.NODE_ENV === "test") {
             this.ephemeral = true;
         }
         this.userDataContext = new data_context_1.DataContext(this);
@@ -47,21 +49,23 @@ class UserContext {
      * so any tables in packages have been registered are available at sync time
      */
     loadAllPackages() {
-        this.userDataContext.packageLoader.loadAllPackages()
-            .catch(err => console.error('[UserContext] loadAllPackages failed for userDataContext:', err));
+        this.userDataContext.packageLoader
+            .loadAllPackages()
+            .catch((err) => console.error("[UserContext] loadAllPackages failed for userDataContext:", err));
         for (const groupContext of this.groupDataContexts.values()) {
-            groupContext.packageLoader.loadAllPackages()
-                .catch(err => console.error('[UserContext] loadAllPackages failed for groupContext:', err));
+            groupContext.packageLoader
+                .loadAllPackages()
+                .catch((err) => console.error("[UserContext] loadAllPackages failed for groupContext:", err));
         }
     }
     async loadGroupContexts() {
         const groupsTable = (0, data_1.Groups)(this.userDataContext);
         const groups = await groupsTable.list({ disabled: { $ne: true } });
-        this.groupIds(groups.map(g => g.groupId));
-        groupsTable.dataChanged.subscribe(evt => {
+        this.groupIds(groups.map((g) => g.groupId));
+        groupsTable.dataChanged.subscribe((evt) => {
             const groupId = evt.dataObject.groupId;
-            if (evt.op === 'delete' || evt.dataObject.disabled) {
-                this.groupIds(this.groupIds().filter(id => id !== groupId));
+            if (evt.op === "delete" || evt.dataObject.disabled) {
+                this.groupIds(this.groupIds().filter((id) => id !== groupId));
                 this.groupDataContexts.delete(groupId);
             }
             else {
@@ -127,20 +131,34 @@ class UserContext {
     async loadUserContextObservablesFromDB() {
         // const persistentVars: PersistentVarsTable = await this.userDataContext.tableContainer.getTableByName(persistentVarsMetaData.name) as PersistentVarsTable;
         const persistentVars = (0, data_1.PersistentVars)(this.userDataContext);
-        const vars = await persistentVars.list({ name: { $in: ['thisDeviceId', 'currentlyActiveGroupId', 'reloadPackagesOnPageRefresh'] } });
+        const vars = await persistentVars.list({
+            name: { $in: ["thisDeviceId", "currentlyActiveGroupId", "reloadPackagesOnPageRefresh"] },
+        });
         const varDbValues = vars.reduce((acc, curr) => {
             acc[curr.name] = curr.value?.value;
             return acc;
         }, {});
-        const deviceIdDefaultValue = (typeof process !== 'undefined' && process.env?.DEVICE_ID) || '';
-        const deviceIdPVar = (0, data_1.deviceVar)('thisDeviceId', { defaultValue: deviceIdDefaultValue, dbValue: varDbValues['thisDeviceId'], userContext: this });
+        const deviceIdDefaultValue = (typeof process !== "undefined" && process.env?.DEVICE_ID) || "";
+        const deviceIdPVar = (0, data_1.deviceVar)("thisDeviceId", {
+            defaultValue: deviceIdDefaultValue,
+            dbValue: varDbValues.thisDeviceId,
+            userContext: this,
+        });
         this.deviceId(deviceIdPVar());
         (0, observable_1.linkObservables)(deviceIdPVar, this.deviceId);
-        const currentlyActiveGroupIdPVar = (0, data_1.deviceVar)('currentlyActiveGroupId', { dbValue: varDbValues['currentlyActiveGroupId'], defaultValue: '', userContext: this });
+        const currentlyActiveGroupIdPVar = (0, data_1.deviceVar)("currentlyActiveGroupId", {
+            dbValue: varDbValues.currentlyActiveGroupId,
+            defaultValue: "",
+            userContext: this,
+        });
         this._currentlyActiveGroupIdPVar = currentlyActiveGroupIdPVar;
         this.currentlyActiveGroupId(currentlyActiveGroupIdPVar());
         (0, observable_1.linkObservables)(currentlyActiveGroupIdPVar, this.currentlyActiveGroupId);
-        const reloadPackagesOnPageRefreshPVar = (0, data_1.deviceVar)('reloadPackagesOnPageRefresh', { defaultValue: false, dbValue: varDbValues['reloadPackagesOnPageRefresh'], userContext: this });
+        const reloadPackagesOnPageRefreshPVar = (0, data_1.deviceVar)("reloadPackagesOnPageRefresh", {
+            defaultValue: false,
+            dbValue: varDbValues.reloadPackagesOnPageRefresh,
+            userContext: this,
+        });
         this.reloadPackagesOnPageRefresh(reloadPackagesOnPageRefreshPVar());
         (0, observable_1.linkObservables)(reloadPackagesOnPageRefreshPVar, this.reloadPackagesOnPageRefresh);
         await Promise.all([
@@ -150,20 +168,18 @@ class UserContext {
         ]);
     }
     async getMe() {
-        let dbMe = await (0, data_1.Users)(this.userDataContext).get(this.userId, { useCache: true });
+        const dbMe = await (0, data_1.Users)(this.userDataContext).get(this.userId, { useCache: true });
         return dbMe;
     }
     async syncUserAndGroupObjects(userId, keys, me) {
-        // update my user object for all contexts
-        const userContext = this;
         me ??= await this.getMe();
         if (!me) {
             console.warn(`My user object was not in db, creating now`);
             me = {
                 userId,
-                name: '',
-                publicKey: '',
-                publicBoxKey: '',
+                name: "",
+                publicKey: "",
+                publicBoxKey: "",
             };
         }
         me.publicKey = keys.publicKey;
@@ -172,19 +188,19 @@ class UserContext {
         // sync my user to personal db
         if (!(0, lodash_1.isEqual)(me, meSigned)) {
             (0, keys_1.verifyObjectSignature)(meSigned);
-            await (0, data_1.Users)(userContext.userDataContext).save(meSigned, { weakInsert: true });
+            await (0, data_1.Users)(this.userDataContext).save(meSigned, { weakInsert: true });
         }
         // sync my user to all my groups
-        for (const [, dataContext] of userContext.groupDataContexts) {
-            let groupMe = await (0, data_1.Users)(dataContext).get(me.userId);
+        for (const [, dataContext] of this.groupDataContexts) {
+            const groupMe = await (0, data_1.Users)(dataContext).get(me.userId);
             if (!(0, lodash_1.isEqual)(groupMe, meSigned)) {
                 await (0, data_1.Users)(dataContext).save(meSigned, { weakInsert: true });
             }
         }
         // sync group objects to my personal db
-        for (const [, dataContext] of userContext.groupDataContexts) {
+        for (const [, dataContext] of this.groupDataContexts) {
             if (!dataContext.groupId) {
-                console.error('Group data context is missing group id. Something went wrong');
+                console.error("Group data context is missing group id. Something went wrong");
                 continue;
             }
             const groupObject = await (0, data_1.Groups)(dataContext).get(dataContext.groupId);
@@ -201,9 +217,10 @@ class UserContext {
             }
         }
         if (!this.personalUserSubscription) {
-            this.personalUserSubscription = this.subscribeToDataChangedAcrossAllGroups('Users', async (evt) => {
+            this.personalUserSubscription = this.subscribeToDataChangedAcrossAllGroups("Users", async (evt) => {
                 const changedUser = evt.data.dataObject;
-                if (changedUser.userId !== this.userId && evt.dataContext.dataContextId !== this.userDataContext.dataContextId) {
+                if (changedUser.userId !== this.userId &&
+                    evt.dataContext.dataContextId !== this.userDataContext.dataContextId) {
                     // sync to my personal db if this is a user that I have there
                     const personalContact = await (0, data_1.Users)(this.userDataContext).get(changedUser.userId);
                     if (personalContact && !(0, lodash_1.isEqual)(personalContact, changedUser)) {
@@ -219,10 +236,10 @@ class UserContext {
         }
     }
     subscribeToDataChangedAcrossAllGroups(table, handler) {
-        const tableName = typeof table === 'string' ? table : table.tableName;
+        const tableName = typeof table === "string" ? table : table.tableName;
         const tableEventPrefix = `${tableName}_DataChanged_`;
-        const subscription = (0, events_1.subscribe)(evt => evt.name.startsWith(tableEventPrefix), async (evt) => {
-            const dataContextId = evt.name.endsWith('_') ? this.userId : evt.name.split('_').pop();
+        const subscription = (0, events_1.subscribe)((evt) => evt.name.startsWith(tableEventPrefix), async (evt) => {
+            const dataContextId = evt.name.endsWith("_") ? this.userId : evt.name.split("_").pop();
             const dataContext = this.getDataContext(dataContextId);
             handler({
                 name: evt.name,

package/dist/data/assistants.d.ts

@@ -1,4 +1,4 @@
-import { z } from 'zod';
+import { z } from "zod";
 import type { DataContext } from "../context/data-context";
 export declare enum ToolInclusionStrategy {
     Fixed = "Fixed",

package/dist/data/assistants.js

@@ -3,13 +3,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getPrimaryAssistant = exports.groupPrimaryAssistantVar = exports.userPrimaryAssistantVar = exports.assistantSchema = exports.ToolInclusionStrategy = void 0;
 exports.Assistants = Assistants;
 exports.getAllAssistantIdsMentioned = getAllAssistantIdsMentioned;
-const mentions_1 = require("../mentions");
-const types_1 = require("./orm/types");
-const user_context_singleton_1 = require("../context/user-context-singleton");
-const table_definitions_system_1 = require("./orm/table-definitions.system");
 const zod_1 = require("zod");
+const user_context_singleton_1 = require("../context/user-context-singleton");
+const mentions_1 = require("../mentions");
 const system_ids_1 = require("../system-ids");
 const zod_types_1 = require("../types/zod-types");
+const table_definitions_system_1 = require("./orm/table-definitions.system");
+const types_1 = require("./orm/types");
 const persistent_vars_1 = require("./persistent-vars");
 var ToolInclusionStrategy;
 (function (ToolInclusionStrategy) {
@@ -22,27 +22,38 @@ exports.assistantSchema = zod_1.z.object({
     name: zod_1.z.string(),
     createdAt: zod_1.z.date().default(() => new Date()),
     updatedAt: zod_1.z.date().optional(),
-    description: zod_1.z.string().optional().describe(`Information about the assistant that won't be used in the interaction but can still be used to differentiate between assistants`),
-    assistantRunnerToolId: zod_types_1.zodPeerId.default(system_ids_1.defaultAssistantRunnerToolId).describe('The tool id of the model to use to run the assistant'),
-    assistantRunnerConfig: zod_types_1.zodAnyObject.default({}).describe('The configuration to use when running the assistant'),
-    toolsToInclude: zod_1.z.string().default('').describe('Link the tools that should always be available to this assistant.  Only linked tools will be included.  All other content will be ignored.\n\nex: `$hello-world-tool`'),
+    description: zod_1.z
+        .string()
+        .optional()
+        .describe(`Information about the assistant that won't be used in the interaction but can still be used to differentiate between assistants`),
+    assistantRunnerToolId: zod_types_1.zodPeerId
+        .default(system_ids_1.defaultAssistantRunnerToolId)
+        .describe("The tool id of the model to use to run the assistant"),
+    assistantRunnerConfig: zod_types_1.zodAnyObject
+        .default({})
+        .describe("The configuration to use when running the assistant"),
+    toolsToInclude: zod_1.z
+        .string()
+        .default("")
+        .describe("Link the tools that should always be available to this assistant.  Only linked tools will be included.  All other content will be ignored.\n\nex: `$hello-world-tool`"),
     // toolsToExclude: z.string().optional().describe('Describe or link the tools that should never be available to this assistant'),
-    toolInclusionStrategy: zod_1.z.nativeEnum(ToolInclusionStrategy).default(ToolInclusionStrategy.Linked).describe([
-        'Describe if and how additional tools should be included on each run of the assistant.',
-        '- **Fixed** - Only include the tools specified in `toolsToInclude`.',
+    toolInclusionStrategy: zod_1.z
+        .nativeEnum(ToolInclusionStrategy)
+        .default(ToolInclusionStrategy.Linked)
+        .describe([
+        "Describe if and how additional tools should be included on each run of the assistant.",
+        "- **Fixed** - Only include the tools specified in `toolsToInclude`.",
         "- **Linked** - `Fixed` plus tools linked in the message or chat history of the assistant's current conversation.",
-        '- **Relevant** - `Linked` plus tools matching the context of the conversation determined via vector search (embeddings) of the tools descriptions.',
-    ].join('\n')),
+        "- **Relevant** - `Linked` plus tools matching the context of the conversation determined via vector search (embeddings) of the tools descriptions.",
+    ].join("\n")),
 });
 const metaData = {
-    name: 'Assistants',
-    description: 'The assistants that are available to help users',
-    primaryKeyName: 'assistantId',
+    name: "Assistants",
+    description: "The assistants that are available to help users",
+    primaryKeyName: "assistantId",
     fields: (0, types_1.schemaToFields)(exports.assistantSchema),
-    iconClassName: 'bi bi-person-fill-gear',
-    indexes: [
-        { fields: ['name'], },
-    ],
+    iconClassName: "bi bi-person-fill-gear",
+    indexes: [{ fields: ["name"] }],
 };
 (0, table_definitions_system_1.registerSystemTableDefinition)(metaData, exports.assistantSchema);
 function Assistants(dataContext) {
@@ -52,12 +63,12 @@ function Assistants(dataContext) {
  * Per-user primary assistant preference for the current group.
  * Overrides the group default when set. Synced across the user's devices.
  */
-exports.userPrimaryAssistantVar = (0, persistent_vars_1.groupUserVar)('userPrimaryAssistantId');
+exports.userPrimaryAssistantVar = (0, persistent_vars_1.groupUserVar)("userPrimaryAssistantId");
 /**
  * Group-wide default primary assistant. Applies to all members who haven't set
  * their own preference. Can be set by group admins. Synced to all group members.
  */
-exports.groupPrimaryAssistantVar = (0, persistent_vars_1.groupVar)('groupPrimaryAssistantId');
+exports.groupPrimaryAssistantVar = (0, persistent_vars_1.groupVar)("groupPrimaryAssistantId");
 const getPrimaryAssistant = async (dataContext) => {
     await exports.userPrimaryAssistantVar.loadingPromise;
     const userAssistantId = (0, exports.userPrimaryAssistantVar)();
@@ -75,11 +86,11 @@ const getPrimaryAssistant = async (dataContext) => {
     }
     const fallback = await Assistants(dataContext).get(system_ids_1.openCodeAssistantId);
     if (!fallback)
-        throw new Error('Primary assistant not found');
+        throw new Error("Primary assistant not found");
     return fallback;
 };
 exports.getPrimaryAssistant = getPrimaryAssistant;
 async function getAllAssistantIdsMentioned(message) {
     const mentions = (0, mentions_1.getAllMentions)(message);
-    return mentions.filter(m => m.kind === 'assistant').map(m => m.id);
+    return mentions.filter((m) => m.kind === "assistant").map((m) => m.id);
 }

package/dist/data/change-tracking.d.ts

@@ -5,9 +5,9 @@
  * Unlike V1, each JSON patch operation gets its own record, enabling
  * path-based superseding and more efficient cleanup.
  */
-import { Emitter, Event } from '../events';
-import { DataFilter, IDataQueryParams, ISqlDb, ITableMetaData, SQLDataSource } from './orm';
-import { z } from 'zod';
+import { z } from "zod";
+import { Emitter, type Event } from "../events";
+import { type DataFilter, type IDataQueryParams, type ISqlDb, type ITableMetaData, SQLDataSource } from "./orm";
 export declare const changeRecordSchema: z.ZodObject<{
     changeId: z.ZodEffects<z.ZodString, string, string>;
     transactionId: z.ZodOptional<z.ZodString>;
@@ -73,11 +73,11 @@ export declare class ChangeTrackingTable extends SQLDataSource<IChangeRecord> {
      */
     filterToMissingIds(recordIds: string[]): Promise<string[]>;
     /**
-    * Find changeIds that we do not have
-    *
-    * @param changeIds - Array of changeIds to check
-    * @returns Array of changeIds with no change records
-    */
+     * Find changeIds that we do not have
+     *
+     * @param changeIds - Array of changeIds to check
+     * @returns Array of changeIds with no change records
+     */
     filterToMissingChangeIds(changeIds: string[]): Promise<string[]>;
     markAllPriorChangesSuperseded(tableName: string, recordId: string, supersededAt: number): Promise<void>;
     /**