@qaecy/cue-sdk 0.0.52 → 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-BuFNMQwr.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/auth.d.ts

@@ -12,6 +12,7 @@ export declare class CueAuth {
     private readonly _isSuperAdminSignal;
     private readonly _userIdsSignal;
     private readonly _stopTokenListener;
+    private _ssoPending;
     /** Reactive auth state — emits the signed-in `User`, or `null` when signed out. */
     readonly user: ReadonlySignal<User | null>;
     /** Reactive Firebase ID token — refreshes automatically; `null` when signed out. */
@@ -21,6 +22,7 @@ export declare class CueAuth {
     /** All unique UIDs for the current user (Firebase UID + linked provider UIDs). */
     readonly userIds: ReadonlySignal<string[]>;
     constructor(app: FirebaseApp, useEmulator: boolean | undefined, endpoints: CueEndpoints);
+    private _publish;
     /** Stop all internal Firebase listeners. Call when the `Cue` instance is no longer needed. */
     destroy(): void;
     /** Sign in with Google or Microsoft via browser popup */
@@ -39,6 +41,13 @@ export declare class CueAuth {
      * Call this once on app startup before showing a sign-in UI.
      */
     checkRedirectResult(): Promise<User | null>;
+    /**
+     * SSO may sign in to an existing account but never create one. Firebase
+     * creates the account before we can object, so the backend checks it
+     * afterwards and deletes it if it is a fresh sign-up; we sign out and throw.
+     * Fails closed: if the check cannot be made, the session is dropped.
+     */
+    private _confirmSsoSignIn;
     /**
      * One-shot async check — returns `true` if the current user has the
      * `superadmin` custom claim. For reactive use, read `cue.auth.isSuperAdmin`

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 */
@@ -12,10 +13,6 @@ export interface CueEndpoints {
     storageEmulatorHost: string;
     /** Firebase Storage emulator port (emulator mode only, default: 9199) */
     storageEmulatorPort: number;
-    /** Firebase Firestore emulator hostname, no protocol (emulator mode only, default: 'localhost') */
-    firestoreEmulatorHost: string;
-    /** Firebase Firestore emulator port (emulator mode only, default: 8080) */
-    firestoreEmulatorPort: number;
 }
 export interface CueSdkConfig {
     /** Firebase API key for this project. Defaults to the QAECY demo app if omitted. */
@@ -30,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 {
@@ -752,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;
@@ -780,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/profile.d.ts

@@ -1,12 +1,10 @@
 import { UserInfo } from 'firebase/auth';
-import { FirebaseApp } from 'firebase/app';
 import { APIKeyDoc, APIKeyInfo, FileTypeBreakdownDto, OrgConsumptionReportDto, OrgCreditsDto, OrgMember, OrganizationData, ProfileSSOAccount, TrafficReportDto, UsageReportDto } from './models';
 import { CueAuth } from './auth';
 import { ReadonlySignal } from './signal';
 export declare class CueProfile {
     private readonly _auth;
     private readonly _gatewayUrl;
-    private readonly _functions;
     private readonly _orgCredits;
     /**
      * Reactive view of the last-fetched org credit pool. Updated automatically
@@ -17,7 +15,7 @@ export declare class CueProfile {
      * `effect(() => sig.set(cue.profile.orgCredits.get()))` + `.subscribe(...)`.
      */
     readonly orgCredits: ReadonlySignal<OrgCreditsDto | undefined>;
-    constructor(_auth: CueAuth, app: FirebaseApp, useEmulator: boolean, _gatewayUrl: string);
+    constructor(_auth: CueAuth, _gatewayUrl: string);
     private _url;
     private _fetch;
     /** Whether the current user has an active API key. */

package/lib/project.d.ts

@@ -1,4 +1,3 @@
-import { FirebaseApp } from 'firebase/app';
 import { CueAuth } from './auth';
 import { CreateProjectOptions, CueEndpoints, ProjectData, ProjectMetadata } from './models';
 import { ReadonlySignal } from './signal';
@@ -12,7 +11,6 @@ export interface ProjectUpdate {
 }
 export declare class CueProjects {
     private readonly _auth;
-    private readonly _db;
     private readonly _gatewayUrl;
     private readonly _projects;
     /**
@@ -21,7 +19,7 @@ export declare class CueProjects {
      * without every caller having to remember to re-fetch the whole list.
      */
     readonly projects: ReadonlySignal<ProjectData[] | undefined>;
-    constructor(_auth: CueAuth, app: FirebaseApp, useEmulator?: boolean, endpoints?: CueEndpoints);
+    constructor(_auth: CueAuth, endpoints?: CueEndpoints);
     /**
      * Create a new project. The authenticated user is automatically set as admin, syncer, and member.
      * Throws if a project with the given ID already exists.
@@ -38,11 +36,6 @@ export declare class CueProjects {
      * single project look like the user's entire project set.
      */
     private _patchProject;
-    /**
-     * Atomically increments `unitsConsumed` on the top-level `clientSync/{projectId}`
-     * document, creating it if it doesn't exist. Intended for pre-flight checks.
-     */
-    incrementUnitsConsumed(projectId: string, units: number, userId: string): Promise<void>;
     /**
      * Invite a user to a project by email. Returns the invited user's uid.
      * Throws if no account exists yet for that email — the gateway route supports

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-BuFNMQwr.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-BuFNMQwr.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.52",
+  "version": "0.0.54",
   "type": "module",
   "main": "./index.js",
   "types": "./index.d.ts",

package/variables.d.ts

@@ -26,6 +26,7 @@ export declare const ENDPOINT_PROFILE_ORGANIZATIONS = "/data-views/admin/profile
 export declare const ENDPOINT_PROFILE_API_KEYS = "/data-views/admin/profile/api-keys";
 export declare const ENDPOINT_COMMANDS_PROFILE_API_KEYS = "/commands/admin/profile/api-keys";
 export declare const ENDPOINT_COMMANDS_PROFILE_TERMS = "/commands/admin/profile/terms";
+export declare const ENDPOINT_COMMANDS_PROFILE_SSO_SIGN_IN = "/commands/admin/profile/sso-sign-in";
 export declare const ENDPOINT_COMMANDS_PROFILE_ANALYTICS_NOTICE = "/commands/admin/profile/analytics-notice";
 export declare const ENDPOINT_COMMANDS_USAGE_VIEW = "/commands/admin/usage/view";
 export declare const ENDPOINT_ORG_MEMBERS: (orgId: string) => string;