@dreamlake/dreamdb 0.5.1 → 0.5.3

package/browser/dreamdb_bg.wasm.d.ts

@@ -1,6 +1,7 @@
 /* tslint:disable */
 /* eslint-disable */
 export const memory: WebAssembly.Memory;
+export const __wbg_geometryreader_free: (a: number, b: number) => void;
 export const __wbg_s3backend_free: (a: number, b: number) => void;
 export const __wbg_space_free: (a: number, b: number) => void;
 export const __wbg_writer_free: (a: number, b: number) => void;
@@ -9,38 +10,70 @@ export const addressVariant: (a: number, b: number) => [number, number, number,
 export const bytesToBase32: (a: number, b: number) => [number, number];
 export const decodeCbor: (a: number, b: number) => [number, number, number];
 export const encodeCbor: (a: any) => [number, number, number, number];
+export const geometryreader_extendCellPrefix: (a: number, b: any, c: any) => any;
+export const geometryreader_metadata: (a: number) => [number, number, number];
+export const geometryreader_readMeshLod: (a: number, b: any) => any;
+export const geometryreader_selectCells: (a: number, b: any, c: any) => [number, number, number];
 export const modalityParse: (a: number, b: number) => [number, number, number];
 export const multihashBase32: (a: number, b: number) => [number, number];
 export const multihashHex: (a: number, b: number) => [number, number];
 export const rangeHeader: (a: bigint, b: bigint) => [number, number, number, number];
 export const s3backend_get: (a: number, b: number, c: number, d: any) => any;
+export const s3backend_getStream: (a: number, b: number, c: number) => any;
 export const s3backend_list: (a: number, b: number, c: number) => any;
 export const s3backend_new: (a: number, b: number) => number;
+export const space_auditArrayField: (a: number, b: number, c: number) => any;
+export const space_auditGraphIndex: (a: number, b: number, c: number) => any;
 export const space_connectorBase: (a: number) => [number, number];
+export const space_description: (a: number) => any;
 export const space_fromUri: (a: number, b: number, c: any) => any;
+export const space_getEntity: (a: number, b: any) => any;
 export const space_history: (a: number, b: number) => any;
 export const space_manifestHash: (a: number) => [number, number];
+export const space_openGeometryItem: (a: number, b: number, c: number, d: any) => any;
 export const space_queryHybrid: (a: number, b: number, c: number, d: any) => any;
+export const space_queryHybridPlanned: (a: number, b: number, c: number, d: any) => any;
 export const space_queryScalar: (a: number, b: number, c: number, d: number, e: number, f: any) => any;
 export const space_queryText: (a: number, b: number, c: number, d: number, e: number, f: number) => any;
 export const space_queryVector: (a: number, b: number, c: number, d: number, e: number, f: any) => any;
+export const space_readArrayColumn: (a: number, b: number, c: number) => any;
+export const space_readArrayConstant: (a: number, b: number, c: number) => any;
+export const space_readArrayItem: (a: number, b: number, c: number, d: any) => any;
 export const space_readScalarColumn: (a: number, b: any, c: any) => any;
+export const space_readVideoItemRange: (a: number, b: number, c: number, d: any, e: any, f: any) => any;
 export const space_resolveObjectIndex: (a: number, b: any) => any;
+export const space_semanticCacheCapacity: (a: number) => any;
+export const space_semanticCacheStats: (a: number) => any;
+export const space_setSemanticCacheCapacity: (a: number, b: number) => any;
 export const space_timelineId: (a: number) => [number, number, number, number];
-export const space_trackFor: (a: number, b: number, c: number) => any;
-export const space_tracks: (a: number) => any;
+export const space_trackFor: (a: number, b: number, c: number) => [number, number, number];
+export const space_tracks: (a: number) => [number, number, number];
+export const space_videoItemAt: (a: number, b: number, c: number, d: any) => any;
+export const space_videoItemByKey: (a: number, b: number, c: number, d: any) => any;
 export const spatialKeyRoundTrip: (a: number, b: number) => [number, number, number, number];
 export const timeAnchorFromHex: (a: number, b: number) => [bigint, number, number];
 export const timeAnchorHex: (a: bigint) => [number, number];
 export const timeBucket: (a: bigint, b: number, c: number) => [bigint, number, number];
+export const typedArrayDecode: (a: any, b: number, c: number) => [number, number, number];
 export const version: () => [number, number];
+export const writer_appendHot: (a: number, b: any, c: number) => any;
 export const writer_appendMany: (a: number, b: any) => any;
+export const writer_appendManyWithSpecs: (a: number, b: any, c: any) => any;
 export const writer_commit: (a: number) => any;
+export const writer_configureHotShard: (a: number, b: number, c: number) => [number, number];
+export const writer_createEntity: (a: number, b: any, c: any, d: number) => any;
+export const writer_deleteEntity: (a: number, b: any, c: any) => any;
 export const writer_deleteRecords: (a: number, b: number, c: number, d: number, e: number) => any;
+export const writer_enableEntityKeys: (a: number, b: number, c: number) => any;
+export const writer_flushHot: (a: number) => any;
 export const writer_manifestHash: (a: number) => [number, number, number, number];
 export const writer_open: (a: number, b: number, c: any) => any;
+export const writer_publishGeometryCells: (a: number, b: number, c: number, d: any, e: any, f: any, g: any) => any;
+export const writer_publishGeometryMesh: (a: number, b: number, c: number, d: any, e: any, f: any) => any;
 export const writer_refName: (a: number) => [number, number];
 export const writer_snapshot: (a: number, b: number, c: number) => any;
+export const writer_supersedeEntity: (a: number, b: any, c: any, d: any, e: number) => any;
+export const writer_upsertEntity: (a: number, b: any, c: any, d: number, e: number) => any;
 export const zeroSpatialKey: () => [number, number];
 export const __wasm_init: () => void;
 export const wasm_bindgen_f7c54996eb9137d9___convert__closures_____invoke___wasm_bindgen_f7c54996eb9137d9___JsValue__core_7d5f0a2ba6a62c33___result__Result_____wasm_bindgen_f7c54996eb9137d9___JsError___true_: (a: number, b: number, c: any) => [number, number];

package/browser-extras.mjs

@@ -37,6 +37,42 @@ class AuthoringUnavailable {
 
 export { AuthoringUnavailable as Authoring }
 
+/**
+ * `Writer.ingestCmaf` is Node-only, for the same reason `Authoring` is: it is
+ * gated behind the `write-full` feature, and the browser build is compiled
+ * with `write`.
+ *
+ * The shared declarations describe it on both ends (see build.sh, "types"), so
+ * a browser caller type-checks and would otherwise reach
+ * `writer.ingestCmaf is not a function` at runtime — a message that names
+ * neither the cause nor the fix. This replaces it with one that does.
+ *
+ * Applied to the prototype rather than declared as a method because `Writer`
+ * comes from the wasm module; there is no class here to extend.
+ */
+function installIngestCmafStub(Writer) {
+  if (!Writer || typeof Writer !== 'function') return Writer
+  if (typeof Writer.prototype.ingestCmaf === 'function') return Writer // full build
+  Object.defineProperty(Writer.prototype, 'ingestCmaf', {
+    configurable: true,
+    writable: true,
+    value: async function ingestCmaf() {
+      throw new Error(
+        'Writer.ingestCmaf is not available in the browser build of ' +
+          '@dreamlake/dreamdb. CMAF ingest takes the whole clip as one ' +
+          'argument, so peak memory is the entire source — and fragmenting a ' +
+          'multi-GB file inside a tab\'s 32-bit address space is not a ' +
+          'workflow this package pretends to support. Run it under Node (the ' +
+          '"node" export condition resolves to the full build), or fragment ' +
+          'ahead of time and append the fragments.',
+      )
+    },
+  })
+  return Writer
+}
+
+export { installIngestCmafStub }
+
 /**
  * A Backend (contract v2) that gets bytes over plain `fetch` and writes through
  * short-lived presigned URLs minted by *your* server.
@@ -86,7 +122,7 @@ export class PresignedBackend {
    * @param {object} o
    * @param {string} o.readBase                 Base URL for reads.
    * @param {(paths: string[], opts?: {ifMatch?: string}) => Promise<Record<string, {url: string, headers?: Record<string,string>}>>} o.mintPut
-   * @param {(path: string, opts: {ifMatch?: string, ifNoneMatchStar?: boolean}, bytes: Uint8Array) => Promise<{status: string, etag?: string}>} [o.commitRef]
+   * @param {(path: string, opts: {ifMatch?: string, ifNoneMatchStar?: boolean}, bytes: Uint8Array) => Promise<{outcome?: string, status?: string, etag?: string}>} [o.commitRef]
    *        Server-side ref commit. Used when `refStrategy` is `'proxy'`.
    * @param {'proxy'|'presign'} [o.refStrategy='proxy']
    *        How the 33-byte ref object is written. `'proxy'` posts it to your
@@ -119,15 +155,27 @@ export class PresignedBackend {
     return this._readUrl ? this._readUrl(path) : `${this.readBase}/${path}`
   }
 
-  /** v2 get: returns `{bytes, etag}`. Range is inclusive of `end`. */
+  /** v2 get: returns `{bytes, etag, totalLength}`. Range is half-open `[start, end)`. */
   async get(path, range) {
     const headers = {}
-    if (range) headers.range = `bytes=${range.start}-${range.end}`
+    if (range) {
+      if (!Number.isSafeInteger(range.start) || !Number.isSafeInteger(range.end) ||
+          range.start < 0 || range.end <= range.start) {
+        throw new Error(`GET ${path}: invalid half-open range [${range.start}, ${range.end})`)
+      }
+      // HTTP uses an inclusive end; the Backend contract uses an exclusive one.
+      headers.range = `bytes=${range.start}-${range.end - 1}`
+    }
     const r = await fetch(this.#url(path), { headers })
     if (!r.ok) throw new Error(`GET ${path}: ${r.status} ${r.statusText}`)
+    const contentRange = r.headers.get('content-range')
+    const rangeTotal = contentRange && /^bytes \d+-\d+\/(\d+)$/.exec(contentRange)?.[1]
+    const lengthText = range ? rangeTotal : r.headers.get('content-length')
+    const totalLength = lengthText == null ? undefined : Number(lengthText)
     return {
       bytes: new Uint8Array(await r.arrayBuffer()),
       etag: normalizeEtag(r.headers.get('etag')),
+      totalLength: Number.isSafeInteger(totalLength) && totalLength >= 0 ? totalLength : undefined,
     }
   }
 
@@ -148,7 +196,12 @@ export class PresignedBackend {
     // semantics differ per provider — so they get their own path.
     const isRef = path.startsWith('refs/')
     if (isRef && this.refStrategy === 'proxy') {
-      return await this.commitRef(path, opts, bytes)
+      // `commitRef` is the CALLER's callback and its documented contract is the
+      // `{status}` string form, so it is normalised here rather than being
+      // broken. This is the ref path — the one where mistaking a refused CAS
+      // for a successful one loses a write — so it does not rely on the
+      // adapter's compatibility handling.
+      return normalizePutResult(await this.commitRef(path, opts, bytes), path)
     }
 
     const minted = await this.mintPut([path], opts.ifMatch ? { ifMatch: opts.ifMatch } : undefined)
@@ -167,11 +220,11 @@ export class PresignedBackend {
     // someone else moved it, which is a conflict the caller must resolve.
     if (r.status === 412 || r.status === 409) {
       return opts.ifNoneMatchStar
-        ? { status: 'exists' }
-        : { status: 'casFailed', etag: normalizeEtag(r.headers.get('etag')) }
+        ? { outcome: 'alreadyExists' }
+        : { outcome: 'casFailed', etag: normalizeEtag(r.headers.get('etag')) }
     }
     if (!r.ok) throw new Error(`PUT ${path}: ${r.status} ${r.statusText}`)
-    return { status: 'created', etag: normalizeEtag(r.headers.get('etag')) }
+    return { outcome: 'created', etag: normalizeEtag(r.headers.get('etag')) }
   }
 
   // No `delete`. It would need a signed DELETE URL, and the sign endpoint only
@@ -181,6 +234,28 @@ export class PresignedBackend {
   // dropping a ref is an `Authoring` operation, which is Node-only.
 }
 
+/**
+ * Normalise a caller-supplied put result into the tagged form.
+ *
+ * Accepts the documented `{status: 'created'|'exists'|'casFailed'}` and the
+ * tagged `{outcome}`; anything else is refused by name rather than silently
+ * treated as success, because the one thing a ref write must never do is report
+ * a refused CAS as a completed one.
+ */
+function normalizePutResult(r, path) {
+  if (r && typeof r.outcome === 'string') return r
+  const s = r && r.status
+  if (s === 'created') return { outcome: 'created', etag: r.etag }
+  if (s === 'exists' || s === 'alreadyExists') return { outcome: 'alreadyExists', etag: r.etag }
+  if (s === 'casFailed') return { outcome: 'casFailed', etag: r.etag }
+  if (s === 'notFound') return { outcome: 'notFound' }
+  if (typeof s === 'number') return r
+  throw new Error(
+    `commitRef(${path}) resolved an unrecognised result; expected ` +
+      `{outcome} or {status: 'created'|'exists'|'casFailed'}, got ${JSON.stringify(r)}`,
+  )
+}
+
 /**
  * S3 quotes ETags and sometimes suffixes them (`W/"…"`, `"…-3"` for multipart).
  * The conditional-write comparison is byte-exact, so a stray quote turns every

package/browser.mjs

@@ -2,3 +2,10 @@
 // module and instantiated by the bundler; there is nothing to await.
 export * from './browser/dreamdb.js'
 export { ZERO_SPATIAL_KEY, PresignedBackend, Authoring } from './browser-extras.mjs'
+
+// `ingestCmaf` is behind `write-full`, so it is absent here while the shared
+// declarations describe it. Replace the bare `is not a function` with a
+// message that names the reason and the fix.
+import { Writer as _W } from './browser/dreamdb.js'
+import { installIngestCmafStub as _stub } from './browser-extras.mjs'
+_stub(_W)