backlex 0.1.1 → 0.1.2

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { L as ListQuery, k as ListResponse, C as Condition, f as DurationParts, R as RelativeNow, A as AggregateQuery, a as AggregateRow, S as SearchQuery, m as SearchResponse, I as ImportSummary, h as ItemQuery, i as ItemResponse, d as BatchResponse, c as BatchOperation, g as ItemEvent, l as ResumableUploadResult, D as DeviceToken, P as PhoneNumber, j as JobStatus, J as Job, F as FlagState } from './types-DMWee2em.js';
-export { B as BacklexError, U as Upload, n as UploadStatus } from './types-DMWee2em.js';
+import { L as ListQuery, m as ListResponse, C as Condition, h as DurationParts, R as RelativeNow, A as AggregateQuery, a as AggregateRow, S as SearchQuery, o as SearchResponse, I as ImportSummary, j as ItemQuery, k as ItemResponse, d as BatchResponse, f as BulkUpdateResponse, c as BatchOperation, i as ItemEvent, n as ResumableUploadResult, D as DeviceToken, P as PhoneNumber, l as JobStatus, J as Job, F as FlagState } from './types-DiJCXOy-.js';
+export { B as BacklexError, U as Upload, p as UploadStatus } from './types-DiJCXOy-.js';
 export { VerifyWebhookOptions, verifyWebhook } from './webhook.js';
 
 /**
@@ -330,6 +330,7 @@ interface CollectionClient<T extends Record<string, unknown>> {
     deleteMany(ids: string[], opts?: {
         atomic?: boolean;
     }): Promise<BatchResponse<T>>;
+    bulkUpdate(keys: string[], data: Partial<T>): Promise<BulkUpdateResponse>;
     batch(operations: BatchOperation<T>[], opts?: {
         atomic?: boolean;
     }): Promise<BatchResponse<T>>;
@@ -571,6 +572,57 @@ interface FlagsClient {
         refresh?: boolean;
     }): Promise<boolean>;
 }
+/** A visual workflow (flow) row. `operations` is the serialized op DSL the
+ *  builder compiles; `layout` is a purely-presentational graph snapshot. */
+interface Flow {
+    id: string;
+    tenantId?: string | null;
+    name: string;
+    trigger: string;
+    operations: unknown[];
+    layout?: unknown;
+    active: boolean;
+}
+/** Create/update payload for a flow. `operations` must be non-empty on create;
+ *  `update` accepts any subset. */
+interface FlowInput {
+    name: string;
+    trigger: string;
+    operations: unknown[];
+    layout?: unknown;
+    active?: boolean;
+}
+/** Outcome of a manual flow run. `ok: false` means the run halted on an
+ *  unhandled op error; `error` carries the first failure message. */
+interface FlowRunResult {
+    ok: boolean;
+    error?: string;
+}
+/** Visual workflows (admin-scoped). Mirrors `/api/flows`. See `createClient`. */
+interface FlowsClient {
+    /** List every flow in the active workspace. */
+    list(): Promise<{
+        data: Flow[];
+    }>;
+    /** Fetch a single flow's full definition by id. */
+    get(id: string): Promise<{
+        data: Flow;
+    }>;
+    /** Create a flow scoped to the active workspace. */
+    create(input: FlowInput): Promise<{
+        data: Flow;
+    }>;
+    /** Partial update of a flow by id. */
+    update(id: string, patch: Partial<FlowInput>): Promise<{
+        ok: boolean;
+    }>;
+    /** Delete a flow by id. */
+    delete(id: string): Promise<{
+        ok: boolean;
+    }>;
+    /** Synchronously run a flow with an arbitrary `input` trigger payload. */
+    run(id: string, input?: Record<string, unknown>): Promise<FlowRunResult>;
+}
 /** The backlex client returned by `createClient` — data, auth, storage, realtime, and more. */
 interface BacklexClient {
     /** Typed data API for one collection by slug. */
@@ -585,6 +637,8 @@ interface BacklexClient {
     messaging: MessagingClient;
     /** Durable background job queue. */
     jobs: JobsClient;
+    /** Visual workflows (flows). */
+    flows: FlowsClient;
     /** Feature flags / remote config. */
     flags: FlagsClient;
     /** Offline-first sync controller for one collection. */
@@ -619,4 +673,4 @@ type TypedClient<R extends CollectionsMap> = BacklexClient & {
  */
 declare const typedCollections: <R extends CollectionsMap>(client: BacklexClient) => TypedClient<R>;
 
-export { AggregateQuery, AggregateRow, type AuthClient, type AuthResult, type AuthSession, type AuthSurface, type AuthUser, type BacklexClient, BatchOperation, BatchResponse, type ClientOptions, type CollectionClient, type CollectionsMap, DeviceToken, type FieldKey, type FilterBuilder, FlagState, type FlagsClient, ImportSummary, ItemEvent, ItemQuery, ItemResponse, Job, JobStatus, type JobsClient, ListQuery, ListResponse, type MessagingClient, PhoneNumber, type PublicProvider, QueryBuilder, type QueuedOp, ResumableUploadResult, SearchQuery, SearchResponse, type SortKey, type StorageClient, type SyncOptions, type SyncStore, type TypedClient, type TypedCollections, createClient, createSync, indexedDbStore, memoryStore, typedCollections };
+export { AggregateQuery, AggregateRow, type AuthClient, type AuthResult, type AuthSession, type AuthSurface, type AuthUser, type BacklexClient, BatchOperation, BatchResponse, BulkUpdateResponse, type ClientOptions, type CollectionClient, type CollectionsMap, DeviceToken, type FieldKey, type FilterBuilder, FlagState, type FlagsClient, type Flow, type FlowInput, type FlowRunResult, type FlowsClient, ImportSummary, ItemEvent, ItemQuery, ItemResponse, Job, JobStatus, type JobsClient, ListQuery, ListResponse, type MessagingClient, PhoneNumber, type PublicProvider, QueryBuilder, type QueuedOp, ResumableUploadResult, SearchQuery, SearchResponse, type SortKey, type StorageClient, type SyncOptions, type SyncStore, type TypedClient, type TypedCollections, createClient, createSync, indexedDbStore, memoryStore, typedCollections };

package/dist/index.js

@@ -456,7 +456,11 @@ var createClient = (opts) => {
   const tenantHeader = () => opts.tenant ? { "x-backlex-tenant": opts.tenant } : {};
   const request = async (method, path, body, extraHeaders) => {
     const headers = {
-      "content-type": "application/json",
+      // Only advertise a JSON body when we actually send one. A bodyless POST
+      // (publish, unpublish, restore, fts-reindex, …) that still carried
+      // `content-type: application/json` made the server's body validator try to
+      // parse an empty body and fail with "Malformed JSON in request body".
+      ...body !== void 0 ? { "content-type": "application/json" } : {},
       ...authHeader(),
       ...tenantHeader(),
       ...extraHeaders ?? {}
@@ -539,6 +543,14 @@ var createClient = (opts) => {
         operations: ids.map((id) => ({ op: "delete", id })),
         atomic: opts2?.atomic
       }),
+      /** Set the SAME fields on many ids at once (one shared patch). Only the
+       *  named fields change per row; partial-success (a key the caller can't
+       *  write is reported `NOT_FOUND`). Differs from `updateMany`, which sends
+       *  a distinct patch per id. */
+      bulkUpdate: (keys, data) => request("POST", `/api/items/${slug}/bulk-update`, {
+        keys,
+        data
+      }),
       /** Mixed create/update/delete in one request. `atomic` = all-or-nothing. */
       batch: (operations, opts2) => request("POST", `/api/items/${slug}/batch`, {
         operations,
@@ -818,6 +830,20 @@ var createClient = (opts) => {
     /** Delete a job row. */
     remove: (id) => request("DELETE", `/api/jobs/${encodeURIComponent(id)}`)
   };
+  const flows = {
+    /** List every flow in the active workspace. */
+    list: () => request("GET", "/api/flows"),
+    /** Fetch a single flow's full definition by id. */
+    get: (id) => request("GET", `/api/flows/${encodeURIComponent(id)}`),
+    /** Create a flow scoped to the active workspace. */
+    create: (input) => request("POST", "/api/flows", input),
+    /** Partial update of a flow by id. */
+    update: (id, patch) => request("PATCH", `/api/flows/${encodeURIComponent(id)}`, patch),
+    /** Delete a flow by id. */
+    delete: (id) => request("DELETE", `/api/flows/${encodeURIComponent(id)}`),
+    /** Run a flow synchronously with an arbitrary `input` trigger payload. */
+    run: (id, input) => request("POST", `/api/flows/${encodeURIComponent(id)}/run`, input ?? {})
+  };
   let flagsCache = null;
   const fetchFlags = async () => {
     const res = await request("GET", "/api/flags");
@@ -848,6 +874,7 @@ var createClient = (opts) => {
     storage,
     messaging,
     jobs,
+    flows,
     flags,
     sync,
     /** Raw escape hatch — issues a request with auth headers applied. */

package/dist/{types-DMWee2em.d.ts → types-DiJCXOy-.d.ts}

@@ -187,6 +187,25 @@ interface BatchResponse<T = Record<string, unknown>> {
         results: BatchRowResult<T>[];
     };
 }
+/** Per-key outcome inside a {@link BulkUpdateResponse}. */
+interface BulkUpdateRowResult {
+    id: string;
+    ok: boolean;
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+/** Response from a `bulkUpdate(keys, data)` call — one shared patch over many
+ *  ids, partial-success (a key the caller can't write is `NOT_FOUND`). */
+interface BulkUpdateResponse {
+    data: {
+        total: number;
+        updated: number;
+        failed: number;
+        results: BulkUpdateRowResult[];
+    };
+}
 /** A registered push device (from `messaging.listDevices()`). */
 interface DeviceToken {
     id: string;
@@ -267,4 +286,4 @@ declare class BacklexError extends Error {
     } | undefined);
 }
 
-export { type AggregateQuery as A, BacklexError as B, type Condition as C, type DeviceToken as D, type FlagState as F, type ImportSummary as I, type Job as J, type ListQuery as L, type PhoneNumber as P, type RelativeNow as R, type SearchQuery as S, type Upload as U, type AggregateRow as a, type ApiError as b, type BatchOperation as c, type BatchResponse as d, type BatchRowResult as e, type DurationParts as f, type ItemEvent as g, type ItemQuery as h, type ItemResponse as i, type JobStatus as j, type ListResponse as k, type ResumableUploadResult as l, type SearchResponse as m, type UploadStatus as n };
+export { type AggregateQuery as A, BacklexError as B, type Condition as C, type DeviceToken as D, type FlagState as F, type ImportSummary as I, type Job as J, type ListQuery as L, type PhoneNumber as P, type RelativeNow as R, type SearchQuery as S, type Upload as U, type AggregateRow as a, type ApiError as b, type BatchOperation as c, type BatchResponse as d, type BatchRowResult as e, type BulkUpdateResponse as f, type BulkUpdateRowResult as g, type DurationParts as h, type ItemEvent as i, type ItemQuery as j, type ItemResponse as k, type JobStatus as l, type ListResponse as m, type ResumableUploadResult as n, type SearchResponse as o, type UploadStatus as p };

package/dist/types.d.ts

@@ -1 +1 @@
-export { A as AggregateQuery, a as AggregateRow, b as ApiError, B as BacklexError, c as BatchOperation, d as BatchResponse, e as BatchRowResult, D as DeviceToken, F as FlagState, I as ImportSummary, g as ItemEvent, h as ItemQuery, i as ItemResponse, J as Job, j as JobStatus, L as ListQuery, k as ListResponse, P as PhoneNumber, l as ResumableUploadResult, S as SearchQuery, m as SearchResponse, U as Upload, n as UploadStatus } from './types-DMWee2em.js';
+export { A as AggregateQuery, a as AggregateRow, b as ApiError, B as BacklexError, c as BatchOperation, d as BatchResponse, e as BatchRowResult, f as BulkUpdateResponse, g as BulkUpdateRowResult, D as DeviceToken, F as FlagState, I as ImportSummary, i as ItemEvent, j as ItemQuery, k as ItemResponse, J as Job, l as JobStatus, L as ListQuery, m as ListResponse, P as PhoneNumber, n as ResumableUploadResult, S as SearchQuery, o as SearchResponse, U as Upload, p as UploadStatus } from './types-DiJCXOy-.js';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "backlex",
-  "version": "0.1.1",
-  "description": "Typed TypeScript client for the backlex API — auth, collection CRUD, query builder, realtime, storage, jobs, flags, and offline sync. Zero dependencies. On npm as compiled ESM + types; on JSR (@backlex/backlex) as TypeScript source.",
+  "version": "0.1.2",
+  "description": "Typed TypeScript client for the backlex API — auth, collection CRUD, query builder, realtime, storage, jobs, flows, flags, and offline sync. Zero dependencies. On npm as compiled ESM + types; on JSR (@backlex/backlex) as TypeScript source.",
   "type": "module",
   "license": "Apache-2.0",
   "homepage": "https://backlex.com",