@qaecy/cue-sdk 0.0.54 → 0.0.55

package/index.d.ts

@@ -3,7 +3,7 @@ export { CueGis } from './lib/gis';
 export { CueStorage } from './lib/storage';
 export type { StorageBucket } from './lib/storage';
 export type { GisBBox, GisCategoryDescriptor, GisFeature, GisFeaturesMap, FeatureCategory } from './lib/gis';
-export { CueAuth } from './lib/auth';
+export { CueAuth, CueAuthError } from './lib/auth';
 export { CueSignUp, CueRequestError } from './lib/signup';
 export type { OrgSignUpPayload, OrgSignUpPlan } from './lib/signup';
 export { CueApi } from './lib/api';
@@ -27,7 +27,7 @@ export { CueProjects } from './lib/project';
 export type { ProjectUpdate } from './lib/project';
 export { CueProfile } from './lib/profile';
 export { CueAdmin } from './lib/admin';
-export type { AdminOrgSearchResult, AdminUserSearchResult, AdminProjectSearchResult, AdminUserOrgSummary, AdminUserProjectSummary, AdminUserDetail, AdminDeletedUserOrgRef, AdminDeletedUserProjectRef, AdminDeletedUserSummary, AdminRestoreUserResult, } from './lib/models';
+export type { AdminOrgSearchResult, AdminUserSearchResult, AdminProjectSearchResult, AdminUserOrgSummary, AdminUserProjectSummary, AdminUserDetail, AdminDeletedUserOrgRef, AdminDeletedUserProjectRef, AdminDeletedUserSummary, AdminRestoreUserResult, TransferProjectRequest, TransferProjectResult, ProjectOwnershipPeriod, } from './lib/models';
 export { CuePrivileges, REQUIRED_ROLES } from './lib/privileges';
 export type { UserProjectRole, Privileges } from './lib/privileges';
 export { CueSignal, cueComputed } from './lib/signal';
@@ -36,7 +36,7 @@ export { CueCache } from './lib/cache';
 export type { QueryCacheEntry } from './lib/cache';
 export { CueCurrency, SUPPORTED_CURRENCIES, BASE_CURRENCY } from './lib/currency';
 export type { SupportedCurrency, CurrencyRates } from './lib/currency';
-export type { CueSdkConfig, SsoProvider, PasswordCredentials, SearchRequest, SearchResponse, SearchSource, SearchOptions, ProjectData, ProjectSettings, QleverStats, CreateProjectOptions, SyncOptions, SyncResult, SyncPreview, ScanOutputRecord, UnitCreditMap, UnitsConsumedDto, OrgCreditsDto, OrgPlanSummary, MonthlyConsumptionDto, ProjectConsumptionReportDto, OrgConsumptionReportDto, FileTypeConsumptionDto, FileTypeBreakdownDto, RouteTrafficDto, DayTrafficDto, MonthTrafficDto, TrafficReportDto, ViewUsageDto, DayUsageDto, MonthUsageDto, UsageReportDto, OrganizationData, OrgMember, ProfileSSOAccount, APIKeyInfo, APIKeyDoc, ProjectDoc, OrganizationDoc, UserDoc, UserSettings, CustomAppRecord, CustomAppWithHtml, CreateCustomAppOptions, UpdateCustomAppOptions, RDFWritingDoc, ProcessingStatus, ProcessingStage, DocumentProcessingStage, DocumentProgress, ProjectProcessingSummary, MyProcessingStatus, DocumentReprocessJob, ReprocessJobStatus, ViewDefinition, QueryCache, LangMap, CategoryDef, RelationshipDef, EntityCoreData, EntityRelationship, EntityRelationships, MapGeometry, EntityDetailedData, ProjectEntitiesData, SummaryGraphData, PrototypeCategoryCount, PrototypeSummary, PrototypeProperty, PrototypeInstance, EntityAtExpressId, EntityModelLocation, ModelExpressIds, PrototypeCategoryExpressIds, DocumentInfo, DocumentSummary, ProjectDocumentsData, } from './lib/models';
+export type { CueSdkConfig, SsoProvider, PasswordCredentials, SearchRequest, SearchResponse, SearchSource, SearchOptions, ProjectData, ProjectSettings, QleverStats, CreateProjectOptions, SyncOptions, SyncResult, SyncPreview, ScanOutputRecord, UnitCreditMap, UnitsConsumedDto, OrgCredits, OrgCreditsDto, OrgPlanSummary, MonthlyConsumptionDto, ProjectConsumptionReportDto, OrgConsumptionReportDto, FileTypeConsumptionDto, FileTypeBreakdownDto, RouteTrafficDto, DayTrafficDto, MonthTrafficDto, TrafficReportDto, ViewUsageDto, DayUsageDto, MonthUsageDto, UsageReportDto, OrganizationData, OrgMember, ProfileSSOAccount, APIKeyInfo, APIKeyDoc, ProjectDoc, OrganizationDoc, UserDoc, UserSettings, CustomAppRecord, CustomAppWithHtml, CreateCustomAppOptions, UpdateCustomAppOptions, RDFWritingDoc, ProcessingStatus, ProcessingStage, DocumentProcessingStage, DocumentStageCounts, DocumentProgress, ProjectProcessingSummary, MyProcessingStatus, DocumentReprocessJob, ReprocessJobStatus, ReprocessDocumentOptions, ReprocessAccepted, ReprocessPlan, EntityMentionInput, EntityMentionDeletion, SelectorInput, ContentCategoryChange, EditResult, BatchEditResult, ViewDefinition, QueryCache, LangMap, CategoryDef, RelationshipDef, EntityCoreData, EntityRelationship, EntityRelationships, MapGeometry, EntityDetailedData, ProjectEntitiesData, SummaryGraphData, PrototypeCategoryCount, PrototypeSummary, PrototypeProperty, PrototypeInstance, EntityAtExpressId, EntityModelLocation, ModelExpressIds, PrototypeCategoryExpressIds, DocumentInfo, DocumentSummary, ProjectDocumentsData, } from './lib/models';
 export type { AuthStateListener, Unsubscribe } from './lib/auth';
 export { CueTables } from './lib/tables';
 export type { ProjectTable } from './lib/tables';
