@develit-io/backend-sdk 5.37.1 → 5.38.0

package/dist/index.d.mts

@@ -61,6 +61,8 @@ declare const idempotency: <T extends {
     IDEMPOTENCY_KV: KVNamespace;
 }>() => MiddlewareHandler;
 
+declare const logger: () => MiddlewareHandler;
+
 declare const ENVIRONMENT: string[];
 
 interface AuditLogPayload<T> {
@@ -166,6 +168,12 @@ type InferResultType<Tables extends Record<string, unknown>, TableName extends k
     with: With;
 }>;
 
+interface IdempotencyVariables {
+    idempotency: {
+        key: string;
+    };
+}
+
 declare const paginationQuerySchema: z.$ZodObject<Readonly<Readonly<{
     [k: string]: z.$ZodType<unknown, unknown, z.$ZodTypeInternals<unknown, unknown>>;
 }>>, z.$ZodObjectConfig>;
@@ -499,5 +507,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, action, bankAccount, bankAccountMetadataSchema, base, bicSchema, calculateExponentialBackoff, cloudflareQueue, composeWranglerBase, createAuditLogWriter, createInternalError, defineCommand, derivePortFromId, develitWorker, durableObjectNamespaceIdFromName, first, firstOrError, getD1Credentials, getD1DatabaseIdFromWrangler, getDrizzleD1Config, getSecret, handleAction, handleActionResponse, ibanSchema, idempotency, isInternalError, paginationQuerySchema, paginationSchema, service, useFetch, useResult, useResultSync, uuidv4 };
-export type { ActionExecution, ActionHandlerOptions, AuditLogWriter, BankAccountMetadata, BaseEvent, Command, CommandLogPayload, DevelitWorkerMethods, Environment, GatewayResponse, IRPCResponse, IncludeRelation, InferResultType, InternalError, InternalErrorResponseStatus, Project, ValidatedInput };
+export { DatabaseTransaction, ENVIRONMENT, RPCResponse, action, bankAccount, bankAccountMetadataSchema, base, bicSchema, calculateExponentialBackoff, cloudflareQueue, composeWranglerBase, createAuditLogWriter, createInternalError, defineCommand, derivePortFromId, develitWorker, durableObjectNamespaceIdFromName, first, firstOrError, getD1Credentials, getD1DatabaseIdFromWrangler, getDrizzleD1Config, getSecret, handleAction, handleActionResponse, ibanSchema, idempotency, isInternalError, logger, paginationQuerySchema, paginationSchema, service, useFetch, useResult, useResultSync, uuidv4 };
+export type { ActionExecution, ActionHandlerOptions, AuditLogWriter, BankAccountMetadata, BaseEvent, Command, CommandLogPayload, DevelitWorkerMethods, Environment, GatewayResponse, IRPCResponse, IdempotencyVariables, IncludeRelation, InferResultType, InternalError, InternalErrorResponseStatus, Project, ValidatedInput };

package/dist/index.d.ts

@@ -61,6 +61,8 @@ declare const idempotency: <T extends {
     IDEMPOTENCY_KV: KVNamespace;
 }>() => MiddlewareHandler;
 
+declare const logger: () => MiddlewareHandler;
+
 declare const ENVIRONMENT: string[];
 
 interface AuditLogPayload<T> {
@@ -166,6 +168,12 @@ type InferResultType<Tables extends Record<string, unknown>, TableName extends k
     with: With;
 }>;
 
+interface IdempotencyVariables {
+    idempotency: {
+        key: string;
+    };
+}
+
 declare const paginationQuerySchema: z.$ZodObject<Readonly<Readonly<{
     [k: string]: z.$ZodType<unknown, unknown, z.$ZodTypeInternals<unknown, unknown>>;
 }>>, z.$ZodObjectConfig>;
