@nodetool-ai/websocket 0.8.3 → 0.8.4-a24.1

package/dist/lib/project-archive-host.js

@@ -0,0 +1,24 @@
+/**
+ * The storage this install's project files read from and write to. The HTTP
+ * routes and the `nodetool projects` CLI commands share it, so a file
+ * exported by one imports through the other.
+ */
+import { getAssetFileName, getAssetStorageKey, getAssetThumbnailKey } from "./asset-paths.js";
+import { getAssetAdapter } from "./storage.js";
+import { storeAssetWithThumbnail } from "./thumbnail.js";
+import { workspaceFromRow } from "./workflow-workspace.js";
+export function projectArchiveHost() {
+    return {
+        storage: getAssetAdapter(),
+        openWorkspace: workspaceFromRow,
+        removeAssetBytes: async (userId, assetId, contentType) => {
+            const storage = getAssetAdapter();
+            await Promise.all([
+                storage.delete(storage.uriForKey(getAssetStorageKey(userId, assetId, contentType))),
+                storage.delete(storage.uriForKey(getAssetThumbnailKey(userId, assetId)))
+            ]);
+        },
+        storeAssetBytes: ({ userId, assetId, contentType, bytes }) => storeAssetWithThumbnail(userId, assetId, getAssetFileName(assetId, contentType), bytes, contentType)
+    };
+}
+//# sourceMappingURL=project-archive-host.js.map

package/dist/lib/project-archive-host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-archive-host.js","sourceRoot":"","sources":["../../src/lib/project-archive-host.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAE9F,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,MAAM,UAAU,kBAAkB;IAWhC,OAAO;QACL,OAAO,EAAE,eAAe,EAAE;QAC1B,aAAa,EAAE,gBAAgB;QAC/B,gBAAgB,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE;YACvD,MAAM,OAAO,GAAG,eAAe,EAAE,CAAC;YAClC,MAAM,OAAO,CAAC,GAAG,CAAC;gBAChB,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,kBAAkB,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC;gBACnF,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,oBAAoB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;aACzE,CAAC,CAAC;QACL,CAAC;QACD,eAAe,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,EAAE,EAAE,CAC3D,uBAAuB,CACrB,MAAM,EACN,OAAO,EACP,gBAAgB,CAAC,OAAO,EAAE,WAAW,CAAC,EACtC,KAAK,EACL,WAAW,CACZ;KACJ,CAAC;AACJ,CAAC"}

package/dist/lib/project-archive.d.ts

@@ -0,0 +1,103 @@
+import { z } from "zod";
+import { Project, Workspace } from "@nodetool-ai/models";
+import type { Workspace as RuntimeWorkspace } from "@nodetool-ai/runtime";
+import type { StorageAdapter } from "@nodetool-ai/storage";
+import { type ZipStreamWriter } from "./zip-stream.js";
+export declare const PROJECT_ARCHIVE_FORMAT = "nodetool-project";
+export declare const PROJECT_ARCHIVE_VERSION = 1;
+export declare const PROJECT_ARCHIVE_EXTENSION = ".nodetool-project";
+/** Largest project file an import inflates, summed over its entries. */
+export declare const MAX_PROJECT_ARCHIVE_BYTES: number;
+/** Most entries a project file may hold. */
+export declare const MAX_PROJECT_ARCHIVE_ENTRIES = 100000;
+declare const manifestSchema: z.ZodObject<{
+    format: z.ZodLiteral<"nodetool-project">;
+    version: z.ZodNumber;
+    nodetool_version: z.ZodOptional<z.ZodString>;
+    created_at: z.ZodString;
+    project: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        kind: z.ZodString;
+        thread_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>;
+    counts: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    assets: z.ZodArray<z.ZodObject<{
+        file: z.ZodString;
+        bytes: z.ZodNumber;
+        sha256: z.ZodString;
+        id: z.ZodString;
+    }, z.core.$strip>>;
+    workspace_files: z.ZodArray<z.ZodObject<{
+        file: z.ZodString;
+        bytes: z.ZodNumber;
+        sha256: z.ZodString;
+        workspace_id: z.ZodString;
+        path: z.ZodString;
+    }, z.core.$strip>>;
+    skipped: z.ZodArray<z.ZodObject<{
+        kind: z.ZodString;
+        id: z.ZodString;
+        reason: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ProjectArchiveManifest = z.infer<typeof manifestSchema>;
+/** Opens a workspace row for reading or writing its files. */
+export type OpenWorkspace = (row: Workspace) => RuntimeWorkspace | null;
+export interface WriteProjectArchiveOptions {
+    readonly userId: string;
+    readonly projectId: string;
+    readonly storage: StorageAdapter;
+    readonly openWorkspace: OpenWorkspace;
+    readonly nodetoolVersion?: string;
+    /** Aggregate decompressed limit, shared with the importer. */
+    readonly maxBytes?: number;
+}
+/**
+ * Write a project to `writer`. The caller has checked that `userId` owns the
+ * project. Returns the manifest that was written.
+ */
+export declare function writeProjectArchive(options: WriteProjectArchiveOptions, writer: ZipStreamWriter): Promise<ProjectArchiveManifest>;
+export interface ImportProjectArchiveOptions {
+    readonly userId: string;
+    /** The new project's name. Defaults to the name in the file. */
+    readonly name?: string | undefined;
+    readonly storage: StorageAdapter;
+    readonly openWorkspace: OpenWorkspace;
+    /** Where a new workspace keeps its files. Defaults to a managed folder. */
+    readonly workspacePath?: (userId: string, workspaceId: string) => Promise<string>;
+    /**
+     * Stores one asset's bytes. Defaults to writing them under the asset's
+     * storage key in `storage`; the server also renders a thumbnail.
+     */
+    readonly storeAssetBytes?: (args: {
+        userId: string;
+        assetId: string;
+        contentType: string;
+        bytes: Uint8Array;
+    }) => Promise<void>;
+    /** Removes every object created by the asset hook, including thumbnails. */
+    readonly removeAssetBytes?: (userId: string, assetId: string, contentType: string) => Promise<void>;
+    readonly maxBytes?: number;
+}
+export interface ImportProjectArchiveResult {
+    readonly project: Project;
+    readonly counts: Record<string, number>;
+    /** Files the manifest lists that the archive does not carry. */
+    readonly missing: string[];
+    /** Files whose bytes do not match the manifest checksum. */
+    readonly checksumMismatches: string[];
+    /** What the exporting install could not include, from the manifest. */
+    readonly skipped: ProjectArchiveManifest["skipped"];
+}
+export declare class ProjectArchiveError extends Error {
+    constructor(message: string);
+}
+/** A managed folder for an imported workspace, the shape `isManaged` accepts. */
+export declare function managedImportWorkspacePath(userId: string, workspaceId: string): Promise<string>;
+/** Reads a project file's manifest without importing it. */
+export declare function readProjectArchiveManifest(zipBytes: Uint8Array): ProjectArchiveManifest;
+/** Import a project file as a new project owned by `userId`. */
+export declare function importProjectArchive(zipBytes: Uint8Array, options: ImportProjectArchiveOptions): Promise<ImportProjectArchiveResult>;
+export {};
+//# sourceMappingURL=project-archive.d.ts.map

package/dist/lib/project-archive.d.ts.map

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