@qaecy/cue-sdk 0.0.17 → 0.0.24

package/index.js

@@ -1,4 +1,4 @@
-import { C as s, a as u, b as C, c as i, d as t, e as c, f as o, g as r, h as l, i as n, j as P, k as j, l as m, m as S, n as g, o as h, R as p, p as R, q as f, s as E } from "./cue-yUoyoy61.js";
+import { C as s, a as u, b as C, c as i, d as t, e as c, f as o, g as r, h as l, i as n, j as P, k as j, l as m, m as S, n as g, o as h, R as p, p as R, q as f, s as E } from "./cue-ztX7FTFH.js";
 export {
   s as Cue,
   u as CueApi,

package/lib/cue.d.ts

@@ -35,6 +35,7 @@ export declare class Cue {
     protected _storageRaw: FirebaseStorage;
     protected _storageProcessed: FirebaseStorage;
     private _gis;
+    private readonly _projectDocuments;
     /**
      * Reactive GIS service. Lazily constructed on first access.
      *

package/lib/documents.d.ts

@@ -90,6 +90,16 @@ export declare class CueProjectDocuments {
      * ```
      */
     fetchDocumentData(uuids: string[]): Promise<Record<string, DocumentInfo>>;
+    /**
+     * Fetches a lightweight document metadata shape (id/path/suffix/size) for
+     * the given UUIDs and merges the results into `documentInfoMap`.
+     *
+     * This is useful for list/table contexts that do not need language-tagged
+     * fields (`subject`, `summary`) or category/tag enrichment.
+     *
+     * UUIDs already present in `documentInfoMap` are skipped.
+     */
+    fetchDocumentDataSimple(uuids: string[]): Promise<Record<string, DocumentInfo>>;
     /**
      * Returns the alternative representations of the given document UUID.
      *
@@ -115,6 +125,9 @@ export declare class CueProjectDocuments {
     /** Executes the document-info SPARQL query for the given UUIDs, merges results
      * into `documentInfoMap`, and returns the newly fetched entries. */
     private _fetchDocumentInfoBatch;
+    /** Executes a reduced document-info query (id/path/suffix/size only), merges
+     * into `documentInfoMap`, and returns newly fetched entries. */
+    private _fetchSimpleDocumentInfoBatch;
     private _fetchDocumentsBySuffix;
     private _buildDocumentsBySuffixQuery;
     private _runDocumentsBySuffixQuery;

package/lib/models.d.ts

@@ -376,6 +376,9 @@ export interface DocumentInfo {
     subject?: string;
     summary?: string;
     providerId?: string;
+    /** Full storage path in the processed bucket (e.g. `{projectId}/fragments/{uuid}.fragments`).
+     *  Only present on alternative representations that carry a `qcy:remoteRelativePath`. */
+    remoteRelativePath?: string;
 }
 /** Count + total size for a group of documents (e.g. grouped by suffix or category). */
 export interface DocumentSummary {

package/lib/storage.d.ts

@@ -1,4 +1,4 @@
-import { FirebaseStorage } from 'firebase/storage';
+import { CueBlobStorage } from 'js-databases';
 export type StorageBucket = 'raw' | 'processed';
 /**
  * Provides document download URL resolution against the Cue Firebase Storage buckets.
@@ -9,9 +9,8 @@ export type StorageBucket = 'raw' | 'processed';
  * ```
  */
 export declare class CueStorage {
-    private readonly _storageRaw;
-    private readonly _storageProcessed;
-    constructor(_storageRaw: FirebaseStorage, _storageProcessed: FirebaseStorage);
+    private readonly _blob;
+    constructor(_blob: CueBlobStorage);
     /**
      * Returns a Firebase authenticated download URL for a document stored in Cue.
      *
@@ -23,4 +22,15 @@ export declare class CueStorage {
      * @param bucket - `'raw'` (default, original uploads) or `'processed'` (derived artefacts).
      */
     getDownloadUrl(projectId: string, uuid: string, suffix: string, bucket?: StorageBucket): Promise<string>;
+    /**
+     * Returns a Firebase authenticated download URL for an alternative representation
+     * using its full `qcy:remoteRelativePath` stored in the processed bucket.
+     *
+     * Use this instead of `getDownloadUrl` when the document info was obtained via
+     * `fetchAlternativeRepresentations` and carries a `remoteRelativePath`.
+     *
+     * @param remoteRelativePath - The full path in the processed bucket,
+     *   e.g. `{projectId}/fragments/{uuid}.fragments`.
+     */
+    getAltRepDownloadUrl(remoteRelativePath: string): Promise<string>;
 }

package/node.js

@@ -1,5 +1,5 @@
-import { C as h, B as l, r as _, t as S, u as E, n as m, v as P, a as d } from "./cue-yUoyoy61.js";
-import { b as j, c as y, d as I, e as K, f as L, g as v, h as x, i as H, j as N, k as O, l as D, m as G, o as W, R as k, p as q, q as Q, s as V } from "./cue-yUoyoy61.js";
+import { C as h, B as l, r as _, t as S, u as E, n as m, v as P, a as d } from "./cue-ztX7FTFH.js";
+import { b as j, c as y, d as I, e as K, f as L, g as v, h as x, i as H, j as N, k as O, l as D, m as G, o as W, R as k, p as q, q as Q, s as V } from "./cue-ztX7FTFH.js";
 import { getStorage as e, connectStorageEmulator as b } from "firebase/storage";
 import "firebase/firestore";
 class A extends h {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qaecy/cue-sdk",
-  "version": "0.0.17",
+  "version": "0.0.24",
   "type": "module",
   "main": "./index.js",
   "types": "./index.d.ts",