@@ -499,5 +507,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, action, bankAccount, bankAccountMetadataSchema, base, bicSchema, calculateExponentialBackoff, cloudflareQueue, composeWranglerBase, createAuditLogWriter, createInternalError, defineCommand, derivePortFromId, develitWorker, durableObjectNamespaceIdFromName, first, firstOrError, getD1Credentials, getD1DatabaseIdFromWrangler, getDrizzleD1Config, getSecret, handleAction, handleActionResponse, ibanSchema, idempotency, isInternalError, paginationQuerySchema, paginationSchema, service, useFetch, useResult, useResultSync, uuidv4 };
-export type { ActionExecution, ActionHandlerOptions, AuditLogWriter, BankAccountMetadata, BaseEvent, Command, CommandLogPayload, DevelitWorkerMethods, Environment, GatewayResponse, IRPCResponse, IncludeRelation, InferResultType, InternalError, InternalErrorResponseStatus, Project, ValidatedInput };
+export { DatabaseTransaction, ENVIRONMENT, RPCResponse, action, bankAccount, bankAccountMetadataSchema, base, bicSchema, calculateExponentialBackoff, cloudflareQueue, composeWranglerBase, createAuditLogWriter, createInternalError, defineCommand, derivePortFromId, develitWorker, durableObjectNamespaceIdFromName, first, firstOrError, getD1Credentials, getD1DatabaseIdFromWrangler, getDrizzleD1Config, getSecret, handleAction, handleActionResponse, ibanSchema, idempotency, isInternalError, logger, paginationQuerySchema, paginationSchema, service, useFetch, useResult, useResultSync, uuidv4 };
+export type { ActionExecution, ActionHandlerOptions, AuditLogWriter, BankAccountMetadata, BaseEvent, Command, CommandLogPayload, DevelitWorkerMethods, Environment, GatewayResponse, IRPCResponse, IdempotencyVariables, IncludeRelation, InferResultType, InternalError, InternalErrorResponseStatus, Project, ValidatedInput };

package/dist/index.mjs

@@ -2,15 +2,15 @@ import { sql } from 'drizzle-orm';
 import { integer, text } from 'drizzle-orm/sqlite-core';
 import { COUNTRY_CODES_2, CURRENCY_CODES, BANK_CODES } from '@develit-io/general-codes';
 import { createMiddleware } from 'hono/factory';
-import { z as z$1 } from 'zod';
-import * as z from 'zod/v4/core';
-import 'http-status-codes';
 import { createError } from 'h3';
 import 'cloudflare';
 import fs from 'node:fs';
 import crypto$1 from 'node:crypto';
 import path from 'node:path';
 import { parse } from 'comment-json';
+import { z as z$1 } from 'zod';
+import * as z from 'zod/v4/core';
+import 'http-status-codes';
 import superjson from 'superjson';
 
 const uuidv4 = () => crypto.randomUUID();
@@ -98,107 +98,25 @@ const idempotency = () => {
   });
 };
 