@@ -48,8 +48,10 @@ export { CueDataSources } from './lib/data-sources';
 export type { DataSourceRecord, XToRdfConfig, RmlXToRdfConfig, GraphXToRdfConfig, TypeMappingConfiguration, UploadDataSourceMode, UploadDataSourceResult, } from './lib/data-sources';
 export { CueGisSources } from './lib/gis-sources';
 export type { GisSourceRecord, GisSourceUploadFormat, GisSourceCrs } from './lib/gis-sources';
+export { CueEdits } from './lib/edits';
+export { isReprocessPlan } from './lib/models';
 export { CueSemanticTemplate } from './lib/semantic-template';
-export type { MutationResult as SemanticTemplateMutationResult, BatchMutationResult as SemanticTemplateBatchMutationResult, ContentCategoryInput, EntityCategoryInput, EntityRelationshipInput, SchemaSource, } from './lib/semantic-template';
+export type { MutationResult as SemanticTemplateMutationResult, BatchMutationResult as SemanticTemplateBatchMutationResult, ContentCategoryInput, EntityCategoryInput, EntityRelationshipInput, SchemaSource, RenameCanonicalInput, RenameCanonicalResult, } from './lib/semantic-template';
 export { CueSchemaSuggestion } from './lib/schema-suggestion';
 export { ENDPOINT_SCHEMA_SUGGESTION_FROM_PROSE, ENDPOINT_SCHEMA_SUGGESTION_CATALOGS, } from './lib/schema-suggestion';
 export type { SuggestSchemaFromProseRequest, SuggestSchemaFromProseResponse, SchemaSuggestionUsage, } from './lib/schema-suggestion';

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-BSiwWQ5L.js";
+import { B as C, C as u, a as i, b as r, c as o, d as t, e as n, f as S, 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 d, q as I, r as g, s as T, t as D, u as O, v as N, w as U, x as h, y as G, 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 aa, _ as ea, $ as sa, a0 as Ca, a1 as ua, a2 as ia, a3 as ra, a4 as oa, a5 as ta, a6 as na } from "./models-DytxsTwc.js";
 import "uuid";
 export {
   C as BASE_CURRENCY,
@@ -7,56 +7,59 @@ export {
   r as CatalogKind,
   o as Cue,
   t as CueAdmin,
-  S as CueApi,
-  n as CueAppData,
+  n as CueApi,
+  S as CueAppData,
   c as CueApps,
   E as CueAuth,
-  m as CueCache,
-  p as CueContexts,
-  A as CueCurrency,
-  l as CueDataSources,
-  P as CueDmsApi,
-  R as CueDocumentFilter,
-  _ as CueExtraction,
-  I as CueGis,
-  d as CueGisSources,
-  g as CueIndexApi,
-  T as CueLlmTools,
-  D as CueMcp,
-  O as CuePrivileges,
-  N as CueProcessingApi,
-  U as CueProfile,
-  G as CueProjectDocuments,
-  h as CueProjectEntities,
-  f as CueProjectSchema,
-  j as CueProjectView,
-  v as CueProjects,
-  x as CueRequestError,
-  M as CueSchemaSuggestion,
-  y as CueSemanticTemplate,
-  B as CueSignUp,
-  F as CueSignal,
-  L as CueStorage,
-  H as CueSyncApi,
-  b as CueTables,
-  K as CueUserSettings,
-  q as DEFAULT_SCHEMA_BASE,
-  w as ENDPOINT_SCHEMA_SUGGESTION_CATALOGS,
-  Q as ENDPOINT_SCHEMA_SUGGESTION_FROM_PROSE,
-  V as EmbeddingBasis,
-  W as NumeralRole,
-  X as Provenance,
-  Y as REQUIRED_ROLES,
-  k as ResolutionIdentity,
-  z as SUPPORTED_CURRENCIES,
-  J as SchemaTermKind,
-  Z as configureScanWasm,
-  $ as cueComputed,
-  ee as deriveIri,
-  ae as expandCurie,
-  se as isCurie,
-  Ce as rdfBase,
-  ue as resolveIri,
-  ie as resolveRef,
-  re as schemaGraphIri
+  m as CueAuthError,
+  p as CueCache,
+  A as CueContexts,
+  l as CueCurrency,
+  P as CueDataSources,
+  R as CueDmsApi,
+  _ as CueDocumentFilter,
+  d as CueEdits,
+  I as CueExtraction,
+  g as CueGis,
+  T as CueGisSources,
+  D as CueIndexApi,
+  O as CueLlmTools,
+  N as CueMcp,
+  U as CuePrivileges,
+  h as CueProcessingApi,
+  G as CueProfile,
+  f as CueProjectDocuments,
+  j as CueProjectEntities,
+  v as CueProjectSchema,
+  x as CueProjectView,
+  M as CueProjects,
+  y as CueRequestError,
+  B as CueSchemaSuggestion,
+  F as CueSemanticTemplate,
+  L as CueSignUp,
+  H as CueSignal,
+  b as CueStorage,
+  K as CueSyncApi,
+  q as CueTables,
+  w as CueUserSettings,
+  Q as DEFAULT_SCHEMA_BASE,
+  V as ENDPOINT_SCHEMA_SUGGESTION_CATALOGS,
+  W as ENDPOINT_SCHEMA_SUGGESTION_FROM_PROSE,
+  X as EmbeddingBasis,
+  Y as NumeralRole,
+  k as Provenance,
+  z as REQUIRED_ROLES,
+  J as ResolutionIdentity,
+  Z as SUPPORTED_CURRENCIES,
+  $ as SchemaTermKind,
+  aa as configureScanWasm,
+  ea as cueComputed,
+  sa as deriveIri,
+  Ca as expandCurie,
+  ua as isCurie,
+  ia as isReprocessPlan,
+  ra as rdfBase,
+  oa as resolveIri,
+  ta as resolveRef,
+  na as schemaGraphIri
 };

package/lib/admin.d.ts

@@ -1,5 +1,5 @@
 import { CueAuth } from './auth';
-import { AdminDeletedOrganizationSummary, AdminDeletedUserSummary, AdminOrganization, AdminOrgSearchResult, AdminOrphanedOrganization, AdminOrphanedProject, AdminOrphanedUser, AdminProjectSearchResult, AdminRestoreOrganizationResult, AdminRestoreUserResult, AdminUserDetail, AdminUserSearchResult, OrganizationData, ProjectData } from './models';
+import { AdminDeletedOrganizationSummary, AdminDeletedUserSummary, AdminOrganization, AdminOrgSearchResult, AdminOrphanedOrganization, AdminOrphanedProject, AdminOrphanedUser, AdminProjectSearchResult, AdminRestoreOrganizationResult, AdminRestoreUserResult, AdminUserDetail, AdminUserSearchResult, OrganizationData, ProjectData, TransferProjectRequest, TransferProjectResult } from './models';
 /**
  * Cross-organisation lookup for platform superadmins.
  *
@@ -10,7 +10,7 @@ import { AdminDeletedOrganizationSummary, AdminDeletedUserSummary, AdminOrganiza
  *
  * Search is substring matching done server-side over a capped scan (Firestore
  * has no substring index), so results are best-effort rather than exhaustive on
- * very large collections — see the service-side notes in `data-views`.
+ * very large collections — see the service-side notes in `writers-cue-bff`'s read side.
  *
  * @example
  * ```ts
@@ -54,6 +54,18 @@ export declare class CueAdmin {
      * teardown, not normal superadmin use, since a hard delete cannot be undone.
      */
     deleteUser(uid: string, hard?: boolean): Promise<void>;
+    /**
+     * Overwrites a user's display name (Auth `displayName` and profile doc) — e.g.
+     * for accounts created before a name was required. Any user, any org.
+     */
+    renameUser(uid: string, name: string): Promise<void>;
+    /**
+     * Hands a project to another organisation. Consumption up to now stays on the
+     * current owner's balance; only later uploads count against the new one.
+     * Members and roles are unchanged. Throws a `CueRequestError` with status 409
+     * when the project no longer belongs to `expectedCurrentOrganizationID`.
+     */
+    transferProject(projectId: string, request: TransferProjectRequest): Promise<TransferProjectResult>;
     /**
      * Undoes `deleteUser`: recreates the Auth account (same uid) and profile doc,
      * and re-grants the recorded org/project roles where those still exist.

package/lib/api.d.ts

@@ -1,6 +1,6 @@
 import { CueBlobStorage } from '../../databases/src/index';
 import { CueAuth } from './auth';
-import { SearchRequest, SearchResponse, ShaclValidationReport, UnitsConsumedDto } from './models';
+import { ReprocessAccepted, ReprocessDocumentOptions, ReprocessPlan, SearchRequest, SearchResponse, ShaclValidationReport, UnitsConsumedDto } from './models';
 import { CueProjects } from './project';
 import { CueSyncApi } from './sync';
 import { CueTables } from './tables';
@@ -18,6 +18,7 @@ import { CueDataSources } from './data-sources';
 import { CueGisSources } from './gis-sources';
 import { CueSchemaSuggestion } from './schema-suggestion';
 import { CueSemanticTemplate } from './semantic-template';
+import { CueEdits } from './edits';
 export interface PutAlternativeRepresentationResult {
     success: boolean;
     contentIRI: string;
@@ -61,6 +62,8 @@ export declare class CueApi {
     readonly semanticTemplate: CueSemanticTemplate;
     /** Prose into a proposed `ProjectSchema`, selected from the published term catalogues. */
     readonly schemaSuggestion: CueSchemaSuggestion;
+    /** Hand-made graph edits from the document viewer — entity mentions, selectors, content categories. */
+    readonly edits: CueEdits;
     /** 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. */
@@ -134,4 +137,13 @@ export declare class CueApi {
         processorId?: string;
         comment?: string;
     }): Promise<PutAlternativeRepresentationResult>;
+    /**
+     * Purges everything derived from a document and republishes its initial
+     * processing event (superadmin only).
+     *
+     * Answers 202 with a process id; progress arrives on the project's
+     * processing-status socket as a `reprocessJobs` entry with the same id. With
+     * `dryRun`, nothing is mutated and the resolved plan comes back instead.
+     */
+    reprocessDocument(projectId: string, documentUUID: string, options?: ReprocessDocumentOptions): Promise<ReprocessAccepted | ReprocessPlan>;
 }

package/lib/apps.d.ts

@@ -19,6 +19,12 @@ export declare class CueApps {
     create(options: CreateCustomAppOptions): Promise<CustomAppRecord>;
     /** Update an existing custom app. Only the original author or an organization admin may do this. */
     update(id: string, options: UpdateCustomAppOptions): Promise<CustomAppRecord>;
+    /**
+     * Copy a custom app into another organization, e.g. after moving a project there. The caller
+     * must belong to both organizations (superadmins always may). Repeating the call returns the
+     * earlier copy instead of making another.
+     */
+    copy(id: string, organizationID: string): Promise<CustomAppRecord>;
     /** Delete a custom app. Only the original author or an organization admin may do this. */
     remove(id: string): Promise<void>;
 }

package/lib/auth.d.ts

@@ -4,6 +4,18 @@ import { CueEndpoints, PasswordCredentials, SsoProvider } from './models';
 import { ReadonlySignal } from './signal';
 export type AuthStateListener = (user: User | null) => void;
 export type Unsubscribe = () => void;
+/**
+ * Error thrown by sign-in and password reset. `message` is safe to show to the
+ * user; `code` is Firebase's (e.g. 'auth/invalid-credential') when it came from
+ * Firebase, or 'cue/sso-no-account' | 'cue/sso-unconfirmed' when the backend
+ * refused an SSO sign-in. UIs should translate by `code`, not show `message`.
+ * The original error is kept as `cause`.
+ */
+export declare class CueAuthError extends Error {
+    readonly code?: string | undefined;
+    readonly cause?: unknown | undefined;
+    constructor(message: string, code?: string | undefined, cause?: unknown | undefined);
+}
 export declare class CueAuth {
     private readonly _auth;
     private readonly _endpoints;
@@ -42,9 +54,9 @@ export declare class CueAuth {
      */
     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.
+     * Lets the backend see every SSO sign-in: a first-time user gets a profile
+     * without an organisation. A 403 (older backends refused SSO sign-ups and
+     * deleted the account) signs out and throws.
      * Fails closed: if the check cannot be made, the session is dropped.
      */
     private _confirmSsoSignIn;
@@ -68,6 +80,12 @@ export declare class CueAuth {
      * restored auth state.
      */
     mintAppSessionToken(): Promise<string>;
+    /**
+     * Send a password-reset email. Firebase's email-enumeration protection makes
+     * this succeed silently for unknown addresses, so callers should word their
+     * confirmation as "if an account exists…".
+     */
+    resetPassword(email: string): Promise<void>;
     /** Sign out the current user */
     signOut(): Promise<void>;
     /** Currently signed-in user, or null if not authenticated */

package/lib/data-sources.d.ts

@@ -309,7 +309,7 @@ export interface SheetFileLinkage {
  * self-describing: what a stored mapping does to its input is not the query alone, and neither a
  * human reading the config nor a future engine should have to know about an implicit post-pass.
  * Order is significant. An absent `postProcessing` means "the default for this config type" —
- * see `_postProcessingSteps` in writers-commands' data-sources.service.ts, which is also where the legacy
+ * see `_postProcessingSteps` in writers-cue-bff's data-sources.service.ts, which is also where the legacy
  * behaviour for configs saved before this field existed is pinned down.
  */
 export type XToRdfPostProcessingStep = MintCanonicalEntitiesStep;
@@ -382,8 +382,8 @@ export interface DataSourceProgressEvent {
  * re-applied to every subsequent data upload. Uploaded data's derived triples
  * land in the data source's own named graph.
  *
- * Mutations (create/update/delete/uploadData) go through writers-commands and
- * require the syncer role; reads (list/get) go through data-views.
+ * Mutations (create/update/delete/uploadData) require the syncer role; reads
+ * (list/get) need only membership. Both go to `writers-cue-bff`.
  *
  * Exposed as `cue.api.dataSources`.
  */
@@ -426,7 +426,21 @@ export declare class CueDataSources {
      * built from the stream's `error` line (a non-2xx HTTP status, e.g. an auth/guard rejection
      * before the handler even runs, is still thrown from `response.ok` as before).
      */
+    /**
+     * Where an API client posts a data source's files directly (multipart `files` plus `mode`),
+     * for showing to users who script uploads with an API key. `uploadData` itself stages
+     * through storage instead, to stay under the request-size limit.
+     */
+    uploadEndpointUrl(id: string): string;
     uploadData(projectId: string, id: string, files: Blob[], mode: UploadDataSourceMode, onProgress?: (event: DataSourceProgressEvent) => void): Promise<UploadDataSourceResult>;
+    /**
+     * Same as `uploadData`, but over the source file(s) the data source's config already stores
+     * (`config.sourceFiles`, persisted by `DataSourceHandlers.uploadSourceFile` when the mapping was
+     * saved) — nothing is uploaded. What a mapping edit wants: the file it was built from is already
+     * in storage, so sending it back up only costs the transfer. Refused for a data source that
+     * stores no source file. Same NDJSON progress stream and `{added, removed}` result.
+     */
+    uploadDataFromSource(projectId: string, id: string, mode: UploadDataSourceMode, onProgress?: (event: DataSourceProgressEvent) => void): Promise<UploadDataSourceResult>;
     /**
      * Re-runs a data source that has no uploaded input — today only a `files` config, whose input is
      * the project's own file locations. This is how "new files have arrived since this ran" is
@@ -453,7 +467,7 @@ export declare class CueDataSources {
     }>;
     /**
      * Uploads every file straight to the raw bucket's `${projectId}/_tmp-uploads/` prefix (server
-     * deletes each one right after processing it — see writers-commands' `_withTempFiles`), so
+     * deletes each one right after processing it — see writers-cue-bff's `_withTempFiles`), so
      * `uploadData`/`previewTransform`'s own request only ever carries small JSON references —
      * bytes never cross Cloud Run's request-size cap, no matter how large the file. Reports
      * upload-byte progress through `onProgress` as `phase: 'uploading'`, aggregated across every

package/lib/edits.d.ts

@@ -0,0 +1,21 @@
+import { CueAuth } from './auth';
+import { BatchEditResult, ContentCategoryChange, EditResult, EntityMentionDeletion, EntityMentionInput, SelectorInput } from './models';
+/**
+ * Hand-made edits to a project's graph — the annotations a user adds or removes
+ * in the document viewer. Each call is one ledger commit on the service side.
+ * Writes need the `member` role on the project.
+ */
+export declare class CueEdits {
+    private readonly _auth;
+    private readonly _gatewayUrl;
+    constructor(_auth: CueAuth, _gatewayUrl: string);
+    /** Creates entity mentions in one batch. */
+    createEntityMentions(projectId: string, items: EntityMentionInput[], batchComment?: string): Promise<BatchEditResult>;
+    /** Deletes entity mentions in one batch. */
+    deleteEntityMentions(projectId: string, items: EntityMentionDeletion[], batchComment?: string): Promise<BatchEditResult>;
+    /** Creates selectors (the text spans mentions point at) in one batch. */
+    createSelectors(projectId: string, items: SelectorInput[], batchComment?: string): Promise<BatchEditResult>;
+    /** Replaces a document's content categories: `existingValues` out, `newValues` in. */
+    changeContentCategory(projectId: string, change: ContentCategoryChange): Promise<EditResult>;
+    private _send;
+}

package/lib/gis-sources.d.ts

@@ -31,8 +31,8 @@ export interface GisSourceRecord {
  * every other (WFS-backed) category. Reprojection to WGS84 (from LV95/LV03) happens server-side
  * at upload time — `featureCollection` is always WGS84.
  *
- * Mutations (create/update/delete) go through writers-commands and require the syncer role;
- * reads (list/get) go through data-views.
+ * Mutations (create/update/delete) require the syncer role; reads (list/get) need only
+ * membership. Both go to `writers-cue-bff`.
  *
  * Exposed as `cue.api.gisSources`.
  */

package/lib/models.d.ts

@@ -33,7 +33,7 @@ export interface CueSdkConfig {
 export interface CueStorageConfig {
     /**
      * Per-bucket driver. `firebase` (the default) uses Firebase Storage and its
-     * security rules; `gateway` uses the gateway's `/commands/storage` endpoints,
+     * security rules; `gateway` uses the gateway's `/bff/storage` endpoints,
      * which work on any backend the deployment runs (GCS, MinIO, S3).
      */
     drivers?: Partial<Record<BlobBucket, BlobDriverKind>>;
@@ -180,7 +180,7 @@ export interface ProjectSettings {
      * Absent means English only, which is what every project resolved to before
      * this field existed.
      *
-     * Read by `writers-commands` (stamped onto `ProjectSchema.languages` on every
+     * Read by `writers-cue-bff` (stamped onto `ProjectSchema.languages` on every
      * schema write), the schema-suggestion endpoint (which languages a proposed
      * term is translated into), and the translation enricher (its targets, minus
      * the pivot).
@@ -257,6 +257,35 @@ export interface ProjectData {
     /** Set by a superadmin's soft delete — the project doc, index, and storage remain intact. */
     deleted?: boolean;
     deletedAt?: string | null;
+    /** Who owned the project when — absent until the first transfer (see `CueAdmin.transferProject`). */
+    ownershipHistory?: ProjectOwnershipPeriod[];
+    /** Orgs that owned the project before; their earlier consumption stays on their balance. */
+    formerOrganizationIDs?: string[];
+}
+/** One stretch of ownership, running from `from` until the next period's `from`. */
+export interface ProjectOwnershipPeriod {
+    organizationID: string;
+    from: string;
+    transferId?: string;
+    transferredBy?: string;
+    /** Credits moved from the previous owner as part of the transfer (0 = none). */
+    creditTransfer?: number;
+}
+/** Body of `CueAdmin.transferProject`. */
+export interface TransferProjectRequest {
+    organizationID: string;
+    /** The owner the caller saw — the server answers 409 if it has changed since. */
+    expectedCurrentOrganizationID: string;
+    /** Credits to move from the current owner to the new one; required, 0 = none. */
+    creditTransfer: number;
+    /** Client-generated UUID. Repeat it to retry a failed credit transfer. */
+    transferId: string;
+}
+/** `creditTransferFailed` means the project moved but its credits did not — retry with the same `transferId`. */
+export interface TransferProjectResult {
+    project: ProjectData;
+    creditTransferFailed: boolean;
+    creditTransferError?: string;
 }
 export interface CreateProjectOptions {
     /** The organization this project belongs to */
@@ -590,6 +619,10 @@ export interface OrgCreditsDto {
     available: number;
     plan: OrgPlanSummary;
 }
+/** An {@link OrgCreditsDto} tagged with the org it was fetched for — what `CueProfile.orgCredits` holds. */
+export interface OrgCredits extends OrgCreditsDto {
+    orgId: string;
+}
 /** Consumption for a single calendar month (`YYYY-MM`, UTC), keyed by the file's own upload time. */
 export interface MonthlyConsumptionDto {
     unitsConsumed: number;
@@ -601,6 +634,12 @@ export interface ProjectConsumptionReportDto {
     name?: string;
     /** Keyed by `YYYY-MM` (UTC). */
     monthly: Record<string, MonthlyConsumptionDto>;
+    /** Set when the org handed the project to another org; `monthly` then covers only its own ownership. */
+    transferredTo?: {
+        organizationID: string;
+        name?: string;
+        at: string;
+    };
 }
 /** Per-project, per-month consumption breakdown for an org — see {@link OrgCreditsDto} for the org-level totals. */
 export interface OrgConsumptionReportDto {
@@ -718,6 +757,8 @@ export interface CustomAppRecord {
     tone: string;
     authorId: string;
     authorName: string;
+    /** Set on a copy made into another organization via `cue.api.apps.copy` — the id of the original. */
+    copiedFrom?: string;
     createdAt: string;
     updatedAt: string;
 }
@@ -750,10 +791,10 @@ export interface RDFWritingDoc {
     lastRDFWrite: string;
 }
 /**
- * `processing` covers the upload→artifact window: a file has been uploaded and a
- * processor is working on it, but no `.ttl` exists yet so none of the RDF
- * write/load/resolution tracking has begun. It is the *lowest*-precedence stage,
- * so a project already committing RDF never appears to fall back to it.
+ * The project's stage, derived from its documents: `processing` while any
+ * document is on its way to `stored`, `enriching` while resolution runs. The
+ * detail is in `documentCounts`. `writing` and `loading` are no longer emitted
+ * by current servers.
  */
 export type ProcessingStage = 'idle' | 'processing' | 'writing' | 'loading' | 'enriching';
 /**
@@ -761,16 +802,17 @@ 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; 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
+ * - `extracting` — processing or extraction outstanding, or its RDF not yet bundled
+ * - `stored`     — done through extraction, 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 `ready` until that RDF is bundled too, which is a
- * faithful description of reality rather than a bug.
+ * Partial problems (a page whose extraction failed) do not fail the document;
+ * they are listed in `gaps`. `stored` is not strictly final: RDF arriving later
+ * moves the document back to `extracting` until it is bundled too.
  */
-export type DocumentProcessingStage = 'uploaded' | 'processing' | 'extracting' | 'ready' | 'stored' | 'failed';
+export type DocumentProcessingStage = 'uploaded' | 'processing' | 'extracting' | 'stored' | 'failed';
+/** How many of a project's documents are in each stage. */
+export type DocumentStageCounts = Record<DocumentProcessingStage, number>;
 /** Per-document pipeline progress for one uploaded file. */
 export interface DocumentProgress {
     documentUUID: string;
@@ -798,6 +840,8 @@ export interface DocumentProgress {
 export interface ProjectProcessingSummary {
     projectId: string;
     stage: ProcessingStage;
+    /** Absent on older servers. */
+    documentCounts?: DocumentStageCounts;
     pendingDocumentCount: number;
     failedDocumentCount: number;
     lastActivityAt?: string;
@@ -818,10 +862,98 @@ export interface MyProcessingStatus {
      */
     truncated?: boolean;
 }
+/** Options for `CueApi.reprocessDocument` — mirrors the service's `ReprocessDocumentDto`. */
+export interface ReprocessDocumentOptions {
+    removeGraphs?: boolean;
+    removeProcessed?: boolean;
+    /** Publish even when the raw blob carries `skip_processing` (does not clear the flag). */
+    force?: boolean;
+    resetAttempts?: boolean;
+    dryRun?: boolean;
+}
+/** 202 body: the reprocess is running, follow `processId` on the status socket. */
+export interface ReprocessAccepted {
+    processId: string;
+    projectId: string;
+    documentUUID: string;
+    status: string;
+}
+/** 200 body for a `dryRun` request — what a real run would purge. */
+export interface ReprocessPlan {
+    dryRun: true;
+    projectId: string;
+    documentUUID: string;
+    graphs: string[];
+    quads: number;
+    blobs: string[];
+    rawBlobPresent: boolean;
+    /**
+     * Count of this document's mentions already resolved into a canonical entity
+     * elsewhere in the project — purging leaves that entity's link dangling until
+     * the pipeline re-resolves the same text.
+     */
+    resolvedMentionsAtRisk: number;
+}
+export declare const isReprocessPlan: (r: ReprocessAccepted | ReprocessPlan) => r is ReprocessPlan;
+/** One entity mention to create — mirrors the service's `CreateEntityMentionDto`. */
+export interface EntityMentionInput {
+    mention: {
+        iri: string;
+        value: string;
+        entityCategories: string[];
+        description?: string | null;
+        resolvesTo?: string | null;
+        properties?: string[];
+        /** Subjects (e.g. selectors) this mention is made in. */
+        mentions?: string[];
+        relationships?: {
+            predicate: string;
+            objectIri: string;
+        }[];
+    };
+    namedGraph: string;
+    comment?: string;
+}
+/** One entity mention to delete — mirrors the service's `DeleteEntityMentionDto`. */
+export interface EntityMentionDeletion {
+    iri: string;
+    comment?: string;
+}
+/** One selector to create — mirrors the service's `CreateSelectorDto`. */
+export interface SelectorInput {
+    iri: string;
+    type: string;
+    selectorSubjects: string[];
+    selectorObject: string;
+    value: string;
+    namedGraph: string;
+    comment?: string;
+}
+/** Replaces a subject's content categories — mirrors the service's `ChangeObjectIRIRequestDto`. */
+export interface ContentCategoryChange {
+    subject: string;
+    existingValues: string[];
+    newValues: string[];
+    comment?: string;
+}
+/** Outcome of one graph edit — mirrors the service's `MutationResult`. */
+export interface EditResult {
+    message: string;
+    success: boolean;
+    insertCount?: number;
+    iri?: string;
+    errorCode?: string;
+}
+/** Outcome of a batch of graph edits — mirrors the service's `BatchMutationResult`. */
+export interface BatchEditResult {
+    results: EditResult[];
+    successCount: number;
+    failureCount: number;
+}
 /** Lifecycle of a superadmin document-reprocess request. */
 export type ReprocessJobStatus = 'queued' | 'purging-rdf' | 'purging-blobs' | 'publishing' | 'succeeded' | 'failed';
 /**
- * Progress of one document reprocess (`POST /commands/document/:uuid/reprocess`),
+ * Progress of one document reprocess (`POST /bff/document/:uuid/reprocess`),
  * pushed on the same socket as the rest of the pipeline status.
  */
 export interface DocumentReprocessJob {
@@ -843,7 +975,7 @@ export interface DocumentReprocessJob {
     finishedAt?: string;
 }
 /**
- * Aggregated, per-project pipeline status pushed live by the `accessors-data-views`
+ * Aggregated, per-project pipeline status pushed live by the `writers-cue-bff`
  * processing-status WebSocket (see `CueProcessingApi.watchStatus`). Shape mirrors
  * `cue-ui`'s `ProcessingStatus` (views/project-settings/models.ts) so it can be
  * passed straight through to `<cue-project-settings>` / `<cue-portal-upload>`.
@@ -873,9 +1005,11 @@ export interface ProcessingStatus {
      * this as "the recent ones" and rely on the counts below for totals.
      */
     documents?: DocumentProgress[];
+    /** How many documents are in each stage. Exact. Absent on older servers. */
+    documentCounts?: DocumentStageCounts;
     /**
      * Documents not yet in a terminal stage. Exact even when `documents` was
-     * truncated. Optional because a client may be talking to a data-views
+     * truncated. Optional because a client may be talking to a writers-cue-bff
      * deployment predating per-document tracking, which omits it — treat absent as
      * "unknown", not zero.
      */

package/lib/processing.d.ts

@@ -14,7 +14,7 @@ export interface MyProcessingStatusWatcher {
     close(): void;
 }
 /**
- * Live pipeline-progress status, pushed by the `accessors-data-views`
+ * Live pipeline-progress status, pushed by `writers-cue-bff`'s
  * processing-status WebSockets. Backs the upload modal, the project-settings
  * "processing" indicators, and the header's cross-project badge.
  */