@lumibase/sdk 0.18.0 → 0.20.0

package/dist/index.cjs

@@ -27,9 +27,11 @@ __export(index_exports, {
   checkCdcPipelineHealth: () => checkCdcPipelineHealth,
   createAgentArtifact: () => createAgentArtifact,
   createAgentGoal: () => createAgentGoal,
+  createBookmark: () => createBookmark,
   createCdcPipeline: () => createCdcPipeline,
   createLumiClient: () => createLumiClient,
   decideAgentApproval: () => decideAgentApproval,
+  deleteBookmark: () => deleteBookmark,
   deleteCdcPipeline: () => deleteCdcPipeline,
   deployCdc: () => deployCdc,
   dryRunAccessImport: () => dryRunAccessImport,
@@ -38,6 +40,7 @@ __export(index_exports, {
   extractSeo: () => extractSeo,
   generateAgentApp: () => generateAgentApp,
   generateTypes: () => generateTypes,
+  getEffectivePreset: () => getEffectivePreset,
   graphql: () => graphql,
   importAccessManifest: () => importAccessManifest,
   jsonLdScript: () => jsonLdScript,
@@ -47,7 +50,9 @@ __export(index_exports, {
   listAgentGoals: () => listAgentGoals,
   listAgentRuns: () => listAgentRuns,
   listAgentTools: () => listAgentTools,
+  listBookmarks: () => listBookmarks,
   listCdcPipelines: () => listCdcPipelines,
+  mediaUrl: () => mediaUrl,
   publishAgentArtifact: () => publishAgentArtifact,
   readAgentMemoryContext: () => readAgentMemoryContext,
   readCdcPipeline: () => readCdcPipeline,
@@ -58,10 +63,12 @@ __export(index_exports, {
   retryAgentRun: () => retryAgentRun,
   rollbackAgentArtifact: () => rollbackAgentArtifact,
   rollbackCdcDeployment: () => rollbackCdcDeployment,
+  saveUserView: () => saveUserView,
   search: () => search,
   startCdcPipeline: () => startCdcPipeline,
   stopCdcPipeline: () => stopCdcPipeline,
   toNextMetadata: () => toNextMetadata,
+  updateBookmark: () => updateBookmark,
   updateCdcPipeline: () => updateCdcPipeline,
   validateCdcDeploymentEnv: () => validateCdcDeploymentEnv,
   writeAgentMemory: () => writeAgentMemory
@@ -656,7 +663,35 @@ function legacyRest() {
         releasePin: (id, field) => client.rawRequest(
           `${base}/${id}/pins/${encodeURIComponent(field)}`,
           { method: "DELETE" }
-        )
+        ),
+        // Content versions — named parallel draft branches (content-versioning).
+        versions: {
+          list: (id) => client.rawRequest(`${base}/${id}/versions`),
+          create: (id, input) => client.rawRequest(`${base}/${id}/versions`, {
+            method: "POST",
+            body: JSON.stringify(input)
+          }),
+          get: (id, key) => client.rawRequest(
+            `${base}/${id}/versions/${encodeURIComponent(key)}`
+          ),
+          update: (id, key, patch) => client.rawRequest(
+            `${base}/${id}/versions/${encodeURIComponent(key)}`,
+            { method: "PATCH", body: JSON.stringify(patch) }
+          ),
+          delete: (id, key) => client.rawRequest(
+            `${base}/${id}/versions/${encodeURIComponent(key)}`,
+            { method: "DELETE" }
+          ),
+          compare: (id, key) => client.rawRequest(
+            `${base}/${id}/versions/${encodeURIComponent(key)}/compare`
+          ),
+          // Returns the promoted item; `meta.mainDiverged` flags that main
+          // changed after the branch was cut (review advised).
+          promote: (id, key) => client.rawRequest(
+            `${base}/${id}/versions/${encodeURIComponent(key)}/promote`,
+            { method: "POST" }
+          )
+        }
       };
     }
     const roles = {
@@ -1090,6 +1125,79 @@ function legacyRest() {
   };
 }
 
+// src/rest/gaps.ts
+function getEffectivePreset(collection) {
+  return async (client) => {
+    const res = await client.rawRequest(
+      `/api/v1/presets/effective?collection=${encodeURIComponent(collection)}`
+    );
+    return res.data;
+  };
+}
+function listBookmarks(collection) {
+  return async (client) => {
+    const res = await client.rawRequest(
+      `/api/v1/presets/bookmarks?collection=${encodeURIComponent(collection)}`
+    );
+    return res.data;
+  };
+}
+function saveUserView(input) {
+  return async (client) => {
+    const res = await client.rawRequest("/api/v1/presets", {
+      method: "POST",
+      body: JSON.stringify({ ...input, bookmark: null })
+    });
+    return res.data;
+  };
+}
+function createBookmark(input) {
+  return async (client) => {
+    const res = await client.rawRequest("/api/v1/presets", {
+      method: "POST",
+      body: JSON.stringify(input)
+    });
+    return res.data;
+  };
+}
+function updateBookmark(id, input) {
+  return async (client) => {
+    const res = await client.rawRequest(`/api/v1/presets/${encodeURIComponent(id)}`, {
+      method: "PATCH",
+      body: JSON.stringify(input)
+    });
+    return res.data;
+  };
+}
+function deleteBookmark(id) {
+  return async (client) => {
+    const res = await client.rawRequest(`/api/v1/presets/${encodeURIComponent(id)}`, {
+      method: "DELETE"
+    });
+    return res.data;
+  };
+}
+function mediaUrl(key, transform, opts) {
+  return (client) => {
+    const base = client.url.replace(/\/$/, "");
+    const path = `/api/v1/media/${key.split("/").map(encodeURIComponent).join("/")}`;
+    if (!transform) return `${base}${path}`;
+    const qs = new URLSearchParams();
+    if ("preset" in transform) {
+      qs.set("preset", transform.preset);
+    } else {
+      if (transform.width !== void 0) qs.set("width", String(transform.width));
+      if (transform.height !== void 0) qs.set("height", String(transform.height));
+      if (transform.format) qs.set("format", transform.format);
+      if (transform.quality !== void 0) qs.set("quality", String(transform.quality));
+      if (transform.fit) qs.set("fit", transform.fit);
+      if (opts?.sign) qs.set("sig", opts.sign);
+    }
+    const query = qs.toString();
+    return query ? `${base}${path}?${query}` : `${base}${path}`;
+  };
+}
+
 // src/rest/index.ts
 function search(query, params) {
   return async (client) => {
@@ -1113,6 +1221,7 @@ function readItems(collection, params) {
     if (params?.limit !== void 0) qs.set("limit", String(params.limit));
     if (params?.offset !== void 0) qs.set("offset", String(params.offset));
     if (params?.status) qs.set("status", params.status);
+    if (params?.meta) qs.set("meta", params.meta);
     const s = qs.toString();
     const query = s ? `?${s}` : "";
     const res = await client.rawRequest(`/api/v1/items/${collection}${query}`);
@@ -1564,9 +1673,11 @@ function jsonLdScript(item) {
   checkCdcPipelineHealth,
   createAgentArtifact,
   createAgentGoal,
+  createBookmark,
   createCdcPipeline,
   createLumiClient,
   decideAgentApproval,
+  deleteBookmark,
   deleteCdcPipeline,
   deployCdc,
   dryRunAccessImport,
@@ -1575,6 +1686,7 @@ function jsonLdScript(item) {
   extractSeo,
   generateAgentApp,
   generateTypes,
+  getEffectivePreset,
   graphql,
   importAccessManifest,
   jsonLdScript,
@@ -1584,7 +1696,9 @@ function jsonLdScript(item) {
   listAgentGoals,
   listAgentRuns,
   listAgentTools,
+  listBookmarks,
   listCdcPipelines,
+  mediaUrl,
   publishAgentArtifact,
   readAgentMemoryContext,
   readCdcPipeline,
@@ -1595,10 +1709,12 @@ function jsonLdScript(item) {
   retryAgentRun,
   rollbackAgentArtifact,
   rollbackCdcDeployment,
+  saveUserView,
   search,
   startCdcPipeline,
   stopCdcPipeline,
   toNextMetadata,
+  updateBookmark,
   updateCdcPipeline,
   validateCdcDeploymentEnv,
   writeAgentMemory

package/dist/index.d.cts

@@ -377,6 +377,12 @@ interface ListItemsParams {
     limit?: number;
     offset?: number;
     status?: string | null;
+    /**
+     * Controls whether the server computes the `count(*)` total. `'total_count'`
+     * (default) returns `meta.total`; `'none'` skips the extra aggregate query
+     * for a cheaper list (e.g. infinite scroll) and omits `meta.total`.
+     */
+    meta?: 'total_count' | 'none';
 }
 /** Reserved metadata attributes present on every search hit. */
 interface SearchHitMeta {
@@ -824,6 +830,38 @@ interface SettingResource {
     scope: string;
     updatedAt: string;
 }
+/** A named parallel draft branch of a content item (content-versioning). */
+interface ContentVersion {
+    id: string;
+    siteId: string;
+    itemId: string;
+    collectionId: string;
+    /** Stable slug, unique per item. */
+    key: string;
+    /** Human-readable label. */
+    name: string;
+    /** Snapshot of the item data for this branch. */
+    data: Record<string, unknown>;
+    /** Hash of main's data at snapshot time — detects divergence before promote. */
+    hash: string;
+    createdBy: string | null;
+    createdAt: string;
+    updatedAt: string;
+    /** True when main's data changed since this version branched (list only). */
+    mainChanged?: boolean;
+}
+/** One changed field between main and a version. */
+interface VersionFieldChange {
+    field: string;
+    main: unknown;
+    version: unknown;
+}
+/** `GET …/versions/:key/compare` payload. */
+interface VersionCompare {
+    main: Record<string, unknown>;
+    version: Record<string, unknown>;
+    changes: VersionFieldChange[];
+}
 /** Origin of a translation-memory entry. */
 type TmSource = "human" | "mt" | "imported";
 /** A stored translation-memory pair for a language pair. */
@@ -1630,6 +1668,21 @@ declare function legacyRest(): <TSchema extends DefaultSchema>(client: LumiClien
         releasePin: (id: string, field: string) => Promise<LumiResponse<{
             pinnedFields: string[];
         }>>;
+        versions: {
+            list: (id: string) => Promise<LumiResponse<ContentVersion[]>>;
+            create: (id: string, input: {
+                key: string;
+                name: string;
+            }) => Promise<LumiResponse<ContentVersion>>;
+            get: (id: string, key: string) => Promise<LumiResponse<ContentVersion>>;
+            update: (id: string, key: string, patch: {
+                data?: Record<string, unknown>;
+                name?: string;
+            }) => Promise<LumiResponse<ContentVersion>>;
+            delete: (id: string, key: string) => Promise<LumiResponse<null>>;
+            compare: (id: string, key: string) => Promise<LumiResponse<VersionCompare>>;
+            promote: (id: string, key: string) => Promise<LumiResponse<ItemRow<TSchema[TName] extends Record<string, unknown> ? TSchema[TName] : Record<string, unknown>>>>;
+        };
     };
     roles: {
         list: () => Promise<LumiResponse<RoleResource[]>>;
@@ -1950,6 +2003,66 @@ declare function legacyRest(): <TSchema extends DefaultSchema>(client: LumiClien
     request: <T>(path: string, init?: RequestInit) => Promise<LumiResponse<T>>;
 };
 
+/**
+ * SDK commands for view presets (presets-inheritance) and media transform URLs
+ * (image-transform-dsl). Each is a command factory `(client) => Promise<T>`
+ * used with `client.request(...)`, matching the rest of the REST module.
+ *
+ * Content-version and translation-memory helpers live in the core SDK
+ * (`client.items(...).versions` and `client.tm`).
+ */
+
+type PresetScope = "user" | "role" | "global";
+interface ViewPreset {
+    id: string;
+    bookmark: string | null;
+    collection: string;
+    userId: string | null;
+    roleId: string | null;
+    layout: string;
+    layoutQuery: Record<string, unknown>;
+    layoutOptions: Record<string, unknown>;
+    search: string | null;
+    filter: Record<string, unknown>;
+    icon: string | null;
+    color: string | null;
+    refreshInterval: number;
+}
+interface ScopedViewPreset extends ViewPreset {
+    sourceScope: PresetScope;
+    roleDistance?: number;
+}
+declare function getEffectivePreset(collection: string): (client: LumiClient) => Promise<ScopedViewPreset | null>;
+declare function listBookmarks(collection: string): (client: LumiClient) => Promise<ScopedViewPreset[]>;
+/** Save (or overwrite) the acting user's default view for a collection. */
+declare function saveUserView(input: Partial<ViewPreset> & {
+    collection: string;
+}): (client: LumiClient) => Promise<ViewPreset>;
+declare function createBookmark(input: Partial<ViewPreset> & {
+    collection: string;
+    bookmark: string;
+}): (client: LumiClient) => Promise<ViewPreset>;
+declare function updateBookmark(id: string, input: Partial<ViewPreset>): (client: LumiClient) => Promise<ViewPreset>;
+declare function deleteBookmark(id: string): (client: LumiClient) => Promise<null>;
+interface MediaTransform {
+    width?: number;
+    height?: number;
+    format?: "webp" | "avif" | "jpeg" | "png";
+    quality?: number;
+    fit?: "cover" | "contain" | "fill" | "inside" | "outside";
+}
+/**
+ * Build a delivery URL for a media asset, optionally with a transform. Pass a
+ * `MediaTransform` for inline params, or `{ preset }` to reference a named
+ * server-side preset. Returns a path relative to the API base — the SDK client
+ * resolves it against its configured URL.
+ */
+declare function mediaUrl(key: string, transform?: MediaTransform | {
+    preset: string;
+}, opts?: {
+    sign?: string;
+}): (client: LumiClient) => string;
+
 /**
  * Full-text search via `GET /api/v1/search`. Omit `params.collection` for a
  * cross-collection (global) search that fans out over every collection of the
@@ -2082,4 +2195,4 @@ declare function toNextMetadata(item: unknown): Record<string, unknown>;
  */
 declare function jsonLdScript(item: unknown): string | undefined;
 
-export { ACCESS_EXPORT_SCHEMA, type AIApproval, type AIApprovalStatus, type AIChatResponse, type AIChatStatus, type AIContentAssistResult, type AIConversation, type AIFieldSuggestion, type AIMessage, type AccessConflict, type AccessConflictCheckInput, type AccessConflictReport, type AccessExportApiKey, type AccessExportBindings, type AccessExportManifest, type AccessExportPermission, type AccessExportPolicy, type AccessExportRole, type AccessImportApplyResult, type AccessImportDiff, type AccessImportDiffEntry, type AccessImportDiffSection, type AccessImportDryRunResult, type AccessImportIssue, type AccessImportMode, type AccessImportOptions, type AccessImportSummary, type ActivityResource, type AgentApprovalResource, type AgentArtifactCreateInput, type AgentArtifactResource, type AgentArtifactType, type AgentEvaluationResource, type AgentGenerateAppInput, type AgentGenerateAppResult, type AgentGoalCreateInput, type AgentGoalResource, type AgentMemoryContext, type AgentMemoryResource, type AgentMemoryWriteInput, type AgentRiskLevel, type AgentRunResource, type AgentToolResource, type ApiKeyCreateInput, type ApiKeyPolicyAttachment, type ApiKeyResource, type ApiKeyRoleAttachment, type ApiKeyRotateInput, type ApiKeySecretResult, AudienceClient, type AudienceClientOptions, type AudienceEvent, type AudienceNotification, type Brand, type CdcConnectorType, type CdcDeployInput, type CdcDeploymentResult, type CdcDeploymentStatus, type CdcDeploymentStep, type CdcDeploymentTarget, type CdcEnvValidationResult, type CdcHealthCheckResult, type CdcHealthMetricEntry, type CdcPipelineCreateInput, type CdcPipelineMetrics, type CdcPipelinePatchInput, type CdcPipelineResource, type CdcPipelineStatus, type CdcRollbackResult, type CdcValidateEnvInput, type ChannelEventCallback, type CollectionInput, type CollectionResource, type CompiledPermission, type ConnectionStatus, type CreateSCIMTokenParams, type DefaultSchema, type DeliverySeo, type DeploymentResource, type DeploymentTargetResource, type DomainCreateInput, type DomainResource, type DomainVerificationRecord, type ExtensionResource, type FieldDeleteOptions, type FieldInput, type FieldMutationOptions, type FieldRenameInput, type FieldResource, type FileResource, type FlowGraph, type FlowNode, type FlowResource, type FlowRun, type FlowRunResult, type FlowRunStatus, type FlowStatus, type FlowTriggerType, type FolderResource, type GenerateOptions, type GraphQLExtension, type ID, type ItemFilter, type ItemFilterOp, type ItemRow, type ListItemsParams, type ListItemsResponse, type ListMarketplaceExtensionsParams, type Locale, type LumiClient, type LumiClientOptions, LumiError, type LumiErrorBody, type LumiResponse, type MarketplaceExtension, type MarketplaceListResponse, type MaterializeDataResponse, type MaterializeProjection, type MaterializeRefreshResult, type MaterializeRefreshStrategy, type MaterializedCollection, type NotificationCallback, type PermissionAction, type PermissionBundle, type PermissionCheckResult, type PermissionRow, type PolicyDetail, type PolicyResource, type PresenceCallback, type PresenceEntry, type PresetResource, type PrimaryKeyType, RealtimeClient, type RealtimeEvent, type RealtimeEventCallback, type RelationInput, type RelationResource, type RelationType, type RevisionRow, type RoleDetail, type RoleResource, type SCIMTokenCreated, type SCIMTokenMeta, type SCIMTokenRotated, type SchemaApplyInput, type SchemaApplyResult, type SchemaChangedEvent, type SchemaDiff, type SchemaDiffEntry, type SchemaDiffInput, type SchemaDiffRisk, type SchemaRuntimeImpact, type SearchHit, type SearchHitMeta, type SearchParams, type SearchResponse, type SettingResource, type ShareCreateInput, type ShareResource, type ShareSecretResult, type SiteConfigUpdate, type SiteResource, type StatusCallback, type StorageMode, type TeamMemberResource, type TeamResource, type TmEntry, type TmSource, type TmSuggestion, type TranslationResource, type TypegenCollection, type TypegenField, type TypegenManifest, type TypegenRelation, type TypegenSchemaFilters, type UploadConfigResource, type UploadTypeCatalogueEntry, type UserPreferencesPayload, type UserResource, type WebSocketFactory, type WebSocketLike, type WebhookResource, checkCdcPipelineHealth, createAgentArtifact, createAgentGoal, createCdcPipeline, createLumiClient, decideAgentApproval, deleteCdcPipeline, deployCdc, dryRunAccessImport, evaluateAgentArtifact, exportAccessManifest, extractSeo, generateAgentApp, generateTypes, graphql, importAccessManifest, jsonLdScript, legacyRest, listAgentApprovals, listAgentArtifacts, listAgentGoals, listAgentRuns, listAgentTools, listCdcPipelines, publishAgentArtifact, readAgentMemoryContext, readCdcPipeline, readCdcPipelineMetricHistory, readCdcPipelineMetrics, readItem, readItems, retryAgentRun, rollbackAgentArtifact, rollbackCdcDeployment, search, startCdcPipeline, stopCdcPipeline, toNextMetadata, updateCdcPipeline, validateCdcDeploymentEnv, writeAgentMemory };
+export { ACCESS_EXPORT_SCHEMA, type AIApproval, type AIApprovalStatus, type AIChatResponse, type AIChatStatus, type AIContentAssistResult, type AIConversation, type AIFieldSuggestion, type AIMessage, type AccessConflict, type AccessConflictCheckInput, type AccessConflictReport, type AccessExportApiKey, type AccessExportBindings, type AccessExportManifest, type AccessExportPermission, type AccessExportPolicy, type AccessExportRole, type AccessImportApplyResult, type AccessImportDiff, type AccessImportDiffEntry, type AccessImportDiffSection, type AccessImportDryRunResult, type AccessImportIssue, type AccessImportMode, type AccessImportOptions, type AccessImportSummary, type ActivityResource, type AgentApprovalResource, type AgentArtifactCreateInput, type AgentArtifactResource, type AgentArtifactType, type AgentEvaluationResource, type AgentGenerateAppInput, type AgentGenerateAppResult, type AgentGoalCreateInput, type AgentGoalResource, type AgentMemoryContext, type AgentMemoryResource, type AgentMemoryWriteInput, type AgentRiskLevel, type AgentRunResource, type AgentToolResource, type ApiKeyCreateInput, type ApiKeyPolicyAttachment, type ApiKeyResource, type ApiKeyRoleAttachment, type ApiKeyRotateInput, type ApiKeySecretResult, AudienceClient, type AudienceClientOptions, type AudienceEvent, type AudienceNotification, type Brand, type CdcConnectorType, type CdcDeployInput, type CdcDeploymentResult, type CdcDeploymentStatus, type CdcDeploymentStep, type CdcDeploymentTarget, type CdcEnvValidationResult, type CdcHealthCheckResult, type CdcHealthMetricEntry, type CdcPipelineCreateInput, type CdcPipelineMetrics, type CdcPipelinePatchInput, type CdcPipelineResource, type CdcPipelineStatus, type CdcRollbackResult, type CdcValidateEnvInput, type ChannelEventCallback, type CollectionInput, type CollectionResource, type CompiledPermission, type ConnectionStatus, type ContentVersion, type CreateSCIMTokenParams, type DefaultSchema, type DeliverySeo, type DeploymentResource, type DeploymentTargetResource, type DomainCreateInput, type DomainResource, type DomainVerificationRecord, type ExtensionResource, type FieldDeleteOptions, type FieldInput, type FieldMutationOptions, type FieldRenameInput, type FieldResource, type FileResource, type FlowGraph, type FlowNode, type FlowResource, type FlowRun, type FlowRunResult, type FlowRunStatus, type FlowStatus, type FlowTriggerType, type FolderResource, type GenerateOptions, type GraphQLExtension, type ID, type ItemFilter, type ItemFilterOp, type ItemRow, type ListItemsParams, type ListItemsResponse, type ListMarketplaceExtensionsParams, type Locale, type LumiClient, type LumiClientOptions, LumiError, type LumiErrorBody, type LumiResponse, type MarketplaceExtension, type MarketplaceListResponse, type MaterializeDataResponse, type MaterializeProjection, type MaterializeRefreshResult, type MaterializeRefreshStrategy, type MaterializedCollection, type MediaTransform, type NotificationCallback, type PermissionAction, type PermissionBundle, type PermissionCheckResult, type PermissionRow, type PolicyDetail, type PolicyResource, type PresenceCallback, type PresenceEntry, type PresetResource, type PresetScope, type PrimaryKeyType, RealtimeClient, type RealtimeEvent, type RealtimeEventCallback, type RelationInput, type RelationResource, type RelationType, type RevisionRow, type RoleDetail, type RoleResource, type SCIMTokenCreated, type SCIMTokenMeta, type SCIMTokenRotated, type SchemaApplyInput, type SchemaApplyResult, type SchemaChangedEvent, type SchemaDiff, type SchemaDiffEntry, type SchemaDiffInput, type SchemaDiffRisk, type SchemaRuntimeImpact, type ScopedViewPreset, type SearchHit, type SearchHitMeta, type SearchParams, type SearchResponse, type SettingResource, type ShareCreateInput, type ShareResource, type ShareSecretResult, type SiteConfigUpdate, type SiteResource, type StatusCallback, type StorageMode, type TeamMemberResource, type TeamResource, type TmEntry, type TmSource, type TmSuggestion, type TranslationResource, type TypegenCollection, type TypegenField, type TypegenManifest, type TypegenRelation, type TypegenSchemaFilters, type UploadConfigResource, type UploadTypeCatalogueEntry, type UserPreferencesPayload, type UserResource, type VersionCompare, type VersionFieldChange, type ViewPreset, type WebSocketFactory, type WebSocketLike, type WebhookResource, checkCdcPipelineHealth, createAgentArtifact, createAgentGoal, createBookmark, createCdcPipeline, createLumiClient, decideAgentApproval, deleteBookmark, deleteCdcPipeline, deployCdc, dryRunAccessImport, evaluateAgentArtifact, exportAccessManifest, extractSeo, generateAgentApp, generateTypes, getEffectivePreset, graphql, importAccessManifest, jsonLdScript, legacyRest, listAgentApprovals, listAgentArtifacts, listAgentGoals, listAgentRuns, listAgentTools, listBookmarks, listCdcPipelines, mediaUrl, publishAgentArtifact, readAgentMemoryContext, readCdcPipeline, readCdcPipelineMetricHistory, readCdcPipelineMetrics, readItem, readItems, retryAgentRun, rollbackAgentArtifact, rollbackCdcDeployment, saveUserView, search, startCdcPipeline, stopCdcPipeline, toNextMetadata, updateBookmark, updateCdcPipeline, validateCdcDeploymentEnv, writeAgentMemory };

package/dist/index.d.ts

@@ -377,6 +377,12 @@ interface ListItemsParams {
     limit?: number;
     offset?: number;
     status?: string | null;
+    /**
+     * Controls whether the server computes the `count(*)` total. `'total_count'`
+     * (default) returns `meta.total`; `'none'` skips the extra aggregate query
+     * for a cheaper list (e.g. infinite scroll) and omits `meta.total`.
+     */
+    meta?: 'total_count' | 'none';
 }
 /** Reserved metadata attributes present on every search hit. */
 interface SearchHitMeta {
@@ -824,6 +830,38 @@ interface SettingResource {
     scope: string;
     updatedAt: string;
 }
+/** A named parallel draft branch of a content item (content-versioning). */
+interface ContentVersion {
+    id: string;
+    siteId: string;
+    itemId: string;
+    collectionId: string;
+    /** Stable slug, unique per item. */
+    key: string;
+    /** Human-readable label. */
+    name: string;
+    /** Snapshot of the item data for this branch. */
+    data: Record<string, unknown>;
+    /** Hash of main's data at snapshot time — detects divergence before promote. */
+    hash: string;
+    createdBy: string | null;
+    createdAt: string;
+    updatedAt: string;
+    /** True when main's data changed since this version branched (list only). */
+    mainChanged?: boolean;
+}
+/** One changed field between main and a version. */
+interface VersionFieldChange {
+    field: string;
+    main: unknown;
+    version: unknown;
+}
+/** `GET …/versions/:key/compare` payload. */
+interface VersionCompare {
+    main: Record<string, unknown>;
+    version: Record<string, unknown>;
+    changes: VersionFieldChange[];
+}
 /** Origin of a translation-memory entry. */
 type TmSource = "human" | "mt" | "imported";
 /** A stored translation-memory pair for a language pair. */
@@ -1630,6 +1668,21 @@ declare function legacyRest(): <TSchema extends DefaultSchema>(client: LumiClien
         releasePin: (id: string, field: string) => Promise<LumiResponse<{
             pinnedFields: string[];
         }>>;
+        versions: {
+            list: (id: string) => Promise<LumiResponse<ContentVersion[]>>;
+            create: (id: string, input: {
+                key: string;
+                name: string;
+            }) => Promise<LumiResponse<ContentVersion>>;
+            get: (id: string, key: string) => Promise<LumiResponse<ContentVersion>>;
+            update: (id: string, key: string, patch: {
+                data?: Record<string, unknown>;
+                name?: string;
+            }) => Promise<LumiResponse<ContentVersion>>;
+            delete: (id: string, key: string) => Promise<LumiResponse<null>>;
+            compare: (id: string, key: string) => Promise<LumiResponse<VersionCompare>>;
+            promote: (id: string, key: string) => Promise<LumiResponse<ItemRow<TSchema[TName] extends Record<string, unknown> ? TSchema[TName] : Record<string, unknown>>>>;
+        };
     };
     roles: {
         list: () => Promise<LumiResponse<RoleResource[]>>;
@@ -1950,6 +2003,66 @@ declare function legacyRest(): <TSchema extends DefaultSchema>(client: LumiClien
     request: <T>(path: string, init?: RequestInit) => Promise<LumiResponse<T>>;
 };
 
+/**
+ * SDK commands for view presets (presets-inheritance) and media transform URLs
+ * (image-transform-dsl). Each is a command factory `(client) => Promise<T>`
+ * used with `client.request(...)`, matching the rest of the REST module.
+ *
+ * Content-version and translation-memory helpers live in the core SDK
+ * (`client.items(...).versions` and `client.tm`).
+ */
+
+type PresetScope = "user" | "role" | "global";
+interface ViewPreset {
+    id: string;
+    bookmark: string | null;
+    collection: string;
+    userId: string | null;
+    roleId: string | null;
+    layout: string;
+    layoutQuery: Record<string, unknown>;
+    layoutOptions: Record<string, unknown>;
+    search: string | null;
+    filter: Record<string, unknown>;
+    icon: string | null;
+    color: string | null;
+    refreshInterval: number;
+}
+interface ScopedViewPreset extends ViewPreset {
+    sourceScope: PresetScope;
+    roleDistance?: number;
+}
+declare function getEffectivePreset(collection: string): (client: LumiClient) => Promise<ScopedViewPreset | null>;
+declare function listBookmarks(collection: string): (client: LumiClient) => Promise<ScopedViewPreset[]>;
+/** Save (or overwrite) the acting user's default view for a collection. */
+declare function saveUserView(input: Partial<ViewPreset> & {
+    collection: string;
+}): (client: LumiClient) => Promise<ViewPreset>;
+declare function createBookmark(input: Partial<ViewPreset> & {
+    collection: string;
+    bookmark: string;
+}): (client: LumiClient) => Promise<ViewPreset>;
+declare function updateBookmark(id: string, input: Partial<ViewPreset>): (client: LumiClient) => Promise<ViewPreset>;
+declare function deleteBookmark(id: string): (client: LumiClient) => Promise<null>;
+interface MediaTransform {
+    width?: number;
+    height?: number;
+    format?: "webp" | "avif" | "jpeg" | "png";
+    quality?: number;
+    fit?: "cover" | "contain" | "fill" | "inside" | "outside";
+}
+/**
+ * Build a delivery URL for a media asset, optionally with a transform. Pass a
+ * `MediaTransform` for inline params, or `{ preset }` to reference a named
+ * server-side preset. Returns a path relative to the API base — the SDK client
+ * resolves it against its configured URL.
+ */
+declare function mediaUrl(key: string, transform?: MediaTransform | {
+    preset: string;
+}, opts?: {
+    sign?: string;
+}): (client: LumiClient) => string;
+
 /**
  * Full-text search via `GET /api/v1/search`. Omit `params.collection` for a
  * cross-collection (global) search that fans out over every collection of the
@@ -2082,4 +2195,4 @@ declare function toNextMetadata(item: unknown): Record<string, unknown>;
  */
 declare function jsonLdScript(item: unknown): string | undefined;
 
-export { ACCESS_EXPORT_SCHEMA, type AIApproval, type AIApprovalStatus, type AIChatResponse, type AIChatStatus, type AIContentAssistResult, type AIConversation, type AIFieldSuggestion, type AIMessage, type AccessConflict, type AccessConflictCheckInput, type AccessConflictReport, type AccessExportApiKey, type AccessExportBindings, type AccessExportManifest, type AccessExportPermission, type AccessExportPolicy, type AccessExportRole, type AccessImportApplyResult, type AccessImportDiff, type AccessImportDiffEntry, type AccessImportDiffSection, type AccessImportDryRunResult, type AccessImportIssue, type AccessImportMode, type AccessImportOptions, type AccessImportSummary, type ActivityResource, type AgentApprovalResource, type AgentArtifactCreateInput, type AgentArtifactResource, type AgentArtifactType, type AgentEvaluationResource, type AgentGenerateAppInput, type AgentGenerateAppResult, type AgentGoalCreateInput, type AgentGoalResource, type AgentMemoryContext, type AgentMemoryResource, type AgentMemoryWriteInput, type AgentRiskLevel, type AgentRunResource, type AgentToolResource, type ApiKeyCreateInput, type ApiKeyPolicyAttachment, type ApiKeyResource, type ApiKeyRoleAttachment, type ApiKeyRotateInput, type ApiKeySecretResult, AudienceClient, type AudienceClientOptions, type AudienceEvent, type AudienceNotification, type Brand, type CdcConnectorType, type CdcDeployInput, type CdcDeploymentResult, type CdcDeploymentStatus, type CdcDeploymentStep, type CdcDeploymentTarget, type CdcEnvValidationResult, type CdcHealthCheckResult, type CdcHealthMetricEntry, type CdcPipelineCreateInput, type CdcPipelineMetrics, type CdcPipelinePatchInput, type CdcPipelineResource, type CdcPipelineStatus, type CdcRollbackResult, type CdcValidateEnvInput, type ChannelEventCallback, type CollectionInput, type CollectionResource, type CompiledPermission, type ConnectionStatus, type CreateSCIMTokenParams, type DefaultSchema, type DeliverySeo, type DeploymentResource, type DeploymentTargetResource, type DomainCreateInput, type DomainResource, type DomainVerificationRecord, type ExtensionResource, type FieldDeleteOptions, type FieldInput, type FieldMutationOptions, type FieldRenameInput, type FieldResource, type FileResource, type FlowGraph, type FlowNode, type FlowResource, type FlowRun, type FlowRunResult, type FlowRunStatus, type FlowStatus, type FlowTriggerType, type FolderResource, type GenerateOptions, type GraphQLExtension, type ID, type ItemFilter, type ItemFilterOp, type ItemRow, type ListItemsParams, type ListItemsResponse, type ListMarketplaceExtensionsParams, type Locale, type LumiClient, type LumiClientOptions, LumiError, type LumiErrorBody, type LumiResponse, type MarketplaceExtension, type MarketplaceListResponse, type MaterializeDataResponse, type MaterializeProjection, type MaterializeRefreshResult, type MaterializeRefreshStrategy, type MaterializedCollection, type NotificationCallback, type PermissionAction, type PermissionBundle, type PermissionCheckResult, type PermissionRow, type PolicyDetail, type PolicyResource, type PresenceCallback, type PresenceEntry, type PresetResource, type PrimaryKeyType, RealtimeClient, type RealtimeEvent, type RealtimeEventCallback, type RelationInput, type RelationResource, type RelationType, type RevisionRow, type RoleDetail, type RoleResource, type SCIMTokenCreated, type SCIMTokenMeta, type SCIMTokenRotated, type SchemaApplyInput, type SchemaApplyResult, type SchemaChangedEvent, type SchemaDiff, type SchemaDiffEntry, type SchemaDiffInput, type SchemaDiffRisk, type SchemaRuntimeImpact, type SearchHit, type SearchHitMeta, type SearchParams, type SearchResponse, type SettingResource, type ShareCreateInput, type ShareResource, type ShareSecretResult, type SiteConfigUpdate, type SiteResource, type StatusCallback, type StorageMode, type TeamMemberResource, type TeamResource, type TmEntry, type TmSource, type TmSuggestion, type TranslationResource, type TypegenCollection, type TypegenField, type TypegenManifest, type TypegenRelation, type TypegenSchemaFilters, type UploadConfigResource, type UploadTypeCatalogueEntry, type UserPreferencesPayload, type UserResource, type WebSocketFactory, type WebSocketLike, type WebhookResource, checkCdcPipelineHealth, createAgentArtifact, createAgentGoal, createCdcPipeline, createLumiClient, decideAgentApproval, deleteCdcPipeline, deployCdc, dryRunAccessImport, evaluateAgentArtifact, exportAccessManifest, extractSeo, generateAgentApp, generateTypes, graphql, importAccessManifest, jsonLdScript, legacyRest, listAgentApprovals, listAgentArtifacts, listAgentGoals, listAgentRuns, listAgentTools, listCdcPipelines, publishAgentArtifact, readAgentMemoryContext, readCdcPipeline, readCdcPipelineMetricHistory, readCdcPipelineMetrics, readItem, readItems, retryAgentRun, rollbackAgentArtifact, rollbackCdcDeployment, search, startCdcPipeline, stopCdcPipeline, toNextMetadata, updateCdcPipeline, validateCdcDeploymentEnv, writeAgentMemory };
+export { ACCESS_EXPORT_SCHEMA, type AIApproval, type AIApprovalStatus, type AIChatResponse, type AIChatStatus, type AIContentAssistResult, type AIConversation, type AIFieldSuggestion, type AIMessage, type AccessConflict, type AccessConflictCheckInput, type AccessConflictReport, type AccessExportApiKey, type AccessExportBindings, type AccessExportManifest, type AccessExportPermission, type AccessExportPolicy, type AccessExportRole, type AccessImportApplyResult, type AccessImportDiff, type AccessImportDiffEntry, type AccessImportDiffSection, type AccessImportDryRunResult, type AccessImportIssue, type AccessImportMode, type AccessImportOptions, type AccessImportSummary, type ActivityResource, type AgentApprovalResource, type AgentArtifactCreateInput, type AgentArtifactResource, type AgentArtifactType, type AgentEvaluationResource, type AgentGenerateAppInput, type AgentGenerateAppResult, type AgentGoalCreateInput, type AgentGoalResource, type AgentMemoryContext, type AgentMemoryResource, type AgentMemoryWriteInput, type AgentRiskLevel, type AgentRunResource, type AgentToolResource, type ApiKeyCreateInput, type ApiKeyPolicyAttachment, type ApiKeyResource, type ApiKeyRoleAttachment, type ApiKeyRotateInput, type ApiKeySecretResult, AudienceClient, type AudienceClientOptions, type AudienceEvent, type AudienceNotification, type Brand, type CdcConnectorType, type CdcDeployInput, type CdcDeploymentResult, type CdcDeploymentStatus, type CdcDeploymentStep, type CdcDeploymentTarget, type CdcEnvValidationResult, type CdcHealthCheckResult, type CdcHealthMetricEntry, type CdcPipelineCreateInput, type CdcPipelineMetrics, type CdcPipelinePatchInput, type CdcPipelineResource, type CdcPipelineStatus, type CdcRollbackResult, type CdcValidateEnvInput, type ChannelEventCallback, type CollectionInput, type CollectionResource, type CompiledPermission, type ConnectionStatus, type ContentVersion, type CreateSCIMTokenParams, type DefaultSchema, type DeliverySeo, type DeploymentResource, type DeploymentTargetResource, type DomainCreateInput, type DomainResource, type DomainVerificationRecord, type ExtensionResource, type FieldDeleteOptions, type FieldInput, type FieldMutationOptions, type FieldRenameInput, type FieldResource, type FileResource, type FlowGraph, type FlowNode, type FlowResource, type FlowRun, type FlowRunResult, type FlowRunStatus, type FlowStatus, type FlowTriggerType, type FolderResource, type GenerateOptions, type GraphQLExtension, type ID, type ItemFilter, type ItemFilterOp, type ItemRow, type ListItemsParams, type ListItemsResponse, type ListMarketplaceExtensionsParams, type Locale, type LumiClient, type LumiClientOptions, LumiError, type LumiErrorBody, type LumiResponse, type MarketplaceExtension, type MarketplaceListResponse, type MaterializeDataResponse, type MaterializeProjection, type MaterializeRefreshResult, type MaterializeRefreshStrategy, type MaterializedCollection, type MediaTransform, type NotificationCallback, type PermissionAction, type PermissionBundle, type PermissionCheckResult, type PermissionRow, type PolicyDetail, type PolicyResource, type PresenceCallback, type PresenceEntry, type PresetResource, type PresetScope, type PrimaryKeyType, RealtimeClient, type RealtimeEvent, type RealtimeEventCallback, type RelationInput, type RelationResource, type RelationType, type RevisionRow, type RoleDetail, type RoleResource, type SCIMTokenCreated, type SCIMTokenMeta, type SCIMTokenRotated, type SchemaApplyInput, type SchemaApplyResult, type SchemaChangedEvent, type SchemaDiff, type SchemaDiffEntry, type SchemaDiffInput, type SchemaDiffRisk, type SchemaRuntimeImpact, type ScopedViewPreset, type SearchHit, type SearchHitMeta, type SearchParams, type SearchResponse, type SettingResource, type ShareCreateInput, type ShareResource, type ShareSecretResult, type SiteConfigUpdate, type SiteResource, type StatusCallback, type StorageMode, type TeamMemberResource, type TeamResource, type TmEntry, type TmSource, type TmSuggestion, type TranslationResource, type TypegenCollection, type TypegenField, type TypegenManifest, type TypegenRelation, type TypegenSchemaFilters, type UploadConfigResource, type UploadTypeCatalogueEntry, type UserPreferencesPayload, type UserResource, type VersionCompare, type VersionFieldChange, type ViewPreset, type WebSocketFactory, type WebSocketLike, type WebhookResource, checkCdcPipelineHealth, createAgentArtifact, createAgentGoal, createBookmark, createCdcPipeline, createLumiClient, decideAgentApproval, deleteBookmark, deleteCdcPipeline, deployCdc, dryRunAccessImport, evaluateAgentArtifact, exportAccessManifest, extractSeo, generateAgentApp, generateTypes, getEffectivePreset, graphql, importAccessManifest, jsonLdScript, legacyRest, listAgentApprovals, listAgentArtifacts, listAgentGoals, listAgentRuns, listAgentTools, listBookmarks, listCdcPipelines, mediaUrl, publishAgentArtifact, readAgentMemoryContext, readCdcPipeline, readCdcPipelineMetricHistory, readCdcPipelineMetrics, readItem, readItems, retryAgentRun, rollbackAgentArtifact, rollbackCdcDeployment, saveUserView, search, startCdcPipeline, stopCdcPipeline, toNextMetadata, updateBookmark, updateCdcPipeline, validateCdcDeploymentEnv, writeAgentMemory };

package/dist/index.js

@@ -586,7 +586,35 @@ function legacyRest() {
         releasePin: (id, field) => client.rawRequest(
           `${base}/${id}/pins/${encodeURIComponent(field)}`,
           { method: "DELETE" }
-        )
+        ),
+        // Content versions — named parallel draft branches (content-versioning).
+        versions: {
+          list: (id) => client.rawRequest(`${base}/${id}/versions`),
+          create: (id, input) => client.rawRequest(`${base}/${id}/versions`, {
+            method: "POST",
+            body: JSON.stringify(input)
+          }),
+          get: (id, key) => client.rawRequest(
+            `${base}/${id}/versions/${encodeURIComponent(key)}`
+          ),
+          update: (id, key, patch) => client.rawRequest(
+            `${base}/${id}/versions/${encodeURIComponent(key)}`,
+            { method: "PATCH", body: JSON.stringify(patch) }
+          ),
+          delete: (id, key) => client.rawRequest(
+            `${base}/${id}/versions/${encodeURIComponent(key)}`,
+            { method: "DELETE" }
+          ),
+          compare: (id, key) => client.rawRequest(
+            `${base}/${id}/versions/${encodeURIComponent(key)}/compare`
+          ),
+          // Returns the promoted item; `meta.mainDiverged` flags that main
+          // changed after the branch was cut (review advised).
+          promote: (id, key) => client.rawRequest(
+            `${base}/${id}/versions/${encodeURIComponent(key)}/promote`,
+            { method: "POST" }
+          )
+        }
       };
     }
     const roles = {
@@ -1020,6 +1048,79 @@ function legacyRest() {
   };
 }
 
+// src/rest/gaps.ts
+function getEffectivePreset(collection) {
+  return async (client) => {
+    const res = await client.rawRequest(
+      `/api/v1/presets/effective?collection=${encodeURIComponent(collection)}`
+    );
+    return res.data;
+  };
+}
+function listBookmarks(collection) {
+  return async (client) => {
+    const res = await client.rawRequest(
+      `/api/v1/presets/bookmarks?collection=${encodeURIComponent(collection)}`
+    );
+    return res.data;
+  };
+}
+function saveUserView(input) {
+  return async (client) => {
+    const res = await client.rawRequest("/api/v1/presets", {
+      method: "POST",
+      body: JSON.stringify({ ...input, bookmark: null })
+    });
+    return res.data;
+  };
+}
+function createBookmark(input) {
+  return async (client) => {
+    const res = await client.rawRequest("/api/v1/presets", {
+      method: "POST",
+      body: JSON.stringify(input)
+    });
+    return res.data;
+  };
+}
+function updateBookmark(id, input) {
+  return async (client) => {
+    const res = await client.rawRequest(`/api/v1/presets/${encodeURIComponent(id)}`, {
+      method: "PATCH",
+      body: JSON.stringify(input)
+    });
+    return res.data;
+  };
+}
+function deleteBookmark(id) {
+  return async (client) => {
+    const res = await client.rawRequest(`/api/v1/presets/${encodeURIComponent(id)}`, {
+      method: "DELETE"
+    });
+    return res.data;
+  };
+}
+function mediaUrl(key, transform, opts) {
+  return (client) => {
+    const base = client.url.replace(/\/$/, "");
+    const path = `/api/v1/media/${key.split("/").map(encodeURIComponent).join("/")}`;
+    if (!transform) return `${base}${path}`;
+    const qs = new URLSearchParams();
+    if ("preset" in transform) {
+      qs.set("preset", transform.preset);
+    } else {
+      if (transform.width !== void 0) qs.set("width", String(transform.width));
+      if (transform.height !== void 0) qs.set("height", String(transform.height));
+      if (transform.format) qs.set("format", transform.format);
+      if (transform.quality !== void 0) qs.set("quality", String(transform.quality));
+      if (transform.fit) qs.set("fit", transform.fit);
+      if (opts?.sign) qs.set("sig", opts.sign);
+    }
+    const query = qs.toString();
+    return query ? `${base}${path}?${query}` : `${base}${path}`;
+  };
+}
+
 // src/rest/index.ts
 function search(query, params) {
   return async (client) => {
@@ -1043,6 +1144,7 @@ function readItems(collection, params) {
     if (params?.limit !== void 0) qs.set("limit", String(params.limit));
     if (params?.offset !== void 0) qs.set("offset", String(params.offset));
     if (params?.status) qs.set("status", params.status);
+    if (params?.meta) qs.set("meta", params.meta);
     const s = qs.toString();
     const query = s ? `?${s}` : "";
     const res = await client.rawRequest(`/api/v1/items/${collection}${query}`);
@@ -1493,9 +1595,11 @@ export {
   checkCdcPipelineHealth,
   createAgentArtifact,
   createAgentGoal,
+  createBookmark,
   createCdcPipeline,
   createLumiClient,
   decideAgentApproval,
+  deleteBookmark,
   deleteCdcPipeline,
   deployCdc,
   dryRunAccessImport,
@@ -1504,6 +1608,7 @@ export {
   extractSeo,
   generateAgentApp,
   generateTypes,
+  getEffectivePreset,
   graphql,
   importAccessManifest,
   jsonLdScript,
@@ -1513,7 +1618,9 @@ export {
   listAgentGoals,
   listAgentRuns,
   listAgentTools,
+  listBookmarks,
   listCdcPipelines,
+  mediaUrl,
   publishAgentArtifact,
   readAgentMemoryContext,
   readCdcPipeline,
@@ -1524,10 +1631,12 @@ export {
   retryAgentRun,
   rollbackAgentArtifact,
   rollbackCdcDeployment,
+  saveUserView,
   search,
   startCdcPipeline,
   stopCdcPipeline,
   toNextMetadata,
+  updateBookmark,
   updateCdcPipeline,
   validateCdcDeploymentEnv,
   writeAgentMemory

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumibase/sdk",
-  "version": "0.18.0",
+  "version": "0.20.0",
   "description": "LumiBase JS SDK (REST + WebSocket) + typegen core. Isomorphic ESM.",
   "type": "module",
   "repository": {
@@ -23,7 +23,7 @@
   "devDependencies": {
     "tsup": "^8.5.1",
     "typescript": "^5.6.2",
-    "vitest": "^3.2.6"
+    "vitest": "^4.1.10"
   },
   "files": [
     "dist"