@develit-io/backend-sdk 5.36.1 → 5.37.0

package/dist/index.d.mts

@@ -2,6 +2,7 @@ import * as drizzle_orm from 'drizzle-orm';
 import { ExtractTablesWithRelations, DBQueryConfig, BuildQueryResult } from 'drizzle-orm';
 import * as drizzle_orm_sqlite_core from 'drizzle-orm/sqlite-core';
 import { AnySQLiteTable } from 'drizzle-orm/sqlite-core';
+import * as hono_types from 'hono/types';
 import { z as z$1 } from 'zod';
 import * as z from 'zod/v4/core';
 import { StatusCodes, ReasonPhrases } from 'http-status-codes';
@@ -56,6 +57,17 @@ declare const composeWranglerBase: ({ project, name, }: {
     keep_vars: boolean;
 };
 
+declare const idempotency: <T extends {
+    IDEMPOTENCY_KV: KVNamespace;
+}>() => hono_types.MiddlewareHandler<{
+    Variables: {
+        idempotency: {
+            key: string;
+        };
+    };
+    Bindings: T;
+}, string, {}, Response>;
+
 declare const ENVIRONMENT: string[];
 
 interface AuditLogPayload<T> {
@@ -494,5 +506,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, 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, 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 };

package/dist/index.d.ts

@@ -2,6 +2,7 @@ import * as drizzle_orm from 'drizzle-orm';
 import { ExtractTablesWithRelations, DBQueryConfig, BuildQueryResult } from 'drizzle-orm';
 import * as drizzle_orm_sqlite_core from 'drizzle-orm/sqlite-core';
 import { AnySQLiteTable } from 'drizzle-orm/sqlite-core';
+import * as hono_types from 'hono/types';
 import { z as z$1 } from 'zod';
 import * as z from 'zod/v4/core';
 import { StatusCodes, ReasonPhrases } from 'http-status-codes';
@@ -56,6 +57,17 @@ declare const composeWranglerBase: ({ project, name, }: {
     keep_vars: boolean;
 };
 
+declare const idempotency: <T extends {
+    IDEMPOTENCY_KV: KVNamespace;
+}>() => hono_types.MiddlewareHandler<{
+    Variables: {
+        idempotency: {
+            key: string;
+        };
+    };
+    Bindings: T;
+}, string, {}, Response>;
+
 declare const ENVIRONMENT: string[];
 
 interface AuditLogPayload<T> {
@@ -494,5 +506,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, 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, 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 };

package/dist/index.mjs

@@ -1,6 +1,7 @@
 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';
@@ -63,6 +64,40 @@ const composeWranglerBase = ({
   };
 };
 
+const idempotency = () => {
+  return createMiddleware(async (context, next) => {
+    const idempotencyKeyHeader = context.req.header("X-Idempotency-Key");
+    if (!idempotencyKeyHeader) {
+      return context.json(
+        {
+          message: `The 'X-Idempotency-Key' header must exist and must have a value.`
+        },
+        401
+      );
+    }
+    const existingIdempotencyRecord = await context.env.IDEMPOTENCY_KV.get(idempotencyKeyHeader);
+    if (existingIdempotencyRecord)
+      return context.json(
+        {
+          message: "The identical request has already been processed. The idempotency key is not unique."
+        },
+        409
+      );
+    await context.env.IDEMPOTENCY_KV.put(
+      idempotencyKeyHeader,
+      idempotencyKeyHeader,
+      {
+        expirationTtl: 60 * 60 * 24 * 3
+        // 3 days
+      }
+    );
+    context.set("idempotency", {
+      key: idempotencyKeyHeader
+    });
+    await next();
+  });
+};
+
 const ibanSchema = z$1.string().min(1).regex(/^[A-Z]{2}[0-9]{2}[A-Z0-9]{11,30}$/, {
   message: "Invalid IBAN format"
 });
@@ -681,4 +716,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, 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, paginationQuerySchema, paginationSchema, service, useFetch, useResult, useResultSync, uuidv4 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@develit-io/backend-sdk",
-  "version": "5.36.1",
+  "version": "5.37.0",
   "description": "Develit Backend SDK",
   "author": "Develit.io",
   "license": "ISC",
@@ -40,5 +40,8 @@
     "@develit-io/general-codes": "^1.14.0",
     "cloudflare": "^5.2.0",
     "zod": "^4.1.12"
+  },
+  "devDependencies": {
+    "hono": "^4.10.4"
   }
 }