@qaecy/cue-sdk 0.0.53 → 0.0.54

package/index.js

@@ -1,4 +1,4 @@
-import { B as C, C as u, a as i, b as r, c as o, d as t, e as S, f as n, g as c, h as E, i as m, j as p, k as A, l, m as P, n as R, o as _, p as I, q as d, r as g, s as T, t as D, u as O, v as N, w as U, x as G, y as h, z as f, A as j, D as v, E as x, F as M, G as y, H as B, I as F, J as L, K as H, L as b, M as K, N as q, O as w, P as Q, Q as V, R as W, S as X, T as Y, U as k, V as z, W as J, X as Z, Y as $, Z as ee, _ as ae, $ as se, a0 as Ce, a1 as ue, a2 as ie, a3 as re } from "./document-filter-CBrY09DH.js";
+import { B as C, C as u, a as i, b as r, c as o, d as t, e as S, f as n, g as c, h as E, i as m, j as p, k as A, l, m as P, n as R, o as _, p as I, q as d, r as g, s as T, t as D, u as O, v as N, w as U, x as G, y as h, z as f, A as j, D as v, E as x, F as M, G as y, H as B, I as F, J as L, K as H, L as b, M as K, N as q, O as w, P as Q, Q as V, R as W, S as X, T as Y, U as k, V as z, W as J, X as Z, Y as $, Z as ee, _ as ae, $ as se, a0 as Ce, a1 as ue, a2 as ie, a3 as re } from "./document-filter-BSiwWQ5L.js";
 import "uuid";
 export {
   C as BASE_CURRENCY,

package/lib/blob-storage.d.ts

@@ -0,0 +1,12 @@
+import { FirebaseApp } from 'firebase/app';
+import { CueBlobStorage } from '../../databases/src/index';
+import { CueAuth } from './auth';
+import { CueEndpoints, CueStorageConfig } from './models';
+/**
+ * The SDK's one blob store, shared by `new Cue()` and `Cue.fromApp()`.
+ *
+ * A bucket on the `firebase` driver gets a `FirebaseStorage` for its bucket
+ * name; a bucket on the `gateway` driver gets none, so a deployment with no
+ * Firebase Storage at all never touches it.
+ */
+export declare function createBlobStorage(app: FirebaseApp, auth: CueAuth, endpoints: CueEndpoints, config?: CueStorageConfig, connectEmulator?: boolean): CueBlobStorage;

package/lib/cache.d.ts

@@ -1,4 +1,4 @@
-import { FirebaseStorage } from 'firebase/storage';
+import { CueBlobStorage } from '../../databases/src/index';
 /** Shape stored by the query cache. */
 export interface QueryCacheEntry {
     query: string;
@@ -13,8 +13,8 @@ export interface QueryCacheEntry {
  * - User-project data:  `portal/projects/{pid}/users/{uid}/{id}.json.gz`
  */
 export declare class CueCache {
-    private readonly _storage;
-    constructor(_storage: FirebaseStorage);
+    private readonly _blob;
+    constructor(_blob: CueBlobStorage);
     getQueryCache(projectId: string, id: string): Promise<QueryCacheEntry | undefined>;
     setQueryCache(projectId: string, id: string, payload: QueryCacheEntry): Promise<void>;
     getAgentSessionCache(projectId: string, id: string): Promise<object | undefined>;

package/lib/cue.d.ts

@@ -1,5 +1,4 @@
 import { FirebaseApp } from 'firebase/app';
-import { FirebaseStorage } from 'firebase/storage';
 import { CueBlobStorage } from '../../databases/src/index';
 import { CueAuth } from './auth';
 import { CueSignUp } from './signup';
@@ -42,8 +41,11 @@ export declare class Cue {
     protected readonly _app: FirebaseApp;
     protected readonly _endpoints: CueEndpoints;
     protected readonly _isEmulator: boolean;
-    protected _storageRaw: FirebaseStorage;
-    protected _storageProcessed: FirebaseStorage;
+    /**
+     * Object storage, per bucket on Firebase Storage or the gateway (see
+     * `CueSdkConfig.storage`). What sync, data sources and the cache use.
+     */
+    readonly blob: CueBlobStorage;
     private _gis;
     private readonly _projectDocuments;
     private readonly _verbose;

package/lib/models.d.ts

@@ -1,5 +1,6 @@
 import { SupportedCurrency } from './currency';
 import { ComparisonResult } from '../../sync-tools/src/index';
+import { BlobBucket, BlobDriverKind } from '../../databases/src/index';
 export type CueEnvironment = 'production' | 'emulator';
 export interface CueEndpoints {
     /** API gateway base URL */
@@ -26,6 +27,18 @@ export interface CueSdkConfig {
     endpoints?: Partial<CueEndpoints>;
     /** Enable verbose debug logging for all entity/document store operations. */
     verbose?: boolean;
+    /** How the SDK reaches object storage. Defaults to Firebase Storage for every bucket. */
+    storage?: CueStorageConfig;
+}
+export interface CueStorageConfig {
+    /**
+     * Per-bucket driver. `firebase` (the default) uses Firebase Storage and its
+     * security rules; `gateway` uses the gateway's `/commands/storage` endpoints,
+     * which work on any backend the deployment runs (GCS, MinIO, S3).
+     */
+    drivers?: Partial<Record<BlobBucket, BlobDriverKind>>;
+    /** Firebase Storage bucket names, for buckets on the `firebase` driver. */
+    buckets?: Partial<Record<BlobBucket, string>>;
 }
 export type SsoProvider = 'google' | 'microsoft';
 export interface PasswordCredentials {
@@ -748,15 +761,16 @@ export type ProcessingStage = 'idle' | 'processing' | 'writing' | 'loading' | 'e
  *
  * - `uploaded`   — in storage, no processor output yet
  * - `processing` — a processor has emitted artifacts (markdown, images, fragments)
- * - `extracting` — RDF exists but is not all committed to the ledger
- * - `stored`     — every `.ttl` produced so far is committed
+ * - `extracting` — RDF exists; processing or extraction is still outstanding
+ * - `ready`      — done up to and including extraction; waiting to be bundled
+ * - `stored`     — ready, and every `.ttl` produced so far is bundled
  * - `failed`     — processing errored
  *
  * `stored` is not strictly final: an enricher producing further RDF later moves
- * the document back to `extracting`, which is a faithful description of reality
- * rather than a bug.
+ * the document back to `ready` until that RDF is bundled too, which is a
+ * faithful description of reality rather than a bug.
  */
-export type DocumentProcessingStage = 'uploaded' | 'processing' | 'extracting' | 'stored' | 'failed';
+export type DocumentProcessingStage = 'uploaded' | 'processing' | 'extracting' | 'ready' | 'stored' | 'failed';
 /** Per-document pipeline progress for one uploaded file. */
 export interface DocumentProgress {
     documentUUID: string;
@@ -776,6 +790,8 @@ export interface DocumentProgress {
     contributors: string[];
     rdfCount: number;
     rdfStoredCount: number;
+    /** What was missing when the document went ready, e.g. `extraction failed: 2`. */
+    gaps?: string[];
     error?: string;
 }
 /** Counts-only per-project rollup, streamed by {@link CueProcessingApi.watchMyStatus}. */

package/lib/semantic-template.d.ts

@@ -1,4 +1,4 @@
-import { EntityCategory, ProjectSchema } from '../../models/src/index';
+import { ContentCategory, EntityCategory, ProjectSchema } from '../../models/src/index';
 import { CueAuth } from './auth';
 export interface MutationResult {
     message: string;
@@ -114,6 +114,12 @@ export declare class CueSemanticTemplate {
      * starting point — the same list for every caller, nothing project-specific about it.
      */
     getDefaultEntities(projectId: string): Promise<EntityCategory[]>;
+    /**
+     * The QAECY catalogues' content categories — the document types a term can be limited to —
+     * with pinned IRIs stripped, so each is referenced by its bare `key`. The same list for every
+     * caller.
+     */
+    getDefaultContentCategories(projectId: string): Promise<ContentCategory[]>;
     /** Re-pushes the project's currently stored template into its `databases-cue` schema graph, without mutating it. */
     reloadSchema(projectId: string): Promise<MutationResult>;
     private _get;

package/node.js

@@ -1,5 +1,5 @@
-import { c as s } from "./document-filter-CBrY09DH.js";
-import { B as t, C as c, a as n, b as S, d as E, e as m, f as p, g as l, h as A, i as P, j as R, k as d, l as _, m as I, n as g, o as T, p as D, q as N, r as O, s as U, t as G, u as h, v as x, w as f, x as j, y as v, z as M, A as y, D as B, E as F, F as L, G as H, H as b, I as K, J as q, K as w, L as Q, M as V, N as W, O as X, P as Y, Q as k, R as z, S as J, T as Z, U as $, V as ee, W as se, X as ae, Y as ue, Z as Ce, _ as re, $ as ie, a0 as oe, a1 as te, a2 as ce, a3 as ne } from "./document-filter-CBrY09DH.js";
+import { c as s } from "./document-filter-BSiwWQ5L.js";
+import { B as t, C as c, a as n, b as S, d as E, e as m, f as p, g as l, h as A, i as P, j as R, k as d, l as _, m as I, n as g, o as T, p as D, q as N, r as O, s as U, t as G, u as h, v as x, w as f, x as j, y as v, z as M, A as y, D as B, E as F, F as L, G as H, H as b, I as K, J as q, K as w, L as Q, M as V, N as W, O as X, P as Y, Q as k, R as z, S as J, T as Z, U as $, V as ee, W as se, X as ae, Y as ue, Z as Ce, _ as re, $ as ie, a0 as oe, a1 as te, a2 as ce, a3 as ne } from "./document-filter-BSiwWQ5L.js";
 import "uuid";
 class r extends s {
   constructor(e) {

package/package.json

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