@qaecy/cue-sdk 0.0.54 → 0.0.57

package/index.d.ts

@@ -3,7 +3,8 @@ 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 type { CueActionCodeInfo, CueActionOperation } from './lib/auth';
 export { CueSignUp, CueRequestError } from './lib/signup';
 export type { OrgSignUpPayload, OrgSignUpPlan } from './lib/signup';
 export { CueApi } from './lib/api';
@@ -27,7 +28,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 +37,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 +49,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-DCFnaBFw.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

@@ -2,8 +2,29 @@ import { Auth, User } from 'firebase/auth';
 import { FirebaseApp } from 'firebase/app';
 import { CueEndpoints, PasswordCredentials, SsoProvider } from './models';
 import { ReadonlySignal } from './signal';
+/** What an email action link (`/auth/action?mode=…&oobCode=…`) does. */
+export type CueActionOperation = 'resetPassword' | 'verifyEmail' | 'changeEmail' | 'recoverEmail' | 'other';
+export interface CueActionCodeInfo {
+    operation: CueActionOperation;
+    /** The account's address — for `changeEmail` the NEW one, for `recoverEmail` the restored one. */
+    email: string;
+    /** For `changeEmail` and `recoverEmail`: the address being replaced. */
+    previousEmail?: string;
+}
 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;
@@ -29,6 +50,15 @@ export declare class CueAuth {
     signIn(provider: SsoProvider): Promise<User>;
     /** Sign in with email and password */
     signIn(provider: 'password', credentials: PasswordCredentials): Promise<User>;
+    /**
+     * Sign in with Google tokens obtained outside Firebase's popup, e.g. by the desktop app
+     * through the gateway's OAuth pages in the system browser (Google refuses OAuth inside
+     * embedded webviews). Same checks as the popup: the backend confirms the SSO sign-in.
+     */
+    signInWithGoogleTokens(tokens: {
+        idToken?: string;
+        accessToken?: string;
+    }): Promise<User>;
     /**
      * Initiate a redirect-based sign-in (mobile / iframe contexts where popups
      * are blocked). Call `checkRedirectResult()` on the next page load to
@@ -42,9 +72,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 +98,24 @@ export declare class CueAuth {
      * restored auth state.
      */
     mintAppSessionToken(): Promise<string>;
+    /**
+     * Send a password-reset email (through the Cue backend, in the Cue layout).
+     * The backend answers the same for unknown addresses, so callers should word
+     * their confirmation as "if an account exists…".
+     */
+    resetPassword(email: string): Promise<void>;
+    /** Reads an email action link's code without using it up. */
+    inspectActionCode(code: string): Promise<CueActionCodeInfo>;
+    /** Uses a verify-email, change-email or recover-email code. */
+    applyActionCode(code: string): Promise<void>;
+    /** Sets a new password with a reset code from a password-reset email. */
+    confirmPasswordReset(code: string, newPassword: string): Promise<void>;
+    /**
+     * Re-reads the signed-in user from Firebase and refreshes the token, e.g. so
+     * `emailVerified` is current after a verification link was used. Resolves to
+     * the fresh `emailVerified`, or false when signed out.
+     */
+    refreshUser(): Promise<boolean>;
     /** 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`.
  */