@brass-build/client 0.4.0 → 0.5.0

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -10,6 +10,7 @@ import { BrassClient } from './client.js';
 export { BrassError } from './errors.js';
 export {} from './hosted-ui.js';
 export {} from './documents-namespace.js';
+export {} from './read-only-document.js';
 export {} from './session.js';
 export { Document, } from './documents.js';
 export { DocumentStream } from './document-streams.js';
@@ -74,7 +75,7 @@ export const Brass = {
         return client.connectService(host);
     },
     // Metadata read for a known id (`get`) plus thumbnails. Create / move /
-    // list / grant access are hosted-only.
+    // grant access are hosted-only.
     get documents() {
         return client.documents;
     },
@@ -125,17 +126,33 @@ export const Brass = {
     mountVersionPreview(container) {
         return client.mountVersionPreview(container);
     },
+    /** @deprecated Use `Brass.session.open()` with no id. */
     selectDocument() {
         return client.selectDocument();
     },
+    // Files, folders and projects as references, or `null` when the person
+    // closes the picker. A folder or project reference keeps including what is
+    // filed there later: record the references with `doc.dependsOn`, and the
+    // key's status lists the files they include. Rejects with
+    // `iframe_unavailable` where the browser blocks the picker.
+    chooseInputs(families, options) {
+        return client.chooseInputs(families, options);
+    },
+    // One file as a reference, such as a standard a model is checked against.
+    // Resolves with that reference, or `null` when the person closes the
+    // picker; keep the reference you already have on `null`. Rejects with
+    // `iframe_unavailable` where the browser blocks the picker.
+    chooseInput(families, options) {
+        return client.chooseInput(families, options);
+    },
     // Opens the hosted multi-tier share dialog (document / project /
     // organization in one UI) focused on the given document.
     shareDocument(docId) {
         return client.shareDocument(docId);
     },
-    openDocumentById(docId, options) {
-        return client.openDocumentById(docId, options);
-    },
+    // `readOnly: true` opens a live copy with nothing on it that writes
+    // (`ReadOnlyDocument`).
+    openDocumentById: ((docId, options) => client.openDocumentById(docId, options)),
     // `true` when the page was opened as an anonymous link guest
     // (`?brass_link=`): no signed-in user, a read-only document. Apps render
     // their working surface for a guest as they do for a signed-in user (the
@@ -153,10 +170,9 @@ export const Brass = {
     registerSerializer(serializer) {
         client.registerSerializer(serializer);
     },
-    // Register the app's import backend: parses a stored source file into
-    // the document's records. Brass runs it when a document's file needs
-    // importing; the records reach every open client live. Call once at
-    // boot beside `registerSerializer`.
+    // Register the app's import backend: given a document's stored files, it
+    // returns the document's content. Brass seals what it returns as the
+    // document's first content. Call once at boot beside `registerSerializer`.
     registerImporter(importer) {
         client.registerImporter(importer);
     },

package/dist/index.js.map

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

package/dist/init-keys.d.ts

@@ -1,3 +1,3 @@
-export declare const BRASS_INIT_ARG_KEYS: readonly ["app_id", "auth_base_url", "api_base_url", "ws_base_url"];
+export declare const BRASS_INIT_ARG_KEYS: readonly ["app_id", "auth_base_url", "api_base_url", "ws_base_url", "dashboard_base_url"];
 export type BrassInitArgKey = (typeof BRASS_INIT_ARG_KEYS)[number];
 //# sourceMappingURL=init-keys.d.ts.map

package/dist/init-keys.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init-keys.d.ts","sourceRoot":"","sources":["../src/init-keys.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,mBAAmB,qEAKtB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC"}
+{"version":3,"file":"init-keys.d.ts","sourceRoot":"","sources":["../src/init-keys.ts"],"names":[],"mappings":"AAWA,eAAO,MAAM,mBAAmB,2FAMtB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/init-keys.js

@@ -3,11 +3,16 @@
 // add the key here first.
 // Keys used in the prompt block the dashboard renders. The `app_id`
 // line carries the app-specific id; the URL lines carry the env's
-// auth / data / WS origins.
+// auth / data / WS / dashboard origins.
+//
+// Every origin `Brass.init` takes belongs here: each falls back to its own
+// default independently, so a prompt naming a subset leaves the rest on
+// theirs.
 export const BRASS_INIT_ARG_KEYS = [
     'app_id',
     'auth_base_url',
     'api_base_url',
     'ws_base_url',
+    'dashboard_base_url',
 ];
 //# sourceMappingURL=init-keys.js.map

package/dist/init-keys.js.map

@@ -1 +1 @@
-{"version":3,"file":"init-keys.js","sourceRoot":"","sources":["../src/init-keys.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,oEAAoE;AACpE,0BAA0B;AAE1B,oEAAoE;AACpE,kEAAkE;AAClE,4BAA4B;AAC5B,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,QAAQ;IACR,eAAe;IACf,cAAc;IACd,aAAa;CACL,CAAC"}
+{"version":3,"file":"init-keys.js","sourceRoot":"","sources":["../src/init-keys.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,oEAAoE;AACpE,0BAA0B;AAE1B,oEAAoE;AACpE,kEAAkE;AAClE,wCAAwC;AACxC,EAAE;AACF,2EAA2E;AAC3E,wEAAwE;AACxE,UAAU;AACV,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,QAAQ;IACR,eAAe;IACf,cAAc;IACd,aAAa;IACb,oBAAoB;CACZ,CAAC"}

package/dist/input-documents.d.ts

@@ -0,0 +1,67 @@
+import type { InputReference } from './hosted-ui.js';
+import type { InputStatus } from './inputs-status.js';
+import type { OpenDocumentByIdOptions, OpenedDocument } from './open-document.js';
+import type { OpenModeOptions, ReadOnlyDocument } from './read-only-document.js';
+/** `input.open`, typed by what the open asks for, as `Brass.openDocumentById` is. */
+export interface InputDocumentOpen {
+    (options: OpenDocumentByIdOptions & {
+        frozen: true;
+        readOnly?: true;
+    }): Promise<ReadOnlyDocument>;
+    (options: OpenDocumentByIdOptions & {
+        readOnly: true;
+    }): Promise<ReadOnlyDocument>;
+    (options?: OpenDocumentByIdOptions & {
+        frozen?: false;
+    }): Promise<OpenedDocument>;
+    (options: Omit<OpenDocumentByIdOptions, 'frozen' | 'readOnly'> & OpenModeOptions): Promise<OpenedDocument | ReadOnlyDocument>;
+}
+/** An input document for the app to work on. */
+export interface InputDocument {
+    readonly doc_id: string;
+    readonly name: string;
+    /** The input's family, absent on a document that has none. */
+    readonly family?: string;
+    /** The version of the input this call is for. */
+    readonly updated_at: string;
+    /** The key's references that include this input, nearest first. */
+    readonly from: InputReference[];
+    /** Opens the input, or returns the document already opened with the same
+     *  options (a frozen one loaded at this version). Opening with other options
+     *  closes that one. What `open` returns closes when the handler resolves,
+     *  unless the app passed `keepDocumentsOpen`. */
+    readonly open: InputDocumentOpen;
+    /** Closes what `open` returned for this input. */
+    close(): void;
+}
+/** What `subscribeInputDocuments` calls. */
+export interface InputDocumentHandlers {
+    /** Every input each time the app subscribes, then each new version,
+     *  wherever the document is open. Records nothing. */
+    loaded?(input: InputDocument): void | Promise<void>;
+    /** Each input added or edited since this document last read it, where the
+     *  document can be edited. Brass records the input as read when the
+     *  handler resolves. */
+    changed?(input: InputDocument): void | Promise<void>;
+    /** Each input no longer among the key's inputs, or deleted: one `loaded`
+     *  was given, wherever the document is open, and one this document read
+     *  before, where it can be edited. */
+    removed?(docId: string): void | Promise<void>;
+    /** The key's status, whenever it changes or its `settled` flips. */
+    status?(status: InputStatus): void;
+    /** Once every known input's handler has finished for its current
+     *  version, resolved or rejected, and the inputs have stopped changing:
+     *  after the first load, and after each later batch
+     *  of additions, edits or removals. */
+    settled?(status: InputStatus): void;
+}
+/** How `subscribeInputDocuments` runs the handlers. */
+export interface InputDocumentOptions {
+    /** Keep each document `open` returns until its input is removed,
+     *  `input.close()` is called, or the app unsubscribes. The next `open` of
+     *  the input returns the same document. */
+    readonly keepDocumentsOpen?: boolean;
+    /** The most handlers that run at once. Brass paces them by default. */
+    readonly concurrency?: number;
+}
+//# sourceMappingURL=input-documents.d.ts.map

package/dist/input-documents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-documents.d.ts","sourceRoot":"","sources":["../src/input-documents.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAIrD,OAAO,KAAK,EAAE,WAAW,EAAqB,MAAM,oBAAoB,CAAC;AACzE,OAAO,KAAK,EAAE,uBAAuB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAClF,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAGjF,qFAAqF;AACrF,MAAM,WAAW,iBAAiB;IAChC,CAAC,OAAO,EAAE,uBAAuB,GAAG;QAAE,MAAM,EAAE,IAAI,CAAC;QAAC,QAAQ,CAAC,EAAE,IAAI,CAAA;KAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAClG,CAAC,OAAO,EAAE,uBAAuB,GAAG;QAAE,QAAQ,EAAE,IAAI,CAAA;KAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACnF,CAAC,OAAO,CAAC,EAAE,uBAAuB,GAAG;QAAE,MAAM,CAAC,EAAE,KAAK,CAAA;KAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAClF,CACE,OAAO,EAAE,IAAI,CAAC,uBAAuB,EAAE,QAAQ,GAAG,UAAU,CAAC,GAAG,eAAe,GAC9E,OAAO,CAAC,cAAc,GAAG,gBAAgB,CAAC,CAAC;CAC/C;AAED,gDAAgD;AAChD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8DAA8D;IAC9D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,iDAAiD;IACjD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,mEAAmE;IACnE,QAAQ,CAAC,IAAI,EAAE,cAAc,EAAE,CAAC;IAChC;;;qDAGiD;IACjD,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,kDAAkD;IAClD,KAAK,IAAI,IAAI,CAAC;CACf;AAED,4CAA4C;AAC5C,MAAM,WAAW,qBAAqB;IACpC;0DACsD;IACtD,MAAM,CAAC,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD;;4BAEwB;IACxB,OAAO,CAAC,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD;;0CAEsC;IACtC,OAAO,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,oEAAoE;IACpE,MAAM,CAAC,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IACnC;;;2CAGuC;IACvC,OAAO,CAAC,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;CACrC;AAED,uDAAuD;AACvD,MAAM,WAAW,oBAAoB;IACnC;;+CAE2C;IAC3C,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IACrC,uEAAuE;IACvE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B"}