-const ibanSchema = z$1.string().min(1).regex(/^[A-Z]{2}[0-9]{2}[A-Z0-9]{11,30}$/, {
-  message: "Invalid IBAN format"
-});
-const bicSchema = z$1.string().min(1).regex(/^[A-Z]{6}[A-Z0-9]{2}([A-Z0-9]{3})?$/, {
-  message: "Invalid SWIFT/BIC format"
-});
-const bankAccountMetadataSchema = z$1.object({
-  id: z$1.string().optional(),
-  number: z$1.string().optional(),
-  bankCode: z$1.enum(BANK_CODES).optional(),
-  holderName: z$1.string().optional(),
-  iban: ibanSchema.optional(),
-  address: z$1.string().optional(),
-  swiftBic: bicSchema.optional(),
-  bicCor: bicSchema.optional()
-});
-
-const paginationQuerySchema = new z.$ZodObject({
-  type: "object",
-  shape: {
-    page: new z.$ZodDefault({
-      type: "default",
-      innerType: new z.$ZodNumber({
-        type: "number",
-        coerce: true
-      }),
-      defaultValue: () => 1
-    }),
-    limit: new z.$ZodDefault({
-      type: "default",
-      innerType: new z.$ZodNumber({
-        type: "number",
-        coerce: true
-      }),
-      defaultValue: () => 20
-    }),
-    sort: new z.$ZodDefault({
-      type: "default",
-      innerType: new z.$ZodObject({
-        type: "object",
-        shape: {
-          column: new z.$ZodDefault({
-            type: "default",
-            innerType: new z.$ZodEnum({
-              type: "enum",
-              entries: {
-                createdAt: "createdAt",
-                updatedAt: "updatedAt",
-                deletedAt: "deletedAt"
-              }
-            }),
-            defaultValue: () => "updatedAt"
-          }),
-          direction: new z.$ZodDefault({
-            type: "default",
-            innerType: new z.$ZodEnum({
-              type: "enum",
-              entries: {
-                asc: "asc",
-                desc: "desc"
-              }
-            }),
-            defaultValue: () => "desc"
-          })
-        }
-      }),
-      defaultValue: () => ({ column: "updatedAt", direction: "desc" })
-    })
-  }
-});
-const paginationSchema = new z.$ZodObject({
-  type: "object",
-  shape: {
-    page: new z.$ZodNumber({
-      type: "number"
-    }),
-    limit: new z.$ZodNumber({
-      type: "number"
-    }),
-    sort: new z.$ZodObject({
-      type: "object",
-      shape: {
-        column: new z.$ZodEnum({
-          type: "enum",
-          entries: {
-            createdAt: "createdAt",
-            updatedAt: "updatedAt",
-            deletedAt: "deletedAt"
-          }
-        }),
-        direction: new z.$ZodEnum({
-          type: "enum",
-          entries: {
-            asc: "asc",
-            desc: "desc"
-          }
-        })
-      }
-    })
-  }
-});
+const composeRequestLog = async (request) => {
+  return {
+    method: request.method,
+    path: request.path,
+    query: request.query(),
+    headers: request.header(),
+    body: await request.json().catch(() => null)
+  };
+};
+const composeResponseLog = async (response, method, path) => {
+  return {
+    method,
+    path,
+    status: response.status,
+    statusText: response.statusText,
+    headers: Object.fromEntries(response.headers.entries()),
+    body: await response.json().catch(() => null)
+  };
+};
 
 const handleActionResponse = ({
   error,
@@ -560,6 +478,13 @@ async function useFetch(url, { parseAs = "json", ...options } = {}) {
   return [body, null];
 }
 
+const logRequest = (log) => {
+  console.log("REQUEST | An incoming request has been recorded.", log);
+};
+const logResponse = (log) => {
+  console.log(`RESPONSE | An outgoing response has been recorded.`, log);
+};
+
 const calculateExponentialBackoff = (attempts, baseDelaySeconds) => {
   return baseDelaySeconds ** attempts;
 };
@@ -576,6 +501,123 @@ const getSecret = async (secretName, env) => {
   return await secret.get();
 };
 
+const logger = () => {
+  return createMiddleware(async (context, next) => {
+    const requestLog = await composeRequestLog(context.req);
+    logRequest(requestLog);
+    await next();
+    const response = context.res.clone();
+    const responseLog = await composeResponseLog(
+      response,
+      context.req.method,
+      context.req.url
+    );
+    logResponse(responseLog);
+  });
+};
+
+const ibanSchema = z$1.string().min(1).regex(/^[A-Z]{2}[0-9]{2}[A-Z0-9]{11,30}$/, {
+  message: "Invalid IBAN format"
+});
+const bicSchema = z$1.string().min(1).regex(/^[A-Z]{6}[A-Z0-9]{2}([A-Z0-9]{3})?$/, {
+  message: "Invalid SWIFT/BIC format"
+});
+const bankAccountMetadataSchema = z$1.object({
+  id: z$1.string().optional(),
+  number: z$1.string().optional(),
+  bankCode: z$1.enum(BANK_CODES).optional(),
+  holderName: z$1.string().optional(),
+  iban: ibanSchema.optional(),
+  address: z$1.string().optional(),
+  swiftBic: bicSchema.optional(),
+  bicCor: bicSchema.optional()
+});
+
+const paginationQuerySchema = new z.$ZodObject({
+  type: "object",
+  shape: {
+    page: new z.$ZodDefault({
+      type: "default",
+      innerType: new z.$ZodNumber({
+        type: "number",
+        coerce: true
+      }),
+      defaultValue: () => 1
+    }),
+    limit: new z.$ZodDefault({
+      type: "default",
+      innerType: new z.$ZodNumber({
+        type: "number",
+        coerce: true
+      }),
+      defaultValue: () => 20
+    }),
+    sort: new z.$ZodDefault({
+      type: "default",
+      innerType: new z.$ZodObject({
+        type: "object",
+        shape: {
+          column: new z.$ZodDefault({
+            type: "default",
+            innerType: new z.$ZodEnum({
+              type: "enum",
+              entries: {
+                createdAt: "createdAt",
+                updatedAt: "updatedAt",
+                deletedAt: "deletedAt"
+              }
+            }),
+            defaultValue: () => "updatedAt"
+          }),
+          direction: new z.$ZodDefault({
+            type: "default",
+            innerType: new z.$ZodEnum({
+              type: "enum",
+              entries: {
+                asc: "asc",
+                desc: "desc"
+              }
+            }),
+            defaultValue: () => "desc"
+          })
+        }
+      }),
+      defaultValue: () => ({ column: "updatedAt", direction: "desc" })
+    })
+  }
+});
+const paginationSchema = new z.$ZodObject({
+  type: "object",
+  shape: {
+    page: new z.$ZodNumber({
+      type: "number"
+    }),
+    limit: new z.$ZodNumber({
+      type: "number"
+    }),
+    sort: new z.$ZodObject({
+      type: "object",
+      shape: {
+        column: new z.$ZodEnum({
+          type: "enum",
+          entries: {
+            createdAt: "createdAt",
+            updatedAt: "updatedAt",
+            deletedAt: "deletedAt"
+          }
+        }),
+        direction: new z.$ZodEnum({
+          type: "enum",
+          entries: {
+            asc: "asc",
+            desc: "desc"
+          }
+        })
+      }
+    })
+  }
+});
+
 const service = (serviceName) => {
   return function(constructor) {
     return class extends constructor {
@@ -716,4 +758,4 @@ function develitWorker(Worker) {
   return DevelitWorker;
 }
 
-export { DatabaseTransaction, ENVIRONMENT, RPCResponse, action, bankAccount, bankAccountMetadataSchema, base, bicSchema, calculateExponentialBackoff, cloudflareQueue, composeWranglerBase, createAuditLogWriter, createInternalError, defineCommand, derivePortFromId, develitWorker, durableObjectNamespaceIdFromName, first, firstOrError, getD1Credentials, getD1DatabaseIdFromWrangler, getDrizzleD1Config, getSecret, handleAction, handleActionResponse, ibanSchema, idempotency, isInternalError, paginationQuerySchema, paginationSchema, service, useFetch, useResult, useResultSync, uuidv4 };
+export { DatabaseTransaction, ENVIRONMENT, RPCResponse, action, bankAccount, bankAccountMetadataSchema, base, bicSchema, calculateExponentialBackoff, cloudflareQueue, composeWranglerBase, createAuditLogWriter, createInternalError, defineCommand, derivePortFromId, develitWorker, durableObjectNamespaceIdFromName, first, firstOrError, getD1Credentials, getD1DatabaseIdFromWrangler, getDrizzleD1Config, getSecret, handleAction, handleActionResponse, ibanSchema, idempotency, isInternalError, logger, paginationQuerySchema, paginationSchema, service, useFetch, useResult, useResultSync, uuidv4 };

package/package.json

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