@peers-app/peers-sdk 0.29.2 → 0.30.1

package/dist/data/files/files.js

@@ -4,16 +4,19 @@ exports.FilesTable = void 0;
 exports.Files = Files;
 const user_context_singleton_1 = require("../../context/user-context-singleton");
 const rpc_types_1 = require("../../rpc-types");
-const utils_1 = require("../../utils");
 const orm_1 = require("../orm");
 const table_definitions_system_1 = require("../orm/table-definitions.system");
+const chunk_store_1 = require("./chunk-store");
 const file_types_1 = require("./file.types");
 const file_read_stream_1 = require("./file-read-stream");
+const file_rows_1 = require("./file-rows");
 const file_write_stream_1 = require("./file-write-stream");
 /**
  * The chunked, content-hashed file store of one data context. Rows describe files; the bytes
- * live in chunks on disk, shared by hash, and a device fetches a missing chunk from a connected
- * device when it reads. Write through {@link FilesTable.saveFile}, never the table methods.
+ * live in chunks in the account's chunk store, shared by hash, and a device fetches a missing
+ * chunk from a connected device when it reads. A file's id is derived from its content, and its row never changes.
+ * Write through {@link FilesTable.saveFile}, never the table methods. The rules are checked here
+ * in every context, and by every device on the rows it receives in a group (`file-rows.ts`).
  */
 class FilesTable extends orm_1.Table {
     /** @deprecated Direct inserts forbidden; use saveFile() or saveFileRecord() */
@@ -35,19 +38,31 @@ class FilesTable extends orm_1.Table {
     /**
      * Start writing a file in chunks; `finalize()` saves its row.
      *
-     * @param metadata - The new file's id, name, size and MIME type.
+     * @param metadata - The new file's name, MIME type and `keep`.
      */
     async createWriteStream(metadata) {
         return new file_write_stream_1.FileWriteStream(metadata, this);
     }
     /**
-     * Note: Use `saveFile` to write a file to disk. This method is for managing
-     * the file metadata in the database which is done automatically by `saveFile`.
-     * @param fileRecord The file record to save to the database
-     * @returns The inserted file record
+     * Store a file's row as it is, after the checks every device makes: a new row must have the
+     * id derived from its content (or be a legacy row), and a stored row never changes. Storing
+     * the same file again writes nothing. Writers use {@link saveFile} or a write stream; this is
+     * for copying a row from another context with its id.
+     *
+     * @param fileRecord - The row.
+     * @returns The row as stored.
+     * @throws When the row is refused, or a different row has its id.
      */
     async saveFileRecord(fileRecord) {
-        return await super.save(fileRecord);
+        const existing = await super.get(fileRecord.fileId);
+        (0, file_rows_1.checkFileWrite)(existing, fileRecord, fileRecord.fileId);
+        if (existing)
+            return existing;
+        // Another save or sync apply may have inserted the row since the read. In particular, the
+        // personal context has no data-source write check, so never let this become an update.
+        const saved = await super.save(fileRecord, { insertOnly: true });
+        (0, file_rows_1.checkFileWrite)(saved, fileRecord, fileRecord.fileId);
+        return saved;
     }
     /**
      * Open a file for chunked reads.
@@ -62,27 +77,19 @@ class FilesTable extends orm_1.Table {
         if (!fileRecord) {
             return null;
         }
-        return new file_read_stream_1.FileReadStream(fileRecord, this, preloadChunksCount, skipVerification);
+        return new file_read_stream_1.FileReadStream(fileRecord, preloadChunksCount, skipVerification);
     }
     /**
-     * Save a whole file: chunk it, store the chunks and write its row.
+     * Save a whole file: chunk it, store the chunks and write its row. The same bytes, name, MIME
+     * type and `keep` give the same file, whose chunks are stored again.
      *
-     * @param metaData - The file's id, name and MIME type. `fileSize` is taken from `data`.
+     * @param metaData - The file's name, MIME type and `keep` (true unless given).
      * @param data - The bytes, or a string saved as UTF-8.
-     * @returns The saved row.
+     * @returns The file's row.
      */
     async saveFile(metaData, data) {
-        // Use FileWriteStream internally to ensure consistent chunking logic
-        const writeStream = await this.createWriteStream({
-            ...metaData,
-            fileSize: data.length, // Set the actual file size
-        });
-        // Write the entire data to the stream
-        if (typeof data === "string") {
-            data = new Uint8Array(Buffer.from(data, "utf8"));
-        }
-        await writeStream.write(data);
-        // Finalize and return the result
+        const writeStream = await this.createWriteStream(metaData);
+        await writeStream.write(typeof data === "string" ? new Uint8Array(Buffer.from(data, "utf8")) : data);
         return await writeStream.finalize();
     }
     /**
@@ -93,8 +100,7 @@ class FilesTable extends orm_1.Table {
      * @returns The bytes, or null when no such file row exists.
      */
     async getFileContents(fileId, opts) {
-        // Use FileReadStream internally to ensure consistent chunk reading logic
-        const readStream = await this.openReadStream(fileId, undefined, opts?.skipVerification);
+        const readStream = await this.openReadStream(fileId, file_types_1.FILE_FETCH_WINDOW, opts?.skipVerification);
         if (!readStream) {
             return null;
         }
@@ -102,65 +108,43 @@ class FilesTable extends orm_1.Table {
         return await readStream.readAll();
     }
     /**
-     * Delete a file's row, and its index file's. Chunks stay on disk: other files may share them.
+     * Make sure this device has every chunk of a file, fetching the missing ones from connected
+     * devices {@link FILE_FETCH_WINDOW} at a time, without reading the file into memory.
      *
-     * @param fileId - File to delete. A missing file is not an error.
+     * @param fileId - File to fetch.
+     * @returns Whether every chunk is now on this device; false for a file with no row.
      */
-    async deleteFile(fileId) {
-        // Get file metadata from database
-        const fileRecord = await super.get(fileId);
-        if (!fileRecord) {
-            return; // File doesn't exist
-        }
-        // If this file has an index file, recursively delete it first
-        if (fileRecord.indexFileId) {
-            await this.deleteFile(fileRecord.indexFileId);
+    async fetchFile(fileId) {
+        const file = await this.get(fileId);
+        if (!file)
+            return false;
+        const store = await (0, chunk_store_1.getChunkStore)();
+        const chunkHashes = file.chunkHashes ?? [];
+        let complete = chunkHashes.length > 0 || file.fileSize === 0;
+        for (let start = 0; start < chunkHashes.length; start += file_types_1.FILE_FETCH_WINDOW) {
+            const window = chunkHashes.slice(start, start + file_types_1.FILE_FETCH_WINDOW);
+            const fetched = await Promise.all(window.map(async (hash) => (await store.has(hash)) ||
+                // The downloader checks a downloaded chunk's hash and stores it.
+                (await (0, chunk_store_1.downloadChunk)(hash).catch(() => null)) !== null));
+            if (fetched.includes(false))
+                complete = false;
         }
-        // Note: We don't delete chunks since they may be shared with other files
-        // TODO Chunk cleanup needs to be implemented as a separate garbage collection process
-        // that removes chunks not referenced by any files
-        // Delete file record from database
-        await super.delete(fileId);
+        return complete;
     }
     /**
-     * Save a large file's chunk hashes as an index file, itself chunked when large.
+     * Delete a legacy bundle row, which the runtime owns. Every other file is permanent: it's
+     * collected once nothing references it. Chunks stay stored, since other files may share them.
      *
-     * @param chunkHashes - The large file's chunk hashes, in order.
-     * @returns The index file's id.
-     */
-    async createIndexFileRecursively(chunkHashes) {
-        // Create JSON content with chunk hashes
-        const indexContent = JSON.stringify(chunkHashes);
-        const indexBuffer = Buffer.from(indexContent, "utf8");
-        // Generate a new file ID for the index file
-        const indexFileId = (0, utils_1.newid)();
-        // Create metadata for the index file
-        const indexMetadata = {
-            fileId: indexFileId,
-            name: `index-${indexFileId}.json`,
-            fileSize: indexBuffer.length,
-            mimeType: "application/json",
-            isIndexFile: true,
-        };
-        // Recursively save the index file (this will chunk it if it's too large)
-        await this.saveFile(indexMetadata, indexBuffer);
-        return indexFileId;
-    }
-    /**
-     * Read a large file's chunk hashes back from its index file.
-     *
-     * @param indexFileId - The index file's id.
-     * @returns The chunk hashes, in order.
+     * @param fileId - File to delete. A missing file is not an error.
+     * @throws When the file isn't a legacy bundle row.
      */
-    async loadChunkHashesRecursively(indexFileId) {
-        // Recursively load the index file
-        const indexBuffer = await this.getFileContents(indexFileId);
-        if (!indexBuffer) {
-            throw new Error(`Index file not found: ${indexFileId}`);
+    async deleteFile(fileId) {
+        const fileRecord = await super.get(fileId);
+        if (!fileRecord) {
+            return;
         }
-        // Parse chunk hashes from JSON
-        const indexContent = Buffer.from(indexBuffer).toString("utf8");
-        return JSON.parse(indexContent);
+        (0, file_rows_1.checkFileWrite)(fileRecord, undefined, fileId);
+        await super.delete(fileId);
     }
 }
 exports.FilesTable = FilesTable;
@@ -184,14 +168,8 @@ rpc_types_1.rpcServerCalls.getFileContentsBase64 = async (fileId) => {
     return Buffer.from(data).toString("base64");
 };
 rpc_types_1.rpcServerCalls.saveFile = async (input) => {
-    const fileId = input.fileId || (0, utils_1.newid)();
     const encoding = input.encoding || "utf8";
     const dataBuffer = encoding === "base64" ? Buffer.from(input.data, "base64") : Buffer.from(input.data, "utf8");
-    const file = await Files().saveFile({
-        fileId,
-        name: input.name,
-        fileSize: dataBuffer.length,
-        mimeType: input.mimeType,
-    }, new Uint8Array(dataBuffer));
-    return file;
+    // Kept: Family Hub 0.3.x doesn't declare its file fields, so nothing would reference these.
+    return await Files().saveFile({ name: input.name, mimeType: input.mimeType, keep: true }, new Uint8Array(dataBuffer));
 };

package/dist/data/files/index.d.ts

@@ -1,4 +1,6 @@
+export * from "./chunk-store";
 export * from "./file.types";
 export { FileReadStream } from "./file-read-stream";
+export * from "./file-rows";
 export { FileWriteStream } from "./file-write-stream";
 export * from "./files";

package/dist/data/files/index.js

@@ -15,9 +15,11 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FileWriteStream = exports.FileReadStream = void 0;
+__exportStar(require("./chunk-store"), exports);
 __exportStar(require("./file.types"), exports);
 var file_read_stream_1 = require("./file-read-stream");
 Object.defineProperty(exports, "FileReadStream", { enumerable: true, get: function () { return file_read_stream_1.FileReadStream; } });
+__exportStar(require("./file-rows"), exports);
 var file_write_stream_1 = require("./file-write-stream");
 Object.defineProperty(exports, "FileWriteStream", { enumerable: true, get: function () { return file_write_stream_1.FileWriteStream; } });
 __exportStar(require("./files"), exports);

package/dist/data/index.d.ts

@@ -4,6 +4,7 @@ export * from "./authority-write-checks";
 export * from "./change-tracking";
 export * from "./channels";
 export * from "./create-group";
+export * from "./derived-row-id";
 export * from "./device-sync-info";
 export * from "./devices";
 export * from "./embeddings";

package/dist/data/index.js

@@ -20,6 +20,7 @@ __exportStar(require("./authority-write-checks"), exports);
 __exportStar(require("./change-tracking"), exports);
 __exportStar(require("./channels"), exports);
 __exportStar(require("./create-group"), exports);
+__exportStar(require("./derived-row-id"), exports);
 __exportStar(require("./device-sync-info"), exports);
 __exportStar(require("./devices"), exports);
 __exportStar(require("./embeddings"), exports);

package/dist/data/messages.d.ts

@@ -1,5 +1,6 @@
 import { z } from "zod";
 import type { DataContext } from "../context/data-context";
+/** A chat entry in a channel or thread, by a user or an assistant acting for them. */
 export declare const messageSchema: z.ZodObject<{
     messageId: z.ZodEffects<z.ZodString, string, string>;
     channelId: z.ZodEffects<z.ZodString, string, string>;
@@ -34,7 +35,13 @@ export declare const messageSchema: z.ZodObject<{
     fileIds?: string[] | undefined;
     vars?: z.objectInputType<{}, z.ZodAny, "strip"> | undefined;
 }>;
+/** One row of the Messages table. */
 export type IMessage = z.infer<typeof messageSchema>;
+/**
+ * The Messages table in a data context.
+ *
+ * @param dataContext - The context to read; defaults to the active one.
+ */
 export declare function Messages(dataContext?: DataContext): import("..").Table<{
     message: string;
     userId: string;
@@ -52,6 +59,20 @@ interface ISendMessageArgs {
     assistantId?: string;
     messageContent: string;
 }
+/**
+ * Post a message as the current user. The target is a message (a reply goes in its thread), a
+ * workflow run (a reply to the message that started it), a channel, a group (its default
+ * channel), or a user.
+ *
+ * @param args - The target, the content, and the assistant posting it, if any.
+ * @returns The stored message.
+ */
 export declare function sendMessage(args: ISendMessageArgs): Promise<IMessage>;
+/**
+ * The variables set on a message and on the message that started its thread, merged in the order
+ * they were created: a later message's value replaces an earlier one's.
+ *
+ * @param message - A message in the thread.
+ */
 export declare function getThreadVars(message: IMessage): Promise<Record<string, any>>;
 export {};

package/dist/data/messages.js

@@ -14,6 +14,7 @@ const table_definitions_system_1 = require("./orm/table-definitions.system");
 const types_1 = require("./orm/types");
 const users_1 = require("./users");
 const workflow_runs_1 = require("./workflow-runs");
+/** A chat entry in a channel or thread, by a user or an assistant acting for them. */
 exports.messageSchema = zod_1.z.object({
     messageId: zod_types_1.zodPeerId,
     channelId: zod_types_1.zodPeerId.describe("The id of the channel this message entry belongs to"),
@@ -30,7 +31,7 @@ exports.messageSchema = zod_1.z.object({
         .date()
         .optional()
         .describe("The time this message entry was last edited, if it was edited"),
-    fileIds: zod_types_1.zodPeerId.array().optional().describe("The ids of files attached to this message entry"),
+    fileIds: zod_types_1.zodFileId.array().optional().describe("The ids of files attached to this message entry"),
     vars: zod_types_1.zodAnyObject
         .optional()
         .describe("The variables that are associated with this message entry"),
@@ -56,9 +57,22 @@ const metaData = {
     ],
 };
 (0, table_definitions_system_1.registerSystemTableDefinition)(metaData, exports.messageSchema);
+/**
+ * The Messages table in a data context.
+ *
+ * @param dataContext - The context to read; defaults to the active one.
+ */
 function Messages(dataContext) {
     return (0, user_context_singleton_1.getTableContainer)(dataContext).getTable(metaData, exports.messageSchema);
 }
+/**
+ * Post a message as the current user. The target is a message (a reply goes in its thread), a
+ * workflow run (a reply to the message that started it), a channel, a group (its default
+ * channel), or a user.
+ *
+ * @param args - The target, the content, and the assistant posting it, if any.
+ * @returns The stored message.
+ */
 async function sendMessage(args) {
     const { channelOrThreadIdOrWorkflowRunId, assistantId, messageContent } = args;
     let channelId = channelOrThreadIdOrWorkflowRunId;
@@ -98,6 +112,12 @@ async function sendMessage(args) {
     });
     return message;
 }
+/**
+ * The variables set on a message and on the message that started its thread, merged in the order
+ * they were created: a later message's value replaces an earlier one's.
+ *
+ * @param message - A message in the thread.
+ */
 async function getThreadVars(message) {
     const $or = [{ messageId: message.messageId }];
     if (message.messageParentId) {

package/dist/data/orm/sql.data-source.d.ts

@@ -19,7 +19,8 @@ export declare class SQLDataSource<T extends {
     private buildTableSql;
     private ensureTableAndIndexesExist;
     private ensureTableIsNewest;
-    private tableBuild;
+    /** Shared initialization, reset by a subclass that atomically drops its table and derived data. */
+    protected tableBuild: Promise<boolean> | undefined;
     /** Share schema initialization; a failed attempt is evicted so later calls can retry. */
     initTable(force?: boolean): Promise<boolean>;
     get(id: string): Promise<T | undefined>;

package/dist/data/orm/sql.data-source.js

@@ -172,6 +172,7 @@ class SQLDataSource {
         await this.ensureTableAndIndexesExist();
         return false;
     }
+    /** Shared initialization, reset by a subclass that atomically drops its table and derived data. */
     tableBuild;
     /** Share schema initialization; a failed attempt is evicted so later calls can retry. */
     async initTable(force = false) {

package/dist/data/orm/types.js

@@ -65,6 +65,10 @@ function fieldValueSchema(field, mode, open) {
         case "id": {
             const id = zod_1.z.string().refine((value) => (0, utils_1.isid)(value), { message: "Invalid id" });
             id._def._fieldType = field_type_1.FieldType.id;
+            // Keep a file reference a reference when a schema is rebuilt from stored fields.
+            if (field.subType) {
+                id._def._subType = field.subType;
+            }
             return id;
         }
         case "string":
@@ -261,6 +265,7 @@ function schemaToFields(schema) {
         let _def = field._def;
         let isArray;
         let brandedFieldType;
+        let brandedSubType;
         while (true) {
             if (_def.typeName === "ZodArray") {
                 if (isArray)
@@ -272,6 +277,9 @@ function schemaToFields(schema) {
             if (_def._fieldType) {
                 brandedFieldType = _def._fieldType;
             }
+            if (_def._subType) {
+                brandedSubType = _def._subType;
+            }
             if (_def.typeName === "ZodNullable") {
                 nullable = true;
             }
@@ -320,11 +328,15 @@ function schemaToFields(schema) {
         // optional/defaulted elements and nested arrays: enumValues describes each immediate element.
         const values = nullable || !enumElements ? undefined : zodEnumValues(valueSchema);
         const enumValues = values?.length ? [...new Set(values)] : undefined;
+        // A subtype (`zodFileId`'s "file") describes the branded type, so it goes only where that
+        // type was kept.
+        const subType = brandedFieldType && type === brandedFieldType ? brandedSubType : undefined;
         const newField = {
             name,
             type,
             isArray,
             optional,
+            subType,
             description,
             defaultValue,
             enumValues,

package/dist/data/package-versions.js

@@ -58,11 +58,11 @@ const schema = zod_1.z.object({
     version: zod_1.z.string().describe('Semantic version string (e.g., "1.0.0")'),
     versionTag: zod_1.z.string().optional().describe('Version tag (e.g., "stable", "beta")'),
     packageVersionHash: zod_1.z.string().describe("Hash of the combined bundle file hashes"),
-    packageBundleFileId: zod_types_1.zodPeerId.describe("File ID of the package bundle"),
+    packageBundleFileId: zod_types_1.zodFileId.describe("File ID of the package bundle"),
     packageBundleFileHash: zod_1.z.string().describe("Hash of the package bundle file"),
-    routesBundleFileId: zod_types_1.zodPeerId.optional().describe("File ID of the routes bundle"),
+    routesBundleFileId: zod_types_1.zodFileId.optional().describe("File ID of the routes bundle"),
     routesBundleFileHash: zod_1.z.string().optional().describe("Hash of the routes bundle"),
-    uiBundleFileId: zod_types_1.zodPeerId.optional().describe("File ID of the UI bundle"),
+    uiBundleFileId: zod_types_1.zodFileId.optional().describe("File ID of the UI bundle"),
     uiBundleFileHash: zod_1.z.string().optional().describe("Hash of the UI bundle"),
     appNavs: app_nav_1.appNavSchema
         .array()

package/dist/define/index.d.ts

@@ -14,7 +14,7 @@ export { type Observable, observable, type Subscription } from "../observable";
 export type { IPackageSaveOptions } from "../package-loader/isolated-runtime";
 export { idFromKey, isid, newid } from "../peer-id";
 export { FieldType, type IField } from "../types/field-type";
-export { zodPeerId } from "../types/zod-types";
+export { zodFileId, zodPeerId } from "../types/zod-types";
 export * from "./context";
 export * from "./contract-ref";
 export * from "./declare-contract";

package/dist/define/index.js

@@ -14,7 +14,7 @@ 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 });
-exports.writePackageVar = exports.userVar = exports.readPackageVar = exports.groupVar = exports.groupUserVar = exports.groupDeviceVar = exports.deviceVar = exports.isImplementedObservable = exports.defineObservable = exports.declareObservable = exports.generatedField = exports.defineEvent = exports.zodPeerId = exports.FieldType = exports.newid = exports.isid = exports.idFromKey = exports.observable = exports.AccessLevel = exports.z = void 0;
+exports.writePackageVar = exports.userVar = exports.readPackageVar = exports.groupVar = exports.groupUserVar = exports.groupDeviceVar = exports.deviceVar = exports.isImplementedObservable = exports.defineObservable = exports.declareObservable = exports.generatedField = exports.defineEvent = exports.zodPeerId = exports.zodFileId = exports.FieldType = exports.newid = exports.isid = exports.idFromKey = exports.observable = exports.AccessLevel = exports.z = void 0;
 /**
  * `@peers-app/peers-sdk/define`: declare an isolated package.
  *
@@ -36,6 +36,7 @@ Object.defineProperty(exports, "newid", { enumerable: true, get: function () { r
 var field_type_1 = require("../types/field-type");
 Object.defineProperty(exports, "FieldType", { enumerable: true, get: function () { return field_type_1.FieldType; } });
 var zod_types_1 = require("../types/zod-types");
+Object.defineProperty(exports, "zodFileId", { enumerable: true, get: function () { return zod_types_1.zodFileId; } });
 Object.defineProperty(exports, "zodPeerId", { enumerable: true, get: function () { return zod_types_1.zodPeerId; } });
 __exportStar(require("./context"), exports);
 __exportStar(require("./contract-ref"), exports);

package/dist/define/system-contracts.d.ts

@@ -140,10 +140,17 @@ export declare const SystemContractCatalog: import("./contract-ref").IContractRe
 }>;
 /**
  * System Files v1: save a file and read it back, in the package's own data context. Files sync
- * to the context's other devices. Declare it with `pkg.consumes(SystemFiles)`.
+ * to the context's other devices. Declare it with `pkg.consumes(SystemFiles)`; save a file over
+ * 8 MiB with {@link saveWholeFile}.
  */
 export declare const SystemFiles: import("./contract-ref").IContractRef<{
     save(input: import("../contracts/system/files-shared").IFilesSaveInput): Promise<import("../contracts/system/files-shared").IFilesSaveResult>;
     read(input: import("../contracts/system/files-shared").IFilesReadInput): Promise<import("../contracts/system/files-shared").IFilesReadResult>;
+    startSave(input: import("../contracts/system/files-shared").IFilesStartSaveInput): Promise<import("../contracts/system/files-shared").IFilesSaveSession>;
+    appendSave(input: import("../contracts/system/files-shared").IFilesAppendSaveInput): Promise<import("../contracts/system/files-shared").IFilesAppendSaveResult>;
+    finishSave(input: import("../contracts/system/files-shared").IFilesSaveSession): Promise<import("../contracts/system/files-shared").IFilesSaveResult>;
+    cancelSave(input: import("../contracts/system/files-shared").IFilesSaveSession): Promise<{
+        cancelled: boolean;
+    }>;
 }>;
-export { FILES_MAX_CALL_BYTES, type IFilesReadInput, type IFilesReadResult, type IFilesSaveInput, type IFilesSaveResult, readWholeFile, } from "../contracts/system/files-shared";
+export { FILES_MAX_CALL_BYTES, FILES_MAX_FILE_BYTES, FILES_WHOLE_READ_MAX_BYTES, type FileBytesSource, type IFilesAppendSaveInput, type IFilesAppendSaveResult, type IFilesReadInput, type IFilesReadResult, type IFilesSaveInput, type IFilesSaveResult, type IFilesSaveSession, type IFilesStartSaveInput, readWholeFile, saveWholeFile, } from "../contracts/system/files-shared";

package/dist/define/system-contracts.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.readWholeFile = exports.FILES_MAX_CALL_BYTES = exports.SystemFiles = exports.SystemContractCatalog = exports.SystemScheduler = exports.SystemGroupMembers = exports.SystemIdentity = exports.SystemHttp = void 0;
+exports.saveWholeFile = exports.readWholeFile = exports.FILES_WHOLE_READ_MAX_BYTES = exports.FILES_MAX_FILE_BYTES = exports.FILES_MAX_CALL_BYTES = exports.SystemFiles = exports.SystemContractCatalog = exports.SystemScheduler = exports.SystemGroupMembers = exports.SystemIdentity = exports.SystemHttp = void 0;
 const system_ids_1 = require("../system-ids");
 const contract_ref_1 = require("./contract-ref");
 /**
@@ -25,9 +25,13 @@ exports.SystemScheduler = (0, contract_ref_1.contractRef)(system_ids_1.scheduler
 exports.SystemContractCatalog = (0, contract_ref_1.contractRef)(system_ids_1.contractCatalogContractId, 1);
 /**
  * System Files v1: save a file and read it back, in the package's own data context. Files sync
- * to the context's other devices. Declare it with `pkg.consumes(SystemFiles)`.
+ * to the context's other devices. Declare it with `pkg.consumes(SystemFiles)`; save a file over
+ * 8 MiB with {@link saveWholeFile}.
  */
 exports.SystemFiles = (0, contract_ref_1.contractRef)(system_ids_1.filesContractId, 1);
 var files_shared_1 = require("../contracts/system/files-shared");
 Object.defineProperty(exports, "FILES_MAX_CALL_BYTES", { enumerable: true, get: function () { return files_shared_1.FILES_MAX_CALL_BYTES; } });
+Object.defineProperty(exports, "FILES_MAX_FILE_BYTES", { enumerable: true, get: function () { return files_shared_1.FILES_MAX_FILE_BYTES; } });
+Object.defineProperty(exports, "FILES_WHOLE_READ_MAX_BYTES", { enumerable: true, get: function () { return files_shared_1.FILES_WHOLE_READ_MAX_BYTES; } });
 Object.defineProperty(exports, "readWholeFile", { enumerable: true, get: function () { return files_shared_1.readWholeFile; } });
+Object.defineProperty(exports, "saveWholeFile", { enumerable: true, get: function () { return files_shared_1.saveWholeFile; } });

package/dist/device-pairing/types.d.ts

@@ -1630,8 +1630,8 @@ export declare const devicePairingStateSchema: z.ZodObject<{
     code?: string | undefined;
     error?: string | undefined;
     role?: "source" | "destination" | undefined;
-    expiresAt?: number | undefined;
     sessionId?: string | undefined;
+    expiresAt?: number | undefined;
     remoteDevice?: {
         userName?: string | undefined;
         deviceName?: string | undefined;
@@ -1643,8 +1643,8 @@ export declare const devicePairingStateSchema: z.ZodObject<{
     code?: string | undefined;
     error?: string | undefined;
     role?: "source" | "destination" | undefined;
-    expiresAt?: number | undefined;
     sessionId?: string | undefined;
+    expiresAt?: number | undefined;
     remoteDevice?: {
         userName?: string | undefined;
         deviceName?: string | undefined;

package/dist/package-build/build-package.d.ts

@@ -15,6 +15,8 @@ export interface IPackageBuildResult {
     artifactPath: string;
     /** Size of the bundled provider source, in characters. */
     providerChars: number;
+    /** Things the build accepted but the author likely didn't mean ({@link fileFieldWarnings}). */
+    warnings: string[];
 }
 /** A running package watcher. Dispose it to stop watching and release esbuild. */
 export interface IPackageWatcher {
@@ -28,6 +30,15 @@ export interface IPackageWatcher {
  * @param entry - The module's path.
  */
 export declare function loadPackageModule(root: string, entry: string): Promise<unknown>;
+/**
+ * Warnings about table fields that look like file references but aren't: a top-level field
+ * named like a file id that isn't declared with `zodFileId`, and a `zodFileId` nested in an
+ * object field. Neither keeps its files, so Peers may free them. Internal to the build.
+ *
+ * @internal
+ * @param manifest - The package's manifest.
+ */
+export declare function fileFieldWarnings(manifest: IIsolatedPackageManifest): string[];
 /**
  * The generate-manifest step: write `dist/manifest.json` from the package's declarations.
  *
@@ -36,6 +47,7 @@ export declare function loadPackageModule(root: string, entry: string): Promise<
 export declare function generatePackageManifest(buildOptions?: IPackageBuildOptions): Promise<{
     manifest: IIsolatedPackageManifest;
     manifestPath: string;
+    warnings: string[];
 }>;
 /**
  * Build the package's manifest from its declarations, validated, without writing it or checking