@qaecy/cue-sdk 0.0.25 → 0.0.27

package/index.d.ts

@@ -23,3 +23,5 @@ export type { CueSdkConfig, SsoProvider, PasswordCredentials, SearchRequest, Sea
 export type { AuthStateListener, Unsubscribe } from './lib/auth';
 export { CueTables } from './lib/tables';
 export type { ProjectTable } from './lib/tables';
+export { CueExtraction } from './lib/extraction';
+export type { ExtractionRequest, ExtractionResponse } from './lib/extraction';

package/index.js

@@ -1,23 +1,24 @@
-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";
+import { C as s, a as u, b as C, c as t, d as i, 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, p, R as E, q as R, r as f, s as d } from "./cue-CzxsQ6aP.js";
 export {
   s as Cue,
   u as CueApi,
   C as CueAuth,
-  i as CueCache,
-  t as CueGis,
-  c as CuePrivileges,
-  o as CueProfile,
-  r as CueProjectDocuments,
-  l as CueProjectEntities,
-  n as CueProjectSchema,
-  P as CueProjectView,
-  j as CueProjects,
-  m as CueSignal,
-  S as CueStorage,
-  g as CueSyncApi,
-  h as CueTables,
-  p as REQUIRED_ROLES,
+  t as CueCache,
+  i as CueExtraction,
+  c as CueGis,
+  o as CuePrivileges,
+  r as CueProfile,
+  l as CueProjectDocuments,
+  n as CueProjectEntities,
+  P as CueProjectSchema,
+  j as CueProjectView,
+  m as CueProjects,
+  S as CueSignal,
+  g as CueStorage,
+  h as CueSyncApi,
+  p as CueTables,
+  E as REQUIRED_ROLES,
   R as configureScanWasm,
   f as cueComputed,
-  E as staleWhileRevalidate
+  d as staleWhileRevalidate
 };

package/lib/api.d.ts

@@ -3,12 +3,15 @@ import { SearchRequest, SearchResponse, ShaclValidationReport, UnitsConsumedDto
 import { CueProjects } from './project';
 import { CueSyncApi } from './sync';
 import { CueTables } from './tables';
+import { CueExtraction } from './extraction';
 export declare class CueApi {
     private readonly _auth;
     private readonly _gatewayUrl;
     readonly projects: CueProjects;
     readonly sync?: CueSyncApi | undefined;
     readonly tables: CueTables;
+    /** Semantic extraction client — call document pages against a SemanticTemplate. */
+    readonly extraction: CueExtraction;
     /** Active language used for language-sensitive SPARQL queries across all project classes. */
     language: string;
     /** Updates the active language. All project classes (`CueProjectSchema`, `CueProjectDocuments`, `CueProjectEntities`) read this at query time. */

package/lib/auth.d.ts

@@ -47,6 +47,8 @@ export declare class CueAuth {
     checkSuperAdmin(): Promise<boolean>;
     /** Sign in with a Cue API key. `projectId` is optional — omit it when no project context is available (e.g. admin flows). */
     signInWithApiKey(cueApiKey: string, projectId?: string): Promise<User>;
+    /** Sign in with a Firebase custom token (e.g. minted server-side for MCP/OAuth flows). */
+    signInWithCustomToken(token: string): Promise<User>;
     /** Sign out the current user */
     signOut(): Promise<void>;
     /**

package/lib/extraction.d.ts

@@ -0,0 +1,48 @@
+import { CueAuth } from './auth';
+export declare const ENDPOINT_EXTRACTION = "/semantic-extraction/extract";
+export interface ExtractionRequest {
+    /** PNG (or other image) blob of the document page to extract from. */
+    image: Blob;
+    /** SemanticTemplate JSON object. */
+    template: object;
+    /** Project / space ID used by the extraction service. */
+    projectId: string;
+    /** IRI of the pre-selected content category; omit to let the model classify. */
+    category?: string | null;
+    /** Plain text of the page, used as additional context. */
+    text?: string | null;
+    /** Desired RDF serialisation — defaults to `'json-ld'`. */
+    rdfFormat?: 'json-ld' | 'turtle' | 'ntriples' | 'xml';
+}
+export interface ExtractionResponse {
+    /** Parsed JSON-LD document ready for `cue-rdf-graph`. */
+    jsonld: object;
+}
+/**
+ * Client for the Cue semantic-extraction endpoint.
+ *
+ * Exposed as `cue.api.extraction`.
+ *
+ * @example
+ * ```ts
+ * const result = await cue.api.extraction.extract({
+ *   image: pngBlob,
+ *   template: myTemplate,
+ *   projectId: 'my-project',
+ * });
+ * // result.jsonld is a JSON-LD document for cue-rdf-graph
+ * ```
+ */
+export declare class CueExtraction {
+    private readonly _auth;
+    private readonly _gatewayUrl;
+    constructor(_auth: CueAuth, _gatewayUrl: string);
+    /**
+     * Run semantic extraction on a document page image.
+     *
+     * Sends a multipart/form-data POST to `/semantic-extraction/extract`.
+     * Always requests JSON-LD so the result can be displayed directly in
+     * `cue-rdf-graph` without any further parsing.
+     */
+    extract(request: ExtractionRequest): Promise<ExtractionResponse>;
+}

package/lib/privileges.d.ts

@@ -2,11 +2,15 @@ import { ReadonlySignal } from './signal';
 /** Roles ordered from highest to lowest privilege. */
 declare const ROLE_HIERARCHY: readonly ["superadmin", "admin", "syncer", "member"];
 export type UserProjectRole = (typeof ROLE_HIERARCHY)[number];
+/** Role a user can have within an organization. */
+export type UserOrgRole = 'admin' | 'member';
 export interface Privileges {
     changeContentCategories: boolean;
     createEntities: boolean;
+    createProject: boolean;
     createProvider: boolean;
     deleteDocuments: boolean;
+    deleteProject: boolean;
     deleteUserFromProject: boolean;
     downloadDocuments: boolean;
     editContentCategories: boolean;
@@ -17,21 +21,29 @@ export interface Privileges {
     uploadDocuments: boolean;
     viewEntities: boolean;
 }
-/** Minimum role required for each privilege. */
-export declare const REQUIRED_ROLES: Record<keyof Privileges, UserProjectRole>;
+/**
+ * Minimum project role required for each privilege.
+ * Note: `createProject` is intentionally absent — it is gated by the
+ * user's organisation role, not their project role.
+ */
+export declare const REQUIRED_ROLES: Record<Exclude<keyof Privileges, 'createProject'>, UserProjectRole>;
 /**
  * Manages role-based access control for the current user + selected project.
  *
  * - Call `setProjectRoles()` whenever the selected project changes.
+ * - Call `setOrgRole()` whenever the selected project's organisation changes.
  * - Read `privileges` (a `ReadonlySignal<Privileges>`) for reactive access.
  *
  * @example
  * cue.privileges.setProjectRoles(['admin']);
+ * cue.privileges.setOrgRole('admin');
  * const canUpload = cue.privileges.privileges.get().uploadDocuments; // true
+ * const canCreate = cue.privileges.privileges.get().createProject;  // true
  */
 export declare class CuePrivileges {
     private readonly _isSuperAdmin;
     private readonly _projectRoles;
+    private readonly _orgRole;
     /**
      * Reactive signal — current user's privileges for the selected project.
      * Recomputes automatically when `setProjectRoles()` is called or when
@@ -39,6 +51,13 @@ export declare class CuePrivileges {
      */
     readonly privileges: ReadonlySignal<Privileges>;
     constructor(_isSuperAdmin: ReadonlySignal<boolean>);
+    /**
+     * Set the user's role within the organisation that owns the selected project.
+     * Pass `null` to clear the organisation role (e.g. when deselecting a project).
+     *
+     * Only organisation admins (and superadmins) may create projects.
+     */
+    setOrgRole(role: UserOrgRole | null): void;
     /**
      * Set the user's roles for the currently selected project.
      *

package/lib/project.d.ts

@@ -37,5 +37,9 @@ export declare class CueProjects {
     changeUserRoleOnProject(uid: string, projectId: string, role: ProjectRole): Promise<void>;
     /** Remove a member from a project. */
     removeUserFromProject(uid: string, projectId: string): Promise<void>;
+    /**
+     * Delete a project by ID. Requires superadmin privileges on the server.
+     */
+    deleteProject(projectId: string): Promise<void>;
 }
 export {};

package/node.js

@@ -1,16 +1,16 @@
-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 { C as h, B as l, t as _, u as E, v as S, o as m, w as P, a as d } from "./cue-CzxsQ6aP.js";
+import { b as j, c as x, d as y, e as I, f as K, g as L, h as v, i as H, j as N, k as O, l as D, m as G, n as W, p as k, R as q, q as Q, r as V, s as z } from "./cue-CzxsQ6aP.js";
+import { getStorage as t, connectStorageEmulator as w } from "firebase/storage";
 import "firebase/firestore";
 class A extends h {
   constructor(s) {
     super(s);
   }
   _buildApi(s) {
-    const r = e(this._app, l), i = e(this._app, _), n = this._storageRaw, u = e(this._app, S), c = this._storageProcessed, t = e(this._app, E);
+    const r = t(this._app, l), i = t(this._app, _), n = this._storageRaw, u = t(this._app, E), c = this._storageProcessed, e = t(this._app, S);
     if (this._isEmulator) {
       const p = this._endpoints.storageEmulatorHost, g = this._endpoints.storageEmulatorPort;
-      b(t, p, g);
+      w(e, p, g);
     }
     const C = new P({
       storageChatSessions: r,
@@ -18,7 +18,7 @@ class A extends h {
       storageRaw: n,
       storagePersistence: u,
       storageProcessed: c,
-      storagePublic: t
+      storagePublic: e
     }), a = new m(
       this.auth,
       s,
@@ -37,22 +37,23 @@ export {
   h as Cue,
   d as CueApi,
   j as CueAuth,
-  y as CueCache,
+  x as CueCache,
+  y as CueExtraction,
   I as CueGis,
   A as CueNode,
   K as CuePrivileges,
   L as CueProfile,
   v as CueProjectDocuments,
-  x as CueProjectEntities,
-  H as CueProjectSchema,
-  N as CueProjectView,
-  O as CueProjects,
-  D as CueSignal,
-  G as CueStorage,
+  H as CueProjectEntities,
+  N as CueProjectSchema,
+  O as CueProjectView,
+  D as CueProjects,
+  G as CueSignal,
+  W as CueStorage,
   m as CueSyncApi,
-  W as CueTables,
-  k as REQUIRED_ROLES,
-  q as configureScanWasm,
-  Q as cueComputed,
-  V as staleWhileRevalidate
+  k as CueTables,
+  q as REQUIRED_ROLES,
+  Q as configureScanWasm,
+  V as cueComputed,
+  z as staleWhileRevalidate
 };

package/package.json

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

package/variables.d.ts

@@ -27,6 +27,7 @@ export declare const ENDPOINT_COMMANDS_PROFILE_API_KEYS = "/commands/admin/profi
 export declare const ENDPOINT_COMMANDS_PROFILE_TERMS = "/commands/admin/profile/terms";
 export declare const ENDPOINT_ORG_MEMBERS: (orgId: string) => string;
 export declare const ENDPOINT_CREATE_PROJECT = "/commands/admin/project";
+export declare const ENDPOINT_DELETE_PROJECT: (projectId: string) => string;
 export declare const ENDPOINT_SEARCH = "/assistant/search";
 export declare const ENDPOINT_FUSEKI_QUERY = "/triplestore/query";
 export declare const ENDPOINT_FUSEKI_UPDATE = "/triplestore/update";