@lumibase/sdk 0.11.0 → 0.13.0

package/dist/index.cjs

@@ -57,6 +57,7 @@ __export(index_exports, {
   retryAgentRun: () => retryAgentRun,
   rollbackAgentArtifact: () => rollbackAgentArtifact,
   rollbackCdcDeployment: () => rollbackCdcDeployment,
+  search: () => search,
   startCdcPipeline: () => startCdcPipeline,
   stopCdcPipeline: () => stopCdcPipeline,
   toNextMetadata: () => toNextMetadata,
@@ -454,7 +455,6 @@ function legacyRest() {
         if (params.offset !== void 0)
           qs.set("offset", String(params.offset));
         if (params.status) qs.set("status", params.status);
-        if (params.search) qs.set("search", params.search);
         const s = qs.toString();
         return s ? `?${s}` : "";
       }
@@ -768,6 +768,41 @@ function legacyRest() {
         method: "POST"
       })
     };
+    const me = {
+      getPreferences: () => client.rawRequest("/api/v1/me/preferences"),
+      updatePreferences: (patch) => client.rawRequest("/api/v1/me/preferences", {
+        method: "PATCH",
+        body: JSON.stringify(patch)
+      })
+    };
+    const deployments = {
+      targets: {
+        list: () => client.rawRequest("/api/v1/deployments/targets"),
+        create: (input) => client.rawRequest("/api/v1/deployments/targets", {
+          method: "POST",
+          body: JSON.stringify(input)
+        }),
+        update: (id, patch) => client.rawRequest(`/api/v1/deployments/targets/${id}`, {
+          method: "PATCH",
+          body: JSON.stringify(patch)
+        }),
+        delete: (id) => client.rawRequest(`/api/v1/deployments/targets/${id}`, { method: "DELETE" }),
+        deploy: (id, input = {}) => client.rawRequest(`/api/v1/deployments/targets/${id}/deploy`, {
+          method: "POST",
+          body: JSON.stringify(input)
+        })
+      },
+      list: (params) => {
+        const qs = new URLSearchParams();
+        if (params?.targetId) qs.set("targetId", params.targetId);
+        if (params?.status) qs.set("status", params.status);
+        const suffix = qs.toString() ? `?${qs.toString()}` : "";
+        return client.rawRequest(`/api/v1/deployments${suffix}`);
+      },
+      get: (id) => client.rawRequest(`/api/v1/deployments/${id}`),
+      logs: (id) => client.rawRequest(`/api/v1/deployments/${id}/logs`),
+      refresh: (id) => client.rawRequest(`/api/v1/deployments/${id}/refresh`, { method: "POST" })
+    };
     return {
       schema,
       items,
@@ -776,6 +811,7 @@ function legacyRest() {
       access,
       apiKeys,
       shares,
+      me,
       permissions,
       presets,
       translations,
@@ -788,6 +824,7 @@ function legacyRest() {
       webhooks,
       activity,
       extensions,
+      deployments,
       realtime: {
         /**
          * Create a RealtimeClient for the current site.
@@ -826,6 +863,19 @@ function legacyRest() {
 }
 
 // src/rest/index.ts
+function search(query, params) {
+  return async (client) => {
+    const qs = new URLSearchParams();
+    qs.set("q", query);
+    if (params?.collection) qs.set("collection", params.collection);
+    if (params?.filter) qs.set("filter", params.filter);
+    if (params?.sort?.length) qs.set("sort", params.sort.join(","));
+    if (params?.limit !== void 0) qs.set("limit", String(params.limit));
+    if (params?.offset !== void 0) qs.set("offset", String(params.offset));
+    const res = await client.rawRequest(`/api/v1/search?${qs.toString()}`);
+    return res;
+  };
+}
 function readItems(collection, params) {
   return async (client) => {
     const qs = new URLSearchParams();
@@ -835,7 +885,6 @@ 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?.search) qs.set("search", params.search);
     const s = qs.toString();
     const query = s ? `?${s}` : "";
     const res = await client.rawRequest(`/api/v1/items/${collection}${query}`);
@@ -1317,6 +1366,7 @@ function jsonLdScript(item) {
   retryAgentRun,
   rollbackAgentArtifact,
   rollbackCdcDeployment,
+  search,
   startCdcPipeline,
   stopCdcPipeline,
   toNextMetadata,

package/dist/index.d.cts

@@ -376,7 +376,42 @@ interface ListItemsParams {
     limit?: number;
     offset?: number;
     status?: string | null;
-    search?: string;
+}
+/** Reserved metadata attributes present on every search hit. */
+interface SearchHitMeta {
+    /** Which collection the hit belongs to. */
+    _collection?: string;
+    /** Human-readable display title derived at index time. */
+    _title?: string;
+    /** Item update timestamp, if available. */
+    _updatedAt?: string | number;
+}
+type SearchHit = SearchHitMeta & Record<string, unknown>;
+interface SearchParams {
+    /** Restrict to one collection. Omit for cross-collection (global) search. */
+    collection?: string;
+    /** MeiliSearch filter expression. */
+    filter?: string;
+    /** Sort directives, e.g. `["_updatedAt:desc"]`. */
+    sort?: string[];
+    limit?: number;
+    offset?: number;
+}
+interface SearchResponse {
+    data: SearchHit[];
+    meta: {
+        query: string;
+        limit: number;
+        offset: number;
+        totalHits?: number;
+        processingTimeMs?: number;
+        /** Single-collection search: the collection searched. */
+        collection?: string;
+        /** Cross-collection search: the collections fanned out over. */
+        collections?: string[];
+        /** Cross-collection search: true when the collection set was capped. */
+        truncated?: boolean;
+    };
 }
 interface ItemRow<TData extends Record<string, unknown> = Record<string, unknown>> {
     id: string;
@@ -1170,6 +1205,37 @@ interface CreateSCIMTokenParams {
     /** Number of days until expiry. Default: 90. Max: 365. */
     lifespanDays?: number;
 }
+/** Deployment integrations (spec: deployment-integrations). Token never serialized. */
+interface DeploymentTargetResource {
+    id: string;
+    provider: "vercel" | "netlify";
+    name: string;
+    projectId: string;
+    defaultBranch: string | null;
+    productionUrl: string | null;
+    status: string;
+    createdAt: string;
+    updatedAt: string;
+}
+interface DeploymentResource {
+    id: string;
+    siteId: string;
+    targetId: string;
+    provider: string;
+    providerDeploymentId: string | null;
+    status: "queued" | "building" | "ready" | "error" | "canceled";
+    branch: string | null;
+    commitSha: string | null;
+    commitMessage: string | null;
+    url: string | null;
+    triggeredBy: string | null;
+    triggerSource: "manual" | "auto" | "agent";
+    errorMessage: string | null;
+    logExcerpt: string | null;
+    createdAt: string;
+    updatedAt: string;
+    completedAt: string | null;
+}
 
 /**
  * LumiBase JS SDK
@@ -1319,6 +1385,19 @@ declare class RealtimeClient {
     private _sendRaw;
 }
 
+/**
+ * Loose shape for `users.preferences`. The CMS validates the strict schema
+ * (`@lumibase/shared/schemas#UserPreferences`); the SDK stays decoupled and
+ * passes the blob through, so callers keep full type-safety on the Studio side
+ * where the shared schema is imported.
+ */
+interface UserPreferencesPayload {
+    language?: string;
+    theme?: "auto" | "light" | "dark";
+    timezone?: string;
+    keybindings?: Record<string, string>;
+    [key: string]: unknown;
+}
 declare function legacyRest(): <TSchema extends DefaultSchema>(client: LumiClient<TSchema>) => {
     schema: {
         collections: {
@@ -1479,6 +1558,10 @@ declare function legacyRest(): <TSchema extends DefaultSchema>(client: LumiClien
         create: (input: ShareCreateInput) => Promise<LumiResponse<ShareSecretResult>>;
         revoke: (id: string) => Promise<LumiResponse<ShareResource>>;
     };
+    me: {
+        getPreferences: () => Promise<LumiResponse<UserPreferencesPayload>>;
+        updatePreferences: (patch: UserPreferencesPayload) => Promise<LumiResponse<UserPreferencesPayload>>;
+    };
     permissions: {
         me: () => Promise<LumiResponse<PermissionBundle>>;
         check: (input: {
@@ -1598,6 +1681,27 @@ declare function legacyRest(): <TSchema extends DefaultSchema>(client: LumiClien
         update: (id: string, patch: Record<string, unknown>) => Promise<LumiResponse<ExtensionResource>>;
         delete: (id: string) => Promise<LumiResponse<null>>;
     };
+    deployments: {
+        targets: {
+            list: () => Promise<LumiResponse<DeploymentTargetResource[]>>;
+            create: (input: Record<string, unknown>) => Promise<LumiResponse<DeploymentTargetResource>>;
+            update: (id: string, patch: Record<string, unknown>) => Promise<LumiResponse<DeploymentTargetResource>>;
+            delete: (id: string) => Promise<LumiResponse<null>>;
+            deploy: (id: string, input?: {
+                branch?: string;
+                reason?: string;
+            }) => Promise<LumiResponse<DeploymentResource>>;
+        };
+        list: (params?: {
+            targetId?: string;
+            status?: string;
+        }) => Promise<LumiResponse<DeploymentResource[]>>;
+        get: (id: string) => Promise<LumiResponse<DeploymentResource>>;
+        logs: (id: string) => Promise<LumiResponse<{
+            log: string;
+        }>>;
+        refresh: (id: string) => Promise<LumiResponse<DeploymentResource>>;
+    };
     realtime: {
         /**
          * Create a RealtimeClient for the current site.
@@ -1625,6 +1729,13 @@ declare function legacyRest(): <TSchema extends DefaultSchema>(client: LumiClien
     request: <T>(path: string, init?: RequestInit) => Promise<LumiResponse<T>>;
 };
 
+/**
+ * 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
+ * current site; pass it to scope to one collection. Diacritics-insensitive
+ * matching (e.g. "ha noi" → "Hà Nội") is handled server-side by MeiliSearch.
+ */
+declare function search<Schema extends DefaultSchema>(query: string, params?: SearchParams): (client: LumiClient<Schema>) => Promise<SearchResponse>;
 declare function readItems<Schema extends DefaultSchema, Collection extends keyof Schema & string, Row = ItemRow<Schema[Collection] extends Record<string, unknown> ? Schema[Collection] : Record<string, unknown>>, ListResp = ListItemsResponse<Schema[Collection] extends Record<string, unknown> ? Schema[Collection] : Record<string, unknown>>>(collection: Collection, params?: ListItemsParams): (client: LumiClient<Schema>) => Promise<ListResp>;
 declare function readItem<Schema extends DefaultSchema, Collection extends keyof Schema & string, Row = ItemRow<Schema[Collection] extends Record<string, unknown> ? Schema[Collection] : Record<string, unknown>>>(collection: Collection, id: string, fields?: string[]): (client: LumiClient<Schema>) => Promise<Row>;
 declare function exportAccessManifest(): (client: LumiClient) => Promise<AccessExportManifest>;
@@ -1750,4 +1861,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, 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 CollectionInput, type CollectionResource, type CompiledPermission, type CreateSCIMTokenParams, type DefaultSchema, type DeliverySeo, 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 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 SettingResource, type ShareCreateInput, type ShareResource, type ShareSecretResult, type SiteConfigUpdate, type SiteResource, type StorageMode, type TeamMemberResource, type TeamResource, type TranslationResource, type TypegenCollection, type TypegenField, type TypegenManifest, type TypegenRelation, type TypegenSchemaFilters, type UserResource, 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, 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, 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 CollectionInput, type CollectionResource, type CompiledPermission, type CreateSCIMTokenParams, type DefaultSchema, type DeliverySeo, type DeploymentResource, type DeploymentTargetResource, 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 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 StorageMode, type TeamMemberResource, type TeamResource, type TranslationResource, type TypegenCollection, type TypegenField, type TypegenManifest, type TypegenRelation, type TypegenSchemaFilters, type UserPreferencesPayload, type UserResource, 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 };

package/dist/index.d.ts

@@ -376,7 +376,42 @@ interface ListItemsParams {
     limit?: number;
     offset?: number;
     status?: string | null;
-    search?: string;
+}
+/** Reserved metadata attributes present on every search hit. */
+interface SearchHitMeta {
+    /** Which collection the hit belongs to. */
+    _collection?: string;
+    /** Human-readable display title derived at index time. */
+    _title?: string;
+    /** Item update timestamp, if available. */
+    _updatedAt?: string | number;
+}
+type SearchHit = SearchHitMeta & Record<string, unknown>;
+interface SearchParams {
+    /** Restrict to one collection. Omit for cross-collection (global) search. */
+    collection?: string;
+    /** MeiliSearch filter expression. */
+    filter?: string;
+    /** Sort directives, e.g. `["_updatedAt:desc"]`. */
+    sort?: string[];
+    limit?: number;
+    offset?: number;
+}
+interface SearchResponse {
+    data: SearchHit[];
+    meta: {
+        query: string;
+        limit: number;
+        offset: number;
+        totalHits?: number;
+        processingTimeMs?: number;
+        /** Single-collection search: the collection searched. */
+        collection?: string;
+        /** Cross-collection search: the collections fanned out over. */
+        collections?: string[];
+        /** Cross-collection search: true when the collection set was capped. */
+        truncated?: boolean;
+    };
 }
 interface ItemRow<TData extends Record<string, unknown> = Record<string, unknown>> {
     id: string;
@@ -1170,6 +1205,37 @@ interface CreateSCIMTokenParams {
     /** Number of days until expiry. Default: 90. Max: 365. */
     lifespanDays?: number;
 }
+/** Deployment integrations (spec: deployment-integrations). Token never serialized. */
+interface DeploymentTargetResource {
+    id: string;
+    provider: "vercel" | "netlify";
+    name: string;
+    projectId: string;
+    defaultBranch: string | null;
+    productionUrl: string | null;
+    status: string;
+    createdAt: string;
+    updatedAt: string;
+}
+interface DeploymentResource {
+    id: string;
+    siteId: string;
+    targetId: string;
+    provider: string;
+    providerDeploymentId: string | null;
+    status: "queued" | "building" | "ready" | "error" | "canceled";
+    branch: string | null;
+    commitSha: string | null;
+    commitMessage: string | null;
+    url: string | null;
+    triggeredBy: string | null;
+    triggerSource: "manual" | "auto" | "agent";
+    errorMessage: string | null;
+    logExcerpt: string | null;
+    createdAt: string;
+    updatedAt: string;
+    completedAt: string | null;
+}
 
 /**
  * LumiBase JS SDK
@@ -1319,6 +1385,19 @@ declare class RealtimeClient {
     private _sendRaw;
 }
 
+/**
+ * Loose shape for `users.preferences`. The CMS validates the strict schema
+ * (`@lumibase/shared/schemas#UserPreferences`); the SDK stays decoupled and
+ * passes the blob through, so callers keep full type-safety on the Studio side
+ * where the shared schema is imported.
+ */
+interface UserPreferencesPayload {
+    language?: string;
+    theme?: "auto" | "light" | "dark";
+    timezone?: string;
+    keybindings?: Record<string, string>;
+    [key: string]: unknown;
+}
 declare function legacyRest(): <TSchema extends DefaultSchema>(client: LumiClient<TSchema>) => {
     schema: {
         collections: {
@@ -1479,6 +1558,10 @@ declare function legacyRest(): <TSchema extends DefaultSchema>(client: LumiClien
         create: (input: ShareCreateInput) => Promise<LumiResponse<ShareSecretResult>>;
         revoke: (id: string) => Promise<LumiResponse<ShareResource>>;
     };
+    me: {
+        getPreferences: () => Promise<LumiResponse<UserPreferencesPayload>>;
+        updatePreferences: (patch: UserPreferencesPayload) => Promise<LumiResponse<UserPreferencesPayload>>;
+    };
     permissions: {
         me: () => Promise<LumiResponse<PermissionBundle>>;
         check: (input: {
@@ -1598,6 +1681,27 @@ declare function legacyRest(): <TSchema extends DefaultSchema>(client: LumiClien
         update: (id: string, patch: Record<string, unknown>) => Promise<LumiResponse<ExtensionResource>>;
         delete: (id: string) => Promise<LumiResponse<null>>;
     };
+    deployments: {
+        targets: {
+            list: () => Promise<LumiResponse<DeploymentTargetResource[]>>;
+            create: (input: Record<string, unknown>) => Promise<LumiResponse<DeploymentTargetResource>>;
+            update: (id: string, patch: Record<string, unknown>) => Promise<LumiResponse<DeploymentTargetResource>>;
+            delete: (id: string) => Promise<LumiResponse<null>>;
+            deploy: (id: string, input?: {
+                branch?: string;
+                reason?: string;
+            }) => Promise<LumiResponse<DeploymentResource>>;
+        };
+        list: (params?: {
+            targetId?: string;
+            status?: string;
+        }) => Promise<LumiResponse<DeploymentResource[]>>;
+        get: (id: string) => Promise<LumiResponse<DeploymentResource>>;
+        logs: (id: string) => Promise<LumiResponse<{
+            log: string;
+        }>>;
+        refresh: (id: string) => Promise<LumiResponse<DeploymentResource>>;
+    };
     realtime: {
         /**
          * Create a RealtimeClient for the current site.
@@ -1625,6 +1729,13 @@ declare function legacyRest(): <TSchema extends DefaultSchema>(client: LumiClien
     request: <T>(path: string, init?: RequestInit) => Promise<LumiResponse<T>>;
 };
 
+/**
+ * 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
+ * current site; pass it to scope to one collection. Diacritics-insensitive
+ * matching (e.g. "ha noi" → "Hà Nội") is handled server-side by MeiliSearch.
+ */
+declare function search<Schema extends DefaultSchema>(query: string, params?: SearchParams): (client: LumiClient<Schema>) => Promise<SearchResponse>;
 declare function readItems<Schema extends DefaultSchema, Collection extends keyof Schema & string, Row = ItemRow<Schema[Collection] extends Record<string, unknown> ? Schema[Collection] : Record<string, unknown>>, ListResp = ListItemsResponse<Schema[Collection] extends Record<string, unknown> ? Schema[Collection] : Record<string, unknown>>>(collection: Collection, params?: ListItemsParams): (client: LumiClient<Schema>) => Promise<ListResp>;
 declare function readItem<Schema extends DefaultSchema, Collection extends keyof Schema & string, Row = ItemRow<Schema[Collection] extends Record<string, unknown> ? Schema[Collection] : Record<string, unknown>>>(collection: Collection, id: string, fields?: string[]): (client: LumiClient<Schema>) => Promise<Row>;
 declare function exportAccessManifest(): (client: LumiClient) => Promise<AccessExportManifest>;
@@ -1750,4 +1861,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, 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 CollectionInput, type CollectionResource, type CompiledPermission, type CreateSCIMTokenParams, type DefaultSchema, type DeliverySeo, 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 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 SettingResource, type ShareCreateInput, type ShareResource, type ShareSecretResult, type SiteConfigUpdate, type SiteResource, type StorageMode, type TeamMemberResource, type TeamResource, type TranslationResource, type TypegenCollection, type TypegenField, type TypegenManifest, type TypegenRelation, type TypegenSchemaFilters, type UserResource, 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, 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, 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 CollectionInput, type CollectionResource, type CompiledPermission, type CreateSCIMTokenParams, type DefaultSchema, type DeliverySeo, type DeploymentResource, type DeploymentTargetResource, 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 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 StorageMode, type TeamMemberResource, type TeamResource, type TranslationResource, type TypegenCollection, type TypegenField, type TypegenManifest, type TypegenRelation, type TypegenSchemaFilters, type UserPreferencesPayload, type UserResource, 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 };

package/dist/index.js

@@ -386,7 +386,6 @@ function legacyRest() {
         if (params.offset !== void 0)
           qs.set("offset", String(params.offset));
         if (params.status) qs.set("status", params.status);
-        if (params.search) qs.set("search", params.search);
         const s = qs.toString();
         return s ? `?${s}` : "";
       }
@@ -700,6 +699,41 @@ function legacyRest() {
         method: "POST"
       })
     };
+    const me = {
+      getPreferences: () => client.rawRequest("/api/v1/me/preferences"),
+      updatePreferences: (patch) => client.rawRequest("/api/v1/me/preferences", {
+        method: "PATCH",
+        body: JSON.stringify(patch)
+      })
+    };
+    const deployments = {
+      targets: {
+        list: () => client.rawRequest("/api/v1/deployments/targets"),
+        create: (input) => client.rawRequest("/api/v1/deployments/targets", {
+          method: "POST",
+          body: JSON.stringify(input)
+        }),
+        update: (id, patch) => client.rawRequest(`/api/v1/deployments/targets/${id}`, {
+          method: "PATCH",
+          body: JSON.stringify(patch)
+        }),
+        delete: (id) => client.rawRequest(`/api/v1/deployments/targets/${id}`, { method: "DELETE" }),
+        deploy: (id, input = {}) => client.rawRequest(`/api/v1/deployments/targets/${id}/deploy`, {
+          method: "POST",
+          body: JSON.stringify(input)
+        })
+      },
+      list: (params) => {
+        const qs = new URLSearchParams();
+        if (params?.targetId) qs.set("targetId", params.targetId);
+        if (params?.status) qs.set("status", params.status);
+        const suffix = qs.toString() ? `?${qs.toString()}` : "";
+        return client.rawRequest(`/api/v1/deployments${suffix}`);
+      },
+      get: (id) => client.rawRequest(`/api/v1/deployments/${id}`),
+      logs: (id) => client.rawRequest(`/api/v1/deployments/${id}/logs`),
+      refresh: (id) => client.rawRequest(`/api/v1/deployments/${id}/refresh`, { method: "POST" })
+    };
     return {
       schema,
       items,
@@ -708,6 +742,7 @@ function legacyRest() {
       access,
       apiKeys,
       shares,
+      me,
       permissions,
       presets,
       translations,
@@ -720,6 +755,7 @@ function legacyRest() {
       webhooks,
       activity,
       extensions,
+      deployments,
       realtime: {
         /**
          * Create a RealtimeClient for the current site.
@@ -758,6 +794,19 @@ function legacyRest() {
 }
 
 // src/rest/index.ts
+function search(query, params) {
+  return async (client) => {
+    const qs = new URLSearchParams();
+    qs.set("q", query);
+    if (params?.collection) qs.set("collection", params.collection);
+    if (params?.filter) qs.set("filter", params.filter);
+    if (params?.sort?.length) qs.set("sort", params.sort.join(","));
+    if (params?.limit !== void 0) qs.set("limit", String(params.limit));
+    if (params?.offset !== void 0) qs.set("offset", String(params.offset));
+    const res = await client.rawRequest(`/api/v1/search?${qs.toString()}`);
+    return res;
+  };
+}
 function readItems(collection, params) {
   return async (client) => {
     const qs = new URLSearchParams();
@@ -767,7 +816,6 @@ 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?.search) qs.set("search", params.search);
     const s = qs.toString();
     const query = s ? `?${s}` : "";
     const res = await client.rawRequest(`/api/v1/items/${collection}${query}`);
@@ -1248,6 +1296,7 @@ export {
   retryAgentRun,
   rollbackAgentArtifact,
   rollbackCdcDeployment,
+  search,
   startCdcPipeline,
   stopCdcPipeline,
   toNextMetadata,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumibase/sdk",
-  "version": "0.11.0",
+  "version": "0.13.0",
   "description": "LumiBase JS SDK (REST + WebSocket) + typegen core. Isomorphic ESM.",
   "type": "module",
   "repository": {