@brass-build/client 0.1.0

package/dist/documents-namespace.js

@@ -0,0 +1,190 @@
+// SDK surface: `Brass.documents.*`. The metadata surface: get /
+// thumbnails / branches. The editable surface (snapshot + ops +
+// mutate) is the `Document` runtime class via `Brass.openDocumentById`
+// / `Brass.createDocument`. Access-granting is hosted-only (the share
+// dialog), not a programmatic method here.
+import { createApiFetch } from './api-fetch.js';
+import { BrassError } from './errors.js';
+export function createDocumentsNamespace(opts) {
+    const apiFetch = createApiFetch(opts);
+    return {
+        get(docId) {
+            return apiFetch({
+                path: `/documents/${encodeURIComponent(docId)}`,
+            });
+        },
+        listBranches(docId) {
+            return apiFetch({
+                path: `/documents/${encodeURIComponent(docId)}/branches`,
+            });
+        },
+        listStreams(docId, branchId) {
+            return apiFetch({
+                path: `/documents/${encodeURIComponent(docId)}/streams?branch=${encodeURIComponent(branchId)}`,
+            });
+        },
+        createStream(docId, branchId, name) {
+            return apiFetch({
+                method: 'POST',
+                path: `/documents/${encodeURIComponent(docId)}/streams`,
+                body: {
+                    name,
+                    branch_id: branchId,
+                },
+            });
+        },
+        createBranch(docId, input) {
+            const body = {};
+            if (input.from_version !== undefined) {
+                body.from_version = input.from_version;
+            }
+            if (input.from_branch_id !== undefined) {
+                body.from_branch_id = input.from_branch_id;
+            }
+            if (input.name !== undefined)
+                body.name = input.name;
+            return apiFetch({
+                method: 'POST',
+                path: `/documents/${encodeURIComponent(docId)}/branches`,
+                body,
+            });
+        },
+        async setThumbnail(doc, input) {
+            const docId = doc.id;
+            if (docId === null) {
+                throw new BrassError('setThumbnail requires a Document opened from the server', { status: 400 });
+            }
+            // Capture the depicted version synchronously, before the async
+            // encode, so a concurrent editor's op landing mid-upload cannot
+            // shift the anchor away from the state the app rendered.
+            const version = doc.currentSeq;
+            if (version === null) {
+                throw new BrassError('setThumbnail: the document has no resolved version yet', { status: 400 });
+            }
+            const branchId = doc.branchId;
+            const { data, contentType } = await encodeThumbnailImage(input);
+            const body = { content_type: contentType, data, version };
+            if (branchId !== null)
+                body.branch_id = branchId;
+            if (input.width !== undefined)
+                body.width = input.width;
+            if (input.height !== undefined)
+                body.height = input.height;
+            const res = await apiFetch({
+                method: 'POST',
+                path: `/documents/${encodeURIComponent(docId)}/thumbnail`,
+                body,
+            });
+            return res.thumbnail;
+        },
+        async createCheckpoint(doc) {
+            const docId = doc.id;
+            if (docId === null) {
+                throw new BrassError('createCheckpoint requires a Document opened from the server', { status: 400 });
+            }
+            // Capture the depicted version synchronously, so a concurrent
+            // editor's op landing mid-call cannot shift the anchor away
+            // from the state the user is on. Mirrors the setThumbnail
+            // version-capture pattern. This is the anchor the server pins
+            // the checkpoint to; it is not an app-facing "seal a past
+            // version" control.
+            const version = doc.currentSeq;
+            if (version === null) {
+                throw new BrassError('createCheckpoint: the document has no resolved version yet', { status: 400 });
+            }
+            const branchId = doc.branchId;
+            const body = { version };
+            if (branchId !== null)
+                body.branch_id = branchId;
+            const res = await apiFetch({
+                method: 'POST',
+                path: `/documents/${encodeURIComponent(docId)}/checkpoints`,
+                body,
+            });
+            return res.checkpoint;
+        },
+        async pushToDrive(doc, input) {
+            const docId = doc.id;
+            if (docId === null) {
+                throw new BrassError('pushToDrive requires a Document opened from the server', { status: 400 });
+            }
+            const body = {};
+            if (input?.message !== undefined)
+                body.message = input.message;
+            const res = await apiFetch({
+                method: 'POST',
+                path: `/documents/${encodeURIComponent(docId)}/drive-sync/push`,
+                body,
+            });
+            return res;
+        },
+        async sourceBlob(doc) {
+            const docId = doc.id;
+            if (docId === null) {
+                throw new BrassError('sourceBlob requires a Document opened from the server', { status: 400 });
+            }
+            return apiFetch({
+                path: `/documents/${encodeURIComponent(docId)}/source-blob`,
+            });
+        },
+        claimImport(docId) {
+            return apiFetch({
+                method: 'POST',
+                path: `/documents/${encodeURIComponent(docId)}/import-claim`,
+            });
+        },
+        completeImport(docId) {
+            return apiFetch({
+                method: 'POST',
+                path: `/documents/${encodeURIComponent(docId)}/import-complete`,
+            });
+        },
+        async getThumbnail(docId, options) {
+            const params = new URLSearchParams();
+            if (options?.version !== undefined) {
+                params.set('version', String(options.version));
+            }
+            if (options?.branch !== undefined)
+                params.set('branch', options.branch);
+            const qs = params.toString();
+            const res = await apiFetch({
+                path: `/documents/${encodeURIComponent(docId)}/thumbnail${qs ? `?${qs}` : ''}`,
+            });
+            return res.thumbnail;
+        },
+    };
+}
+// Reads `SetThumbnailInput.image` into base64 plus a resolved MIME
+// type. A `Blob` carries its own `type` (canvas `toBlob` sets it);
+// raw `ArrayBuffer` / `Uint8Array` bytes need an explicit
+// `contentType`.
+async function encodeThumbnailImage(input) {
+    let bytes;
+    let blobType;
+    if (input.image instanceof Uint8Array) {
+        bytes = input.image;
+    }
+    else if (input.image instanceof ArrayBuffer) {
+        bytes = new Uint8Array(input.image);
+    }
+    else {
+        bytes = new Uint8Array(await input.image.arrayBuffer());
+        blobType = input.image.type || undefined;
+    }
+    const contentType = input.contentType ?? blobType;
+    if (!contentType) {
+        throw new BrassError('setThumbnail: contentType is required when image is not a typed Blob', { status: 400 });
+    }
+    return { data: bytesToBase64(bytes), contentType };
+}
+// Standard-alphabet base64 of a byte array. Chunked so a large image
+// does not blow the argument-count limit on `String.fromCharCode`.
+function bytesToBase64(bytes) {
+    let binary = '';
+    const chunk = 0x8000;
+    for (let i = 0; i < bytes.length; i += chunk) {
+        binary += String.fromCharCode(...bytes.subarray(i, i + chunk));
+    }
+    return btoa(binary);
+}
+//# sourceMappingURL=documents-namespace.js.map

package/dist/documents-namespace.js.map

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

package/dist/documents.d.ts

@@ -0,0 +1,146 @@
+import { LoroDoc } from 'loro-crdt';
+import { type UndoControllerOptions } from './undo.js';
+import { type ListHandle, type MapHandle, type OrderedMapHandle } from './handles.js';
+import type { DocumentCheckpoint, DocumentSourceBlob, DocumentStreamInfo, PushToDriveInput, PushToDriveResult } from './documents-namespace.js';
+import type { DriveResolveResult } from './hosted-ui.js';
+import { type DocumentGoneListener, type DocumentGoneReason, type DocumentGoneUnsubscribe, type DocumentStatusListener, type DocumentStatusUnsubscribe, type DocumentWorkStatus, type DocumentDriveStatus, type DocumentDriveStatusListener, type DocumentDriveStatusUnsubscribe, type DocumentDriveTrackingState, type DriveMirrorDirection } from './document-signals.js';
+import { type CanvasSource } from './document-thumbnail-capture.js';
+import { type BranchProvider } from './document-branches.js';
+import { type Command, type CommandGroup, type CommandSurface, type HostedUiProvider } from './document-commands.js';
+import { DocumentStream } from './document-streams.js';
+export declare const DEFAULT_STREAM_NAME = "default";
+export type { BranchProvider };
+export type { Command, CommandGroup, CommandSurface, HostedUiProvider, };
+export type { CanvasSource };
+export type { DocumentGoneListener, DocumentGoneReason, DocumentGoneUnsubscribe, DocumentStatusListener, DocumentStatusUnsubscribe, DocumentWorkStatus, DocumentDriveStatus, DocumentDriveStatusListener, DocumentDriveStatusUnsubscribe, DocumentDriveTrackingState, DriveMirrorDirection, };
+export interface DocumentMutator<E extends object = EntityProxy> {
+    entities: Record<string, E>;
+}
+export type EntityProxy = Record<string, unknown>;
+export type DocumentSubscriber = (event: unknown) => void;
+export type DocumentUnsubscribe = () => void;
+export type SyntheticSubscribeEvent = {
+    kind: 'checkout';
+    version: number;
+} | {
+    kind: 'return-to-head';
+} | {
+    kind: 'branches';
+} | {
+    kind: 'saving-count';
+} | {
+    kind: 'commands';
+};
+export interface UndoState {
+    canUndo: boolean;
+    canRedo: boolean;
+}
+export type UndoStateSubscriber = (state: UndoState) => void;
+export interface DocumentOptions {
+    rootKey?: string;
+    docId?: string;
+    branchId?: string;
+    readOnly?: boolean;
+    version?: number;
+    undo?: UndoControllerOptions;
+}
+export declare class Document {
+    private readonly _doc;
+    private readonly _rootKey;
+    private readonly _docId;
+    private readonly _branchId;
+    private _checkout;
+    private _checkoutGeneration;
+    private readonly _isFrozen;
+    private readonly _forcedReadOnly;
+    private readonly _root;
+    private readonly _entities;
+    private _undo;
+    private readonly _subs;
+    private readonly _undoStateSubs;
+    private _lastCanUndo;
+    private _lastCanRedo;
+    private _unsubLoro;
+    private _unsubLocal;
+    private _localOpHook;
+    private _checkoutFetcher;
+    private _checkoutStreamSeqs;
+    private _currentSeqProvider;
+    private readonly _branchCtl;
+    private readonly _thumbnails;
+    private readonly _checkpoints;
+    private _drivePusher;
+    private _driveResolver;
+    private _sourceBlobFetcher;
+    private _name;
+    private _versionBrowsing;
+    private readonly _commandMenu;
+    private readonly _outstandingByClientId;
+    private readonly _resyncPushClientOpIds;
+    private _errorReporter;
+    private _closed;
+    private _suspended;
+    private get _isLive();
+    private _assertOpen;
+    private readonly _gone;
+    private readonly _workStatus;
+    private readonly _driveStatus;
+    presence: import('./presence.js').PresenceClient | null;
+    constructor(loroDoc: LoroDoc, options?: DocumentOptions);
+    private readonly _rootHandles;
+    map<T = unknown>(key: string): MapHandle<T>;
+    list<T = unknown>(key: string): ListHandle<T>;
+    private readonly _orderedMapHandles;
+    orderedMap<T = unknown>(mapKey: string, orderKey: string): OrderedMapHandle<T>;
+    private _handleOwnerCache;
+    private get _handleOwner();
+    get id(): string | null;
+    get readOnly(): boolean;
+    private _isLoadLocked;
+    undo(): boolean;
+    redo(): boolean;
+    private canUndo;
+    private canRedo;
+    mutate<E extends object = EntityProxy>(fn: (d: DocumentMutator<E>) => void): void;
+    private _checkoutOpenStreams;
+    private _rebindRootHandles;
+    useCanvas(source: CanvasSource): () => void;
+    pushToDrive(input?: PushToDriveInput): Promise<PushToDriveResult>;
+    resolveDrive(): Promise<DriveResolveResult | null>;
+    sourceBlob(): Promise<DocumentSourceBlob>;
+    private _streamRuntime;
+    private _streamManifest;
+    private readonly _streamOpens;
+    private _ownStream;
+    private _openedStreamName;
+    /** The stream this Document's own handles read. */
+    get openedStream(): string;
+    stream(name: string): Promise<DocumentStream>;
+    getOrCreateStream(name: string): Promise<DocumentStream>;
+    listStreams(): Promise<DocumentStreamInfo[]>;
+    private _resolveStreamInfo;
+    private _closeStreams;
+    createCheckpoint(): Promise<DocumentCheckpoint>;
+    setAutoCheckpointIntervalMs(intervalMs: number): number;
+    get name(): string | null;
+    get commands(): readonly Command[];
+    run(commandId: string): Promise<void>;
+    private _reportError;
+    private _fireSubscribers;
+    get savingCount(): number;
+    private _ensureLocalUpdatesSubscribed;
+    private _ensureLoroSubscribed;
+    subscribe(cb: DocumentSubscriber): DocumentUnsubscribe;
+    subscribeUndoState(cb: UndoStateSubscriber): DocumentUnsubscribe;
+    private _maybeFireUndoState;
+    onGone(cb: DocumentGoneListener): DocumentGoneUnsubscribe;
+    get status(): DocumentWorkStatus | null;
+    onStatus(cb: DocumentStatusListener): DocumentStatusUnsubscribe;
+    get driveStatus(): DocumentDriveStatus | null;
+    onDriveStatus(cb: DocumentDriveStatusListener): DocumentDriveStatusUnsubscribe;
+    toJSON(): Record<string, unknown>;
+    private missingRanges;
+    private chunkMissingSlice;
+    close(): void;
+}
+//# sourceMappingURL=documents.d.ts.map

package/dist/documents.d.ts.map

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