@develit-io/backend-sdk 11.0.5 → 11.2.0

package/dist/index.d.mts

@@ -13,9 +13,9 @@ export { createSelectSchema } from 'drizzle-orm/zod';
 
 declare const ENVIRONMENT: string[];
 
-type Environment = string | 'localhost' | 'dev' | 'test' | 'staging' | 'production';
+type Environment = string | 'localhost' | 'dev' | 'staging' | 'production';
 
-type Project = 'creditio' | 'cryptobyte-website' | 'dbu-payments-api' | 'dbu-mdm' | 'dbu-txs' | 'develit-sdk' | 'lrf-website' | 'moneio' | 'stable-labs-emi-processor';
+type Project = 'creditio' | 'cryptobyte-website' | 'dbu-payments-api' | 'dbu-mdm' | 'dbu-txs' | 'develit-sdk' | 'kachlikarna-pridavac' | 'lrf-website' | 'moneio' | 'stable-labs-emi-processor';
 
 declare const uuidv4: () => `${string}-${string}-${string}-${string}-${string}`;
 declare const uuidv5: (name: string, namespace: string) => Promise<string>;
@@ -1223,6 +1223,28 @@ type OptionalToNull<T> = {
 declare function optionalToNull<T extends object>(obj: T): OptionalToNull<T>;
 
 declare const calculateExponentialBackoff: (attempts: number, baseDelaySeconds: number) => number;
+/**
+ * Splits messages into chunks that fit Cloudflare Queue sendBatch limits
+ * (100 messages OR 256 KB total per batch). Oversized single messages are
+ * emitted alone — Cloudflare will reject them, but the helper does not loop.
+ */
+declare function chunkQueueMessages<T>(messages: T[]): Generator<T[]>;
+/**
+ * Sends a single message via `queue.send()` or a batch via `queue.sendBatch()`.
+ * Batches are automatically chunked to respect Cloudflare Queue limits.
+ */
+declare function pushToQueue<T>(queue: Queue, message: T | T[]): Promise<void>;
+
+/**
+ * Deep-clones an object and replaces values of sensitive keys with '[REDACTED]'.
+ * Key matching is case-insensitive and ignores underscores/hyphens,
+ * so `password`, `Password`, `access_token`, `accessToken`, `ACCESS_TOKEN` are all matched.
+ *
+ * @param value - The value to redact
+ * @param sensitiveKeys - Additional keys to redact (merged with defaults)
+ * @returns A deep copy with sensitive values replaced
+ */
+declare function redact<T>(value: T, sensitiveKeys?: string[]): T;
 
 declare const RPCResponse: {
     /**
@@ -1311,5 +1333,5 @@ interface WithRetryCounterOptions {
 type AsyncMethod<TArgs extends unknown[] = unknown[], TResult = unknown> = (...args: TArgs) => Promise<TResult>;
 declare function cloudflareQueue<TArgs extends unknown[] = unknown[], TResult = unknown>(options: WithRetryCounterOptions): (target: unknown, propertyKey: string | symbol, descriptor: TypedPropertyDescriptor<AsyncMethod<TArgs, TResult>>) => void;
 
-export { DatabaseTransaction, ENVIRONMENT, RPCResponse, USER_ROLES, action, asNonEmpty, bankAccount, bankAccountMetadataSchema, base, bicSchema, buildMultiFilterConditions, buildRangeFilterConditions, buildSearchConditions, calculateExponentialBackoff, cloudflareQueue, composeWranglerBase, createAuditLogWriter, createInsertSchema, createInternalError, createPatchSchema, createUpdateSchema, defineCommand, derivePortFromId, develitWorker, durableObjectNamespaceIdFromName, first, firstOrError, getD1Credentials, getDrizzleD1Config, getLocalD1DatabaseIdFromWrangler, getSecret, handleAction, ibanSchema, isInternalError, nullToOptional, optionalToNull, paginationQuerySchema, paginationSchema, resolveColumn, service, structuredAddressSchema, useFetch, useResult, useResultSync, uuidv4, uuidv5, workflowInstanceStatusSchema };
+export { DatabaseTransaction, ENVIRONMENT, RPCResponse, USER_ROLES, action, asNonEmpty, bankAccount, bankAccountMetadataSchema, base, bicSchema, buildMultiFilterConditions, buildRangeFilterConditions, buildSearchConditions, calculateExponentialBackoff, chunkQueueMessages, cloudflareQueue, composeWranglerBase, createAuditLogWriter, createInsertSchema, createInternalError, createPatchSchema, createUpdateSchema, defineCommand, derivePortFromId, develitWorker, durableObjectNamespaceIdFromName, first, firstOrError, getD1Credentials, getDrizzleD1Config, getLocalD1DatabaseIdFromWrangler, getSecret, handleAction, ibanSchema, isInternalError, nullToOptional, optionalToNull, paginationQuerySchema, paginationSchema, pushToQueue, redact, resolveColumn, service, structuredAddressSchema, useFetch, useResult, useResultSync, uuidv4, uuidv5, workflowInstanceStatusSchema };
 export type { ActionExecution, ActionHandlerOptions, AuditLogWriter, BankAccountMetadata, BaseEvent, BuildSearchOptions, Command, CommandLogPayload, DevelitWorkerMethods, Environment, GatewayResponse, IRPCResponse, IdempotencyContextVariables, IdentityContextVariables, InternalError, InternalErrorResponseStatus, Project, RequestLog, ResponseLog, StructuredAddress, UserRole, ValidatedInput, WorkflowInstanceStatus };

package/dist/index.d.ts

@@ -13,9 +13,9 @@ export { createSelectSchema } from 'drizzle-orm/zod';
 
 declare const ENVIRONMENT: string[];
 
-type Environment = string | 'localhost' | 'dev' | 'test' | 'staging' | 'production';
+type Environment = string | 'localhost' | 'dev' | 'staging' | 'production';
 
-type Project = 'creditio' | 'cryptobyte-website' | 'dbu-payments-api' | 'dbu-mdm' | 'dbu-txs' | 'develit-sdk' | 'lrf-website' | 'moneio' | 'stable-labs-emi-processor';
+type Project = 'creditio' | 'cryptobyte-website' | 'dbu-payments-api' | 'dbu-mdm' | 'dbu-txs' | 'develit-sdk' | 'kachlikarna-pridavac' | 'lrf-website' | 'moneio' | 'stable-labs-emi-processor';
 
 declare const uuidv4: () => `${string}-${string}-${string}-${string}-${string}`;
 declare const uuidv5: (name: string, namespace: string) => Promise<string>;
@@ -1223,6 +1223,28 @@ type OptionalToNull<T> = {
 declare function optionalToNull<T extends object>(obj: T): OptionalToNull<T>;
 
 declare const calculateExponentialBackoff: (attempts: number, baseDelaySeconds: number) => number;
+/**
+ * Splits messages into chunks that fit Cloudflare Queue sendBatch limits
+ * (100 messages OR 256 KB total per batch). Oversized single messages are
+ * emitted alone — Cloudflare will reject them, but the helper does not loop.
+ */
+declare function chunkQueueMessages<T>(messages: T[]): Generator<T[]>;
+/**
+ * Sends a single message via `queue.send()` or a batch via `queue.sendBatch()`.
+ * Batches are automatically chunked to respect Cloudflare Queue limits.
+ */
+declare function pushToQueue<T>(queue: Queue, message: T | T[]): Promise<void>;
+
+/**
+ * Deep-clones an object and replaces values of sensitive keys with '[REDACTED]'.
+ * Key matching is case-insensitive and ignores underscores/hyphens,
+ * so `password`, `Password`, `access_token`, `accessToken`, `ACCESS_TOKEN` are all matched.
+ *
+ * @param value - The value to redact
+ * @param sensitiveKeys - Additional keys to redact (merged with defaults)
+ * @returns A deep copy with sensitive values replaced
+ */
+declare function redact<T>(value: T, sensitiveKeys?: string[]): T;
 
 declare const RPCResponse: {
     /**
@@ -1311,5 +1333,5 @@ interface WithRetryCounterOptions {
 type AsyncMethod<TArgs extends unknown[] = unknown[], TResult = unknown> = (...args: TArgs) => Promise<TResult>;
 declare function cloudflareQueue<TArgs extends unknown[] = unknown[], TResult = unknown>(options: WithRetryCounterOptions): (target: unknown, propertyKey: string | symbol, descriptor: TypedPropertyDescriptor<AsyncMethod<TArgs, TResult>>) => void;
 
-export { DatabaseTransaction, ENVIRONMENT, RPCResponse, USER_ROLES, action, asNonEmpty, bankAccount, bankAccountMetadataSchema, base, bicSchema, buildMultiFilterConditions, buildRangeFilterConditions, buildSearchConditions, calculateExponentialBackoff, cloudflareQueue, composeWranglerBase, createAuditLogWriter, createInsertSchema, createInternalError, createPatchSchema, createUpdateSchema, defineCommand, derivePortFromId, develitWorker, durableObjectNamespaceIdFromName, first, firstOrError, getD1Credentials, getDrizzleD1Config, getLocalD1DatabaseIdFromWrangler, getSecret, handleAction, ibanSchema, isInternalError, nullToOptional, optionalToNull, paginationQuerySchema, paginationSchema, resolveColumn, service, structuredAddressSchema, useFetch, useResult, useResultSync, uuidv4, uuidv5, workflowInstanceStatusSchema };
+export { DatabaseTransaction, ENVIRONMENT, RPCResponse, USER_ROLES, action, asNonEmpty, bankAccount, bankAccountMetadataSchema, base, bicSchema, buildMultiFilterConditions, buildRangeFilterConditions, buildSearchConditions, calculateExponentialBackoff, chunkQueueMessages, cloudflareQueue, composeWranglerBase, createAuditLogWriter, createInsertSchema, createInternalError, createPatchSchema, createUpdateSchema, defineCommand, derivePortFromId, develitWorker, durableObjectNamespaceIdFromName, first, firstOrError, getD1Credentials, getDrizzleD1Config, getLocalD1DatabaseIdFromWrangler, getSecret, handleAction, ibanSchema, isInternalError, nullToOptional, optionalToNull, paginationQuerySchema, paginationSchema, pushToQueue, redact, resolveColumn, service, structuredAddressSchema, useFetch, useResult, useResultSync, uuidv4, uuidv5, workflowInstanceStatusSchema };
 export type { ActionExecution, ActionHandlerOptions, AuditLogWriter, BankAccountMetadata, BaseEvent, BuildSearchOptions, Command, CommandLogPayload, DevelitWorkerMethods, Environment, GatewayResponse, IRPCResponse, IdempotencyContextVariables, IdentityContextVariables, InternalError, InternalErrorResponseStatus, Project, RequestLog, ResponseLog, StructuredAddress, UserRole, ValidatedInput, WorkflowInstanceStatus };

package/dist/index.mjs

@@ -729,6 +729,48 @@ function optionalToNull(obj) {
 const calculateExponentialBackoff = (attempts, baseDelaySeconds) => {
   return baseDelaySeconds ** attempts;
 };
+const MAX_BATCH_MESSAGES = 100;
+const MAX_BATCH_BYTES = 24e4;
+const PER_MESSAGE_OVERHEAD_BYTES = 100;
+function approxMessageSize(message) {
+  try {
+    return new TextEncoder().encode(JSON.stringify(message)).length + PER_MESSAGE_OVERHEAD_BYTES;
+  } catch {
+    return 1024;
+  }
+}
+function* chunkQueueMessages(messages) {
+  let chunk = [];
+  let chunkBytes = 0;
+  for (const message of messages) {
+    const size = approxMessageSize(message);
+    const wouldOverflow = chunk.length >= MAX_BATCH_MESSAGES || chunk.length > 0 && chunkBytes + size > MAX_BATCH_BYTES;
+    if (wouldOverflow) {
+      yield chunk;
+      chunk = [];
+      chunkBytes = 0;
+    }
+    chunk.push(message);
+    chunkBytes += size;
+  }
+  if (chunk.length) yield chunk;
+}
+async function pushToQueue(queue, message) {
+  if (!queue) {
+    throw new Error(
+      "[pushToQueue] Queue binding is undefined \u2014 check your wrangler config"
+    );
+  }
+  if (!Array.isArray(message)) {
+    await queue.send(message, { contentType: "v8" });
+    return;
+  }
+  for (const chunk of chunkQueueMessages(message)) {
+    await queue.sendBatch(
+      chunk.map((body) => ({ body, contentType: "v8" }))
+    );
+  }
+}
 
 const getSecret = async (secretName, env) => {
   const environment = env;
@@ -864,21 +906,7 @@ function develitWorker(Worker) {
       );
     }
     async pushToQueue(queue, message) {
-      if (!queue) {
-        throw new Error(
-          "[pushToQueue] Queue binding is undefined \u2014 check your wrangler config"
-        );
-      }
-      if (!Array.isArray(message)) {
-        await queue.send(message, { contentType: "v8" });
-        return;
-      }
-      await queue.sendBatch(
-        message.map((m) => ({
-          body: m,
-          contentType: "v8"
-        }))
-      );
+      return pushToQueue(queue, message);
     }
     recordAuditLogMessage(queue, message) {
       const msg = { service: this.name, ...message, createdAt: /* @__PURE__ */ new Date() };
@@ -891,4 +919,4 @@ function develitWorker(Worker) {
   return DevelitWorker;
 }
 
-export { DatabaseTransaction, ENVIRONMENT, RPCResponse, USER_ROLES, action, asNonEmpty, bankAccount, bankAccountMetadataSchema, base, bicSchema, buildMultiFilterConditions, buildRangeFilterConditions, buildSearchConditions, calculateExponentialBackoff, cloudflareQueue, composeWranglerBase, createAuditLogWriter, createInsertSchema, createInternalError, createPatchSchema, createUpdateSchema, defineCommand, derivePortFromId, develitWorker, durableObjectNamespaceIdFromName, first, firstOrError, getD1Credentials, getDrizzleD1Config, getLocalD1DatabaseIdFromWrangler, getSecret, handleAction, ibanSchema, isInternalError, nullToOptional, optionalToNull, paginationQuerySchema, paginationSchema, resolveColumn, service, structuredAddressSchema, useFetch, useResult, useResultSync, workflowInstanceStatusSchema };
+export { DatabaseTransaction, ENVIRONMENT, RPCResponse, USER_ROLES, action, asNonEmpty, bankAccount, bankAccountMetadataSchema, base, bicSchema, buildMultiFilterConditions, buildRangeFilterConditions, buildSearchConditions, calculateExponentialBackoff, chunkQueueMessages, cloudflareQueue, composeWranglerBase, createAuditLogWriter, createInsertSchema, createInternalError, createPatchSchema, createUpdateSchema, defineCommand, derivePortFromId, develitWorker, durableObjectNamespaceIdFromName, first, firstOrError, getD1Credentials, getDrizzleD1Config, getLocalD1DatabaseIdFromWrangler, getSecret, handleAction, ibanSchema, isInternalError, nullToOptional, optionalToNull, paginationQuerySchema, paginationSchema, pushToQueue, redact, resolveColumn, service, structuredAddressSchema, useFetch, useResult, useResultSync, workflowInstanceStatusSchema };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@develit-io/backend-sdk",
-  "version": "11.0.5",
+  "version": "11.2.0",
   "description": "Develit Backend SDK",
   "author": "Develit.io",
   "license": "ISC",