@develit-io/backend-sdk 5.19.0 → 5.21.0

package/dist/index.cjs

@@ -5,8 +5,8 @@ const pgCore = require('drizzle-orm/pg-core');
 const sqliteCore = require('drizzle-orm/sqlite-core');
 const generalCodes = require('@develit-io/general-codes');
 const text = require('@std/text');
-require('http-status-codes');
 const z = require('zod/v4/core');
+require('http-status-codes');
 const h3 = require('h3');
 const fs = require('node:fs');
 const crypto$1 = require('node:crypto');
@@ -685,6 +685,39 @@ const defineCommand = (handler) => {
   }));
 };
 
+async function useFetch(url, { parseAs = "json", ...options } = {}) {
+  const [response, fetchError] = await useResult(fetch(url, options));
+  if (fetchError || !response) {
+    return [null, createInternalError(fetchError, { code: "NETWORK_ERROR" })];
+  }
+  const parsers = {
+    json: () => response.json(),
+    text: () => response.text(),
+    blob: () => response.blob()
+  };
+  const [body, parseError] = await useResult(parsers[parseAs]());
+  if (!response.ok) {
+    return [
+      null,
+      createInternalError(parseError, {
+        message: body?.message ?? response.statusText,
+        code: "HTTP_ERROR",
+        status: response.status
+      })
+    ];
+  }
+  if (parseError) {
+    return [
+      null,
+      createInternalError(parseError, {
+        code: "PARSE_ERROR",
+        status: response.status
+      })
+    ];
+  }
+  return [body, null];
+}
+
 const getPgLocalConnectionString = (id) => `postgres://db_user:db_password@127.0.0.1:${derivePortFromId(id)}/db`;
 const getPgDatabaseIdFromWrangler = () => {
   try {
@@ -912,6 +945,7 @@ exports.paginationQuerySchema = paginationQuerySchema;
 exports.paginationSchema = paginationSchema;
 exports.service = service;
 exports.swiftZodSchema = swiftZodSchema;
+exports.useFetch = useFetch;
 exports.useResult = useResult;
 exports.useResultSync = useResultSync;
 exports.uuidv4 = uuidv4;

package/dist/index.d.cts

@@ -4,9 +4,9 @@ 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 z from 'zod/v4/core';
 import { StatusCodes, ReasonPhrases } from 'http-status-codes';
 export { ReasonPhrases as InternalResponsePhrase, StatusCodes as InternalResponseStatus } from 'http-status-codes';
-import * as z from 'zod/v4/core';
 import { Queue } from '@cloudflare/workers-types';
 import { BatchItem } from 'drizzle-orm/batch';
 import { DrizzleD1Database } from 'drizzle-orm/d1';
@@ -130,25 +130,28 @@ declare class Infrastructure {
     }): any;
 }
 
-type Resource = 'kv' | 'd1' | 'queue' | 'r2' | 'worker' | 'service' | 'orchestrator';
-
-type InternalErrorResponseStatus = Exclude<StatusCodes, 200 | 201 | 202 | 203 | 204 | 205 | 206 | 207>;
-interface InternalError {
-    status: InternalErrorResponseStatus;
-    code: string;
-    message: string;
+interface AuditLogPayload<T> {
+    action: T;
+    actorId: string;
+    actorUsername?: string;
+    service: string;
+    entityId?: string;
 }
-interface IRPCResponse<T> {
-    status: StatusCodes;
-    message: string;
-    data: T | null | undefined;
-    error: boolean;
-    phrase?: ReasonPhrases;
+
+declare const ibanZodSchema: z.$ZodString<unknown>;
+declare const swiftZodSchema: z.$ZodString<unknown>;
+
+interface CommandLogPayload<T = string> {
+    action: T;
+    actorId: string;
+    actorUsername?: string;
+    entityId?: string;
 }
-interface GatewayResponse<T> {
-    status?: number;
-    message: string;
-    data?: T;
+
+interface CommandItem<TAuditAction = string> {
+    command: BatchItem<'sqlite'>;
+    logPayload: CommandLogPayload<TAuditAction>;
+    id: string;
 }
 
 /**
@@ -171,21 +174,7 @@ type InferResultType<Tables extends Record<string, unknown>, TableName extends k
     with: With;
 }>;
 
-declare const ibanZodSchema: z.$ZodString<unknown>;
-declare const swiftZodSchema: z.$ZodString<unknown>;
-
-interface CommandLogPayload<T = string> {
-    action: T;
-    actorId: string;
-    actorUsername?: string;
-    entityId?: string;
-}
-
-interface CommandItem<TAuditAction = string> {
-    command: BatchItem<'sqlite'>;
-    logPayload: CommandLogPayload<TAuditAction>;
-    id: string;
-}
+type Resource = 'kv' | 'd1' | 'queue' | 'r2' | 'worker' | 'service' | 'orchestrator';
 
 declare const paginationQuerySchema: z.$ZodObject<Readonly<Readonly<{
     [k: string]: z.$ZodType<unknown, unknown, z.$ZodTypeInternals<unknown, unknown>>;
@@ -194,6 +183,38 @@ declare const paginationSchema: z.$ZodObject<Readonly<Readonly<{
     [k: string]: z.$ZodType<unknown, unknown, z.$ZodTypeInternals<unknown, unknown>>;
 }>>, z.$ZodObjectConfig>;
 
+type InternalErrorResponseStatus = Exclude<StatusCodes, 200 | 201 | 202 | 203 | 204 | 205 | 206 | 207>;
+interface InternalError {
+    status: InternalErrorResponseStatus;
+    code: string;
+    message: string;
+}
+interface IRPCResponse<T> {
+    status: StatusCodes;
+    message: string;
+    data: T | null | undefined;
+    error: boolean;
+    phrase?: ReasonPhrases;
+}
+interface GatewayResponse<T> {
+    status?: number;
+    message: string;
+    data?: T;
+}
+
+/**
+ * A utility function to handle operations and return a standardized result.
+ *
+ * This function wraps the call and ensures that both the resolved value
+ * and any potential errors are captured in a structured tuple format.
+ *
+ * @template T - The type of the expected result.
+ * @returns A call that resolves to a tuple containing:
+ *          - The resolved data (`T | null`) if successful.
+ *          - An `RPCError` object (`RPCError | null`) if an error occurs.
+ */
+type Result<T> = [data: T | null, error: InternalError | null];
+
 declare const composeBindingName: ({ resource, resourceName, bindingName, }: {
     resource: Resource;
     resourceName: string;
@@ -287,14 +308,6 @@ type ValidatedInput<T extends z.$ZodType> = z.infer<T>;
  */
 type ActionExecution<TInput, TOutput> = TInput extends null ? () => Promise<TOutput> : (input: TInput) => Promise<TOutput>;
 
-interface AuditLogPayload<T> {
-    action: T;
-    actorId: string;
-    actorUsername?: string;
-    service: string;
-    entityId?: string;
-}
-
 type AuditLogTable = AnySQLiteTable | AnyPgTable;
 type AuditLogWriter<TAuditAction = string> = (logs: AuditLogPayload<TAuditAction>[], db: DrizzleD1Database<Record<string, unknown>>) => BatchItem<'sqlite'>[];
 /**
@@ -406,6 +419,11 @@ declare const createInternalError: (error: unknown, details?: {
 }) => InternalError;
 declare const isInternalError: (error: unknown) => error is InternalError;
 
+interface UseFetchOptions extends RequestInit {
+    parseAs?: 'json' | 'text' | 'blob';
+}
+declare function useFetch<T = unknown>(url: string, { parseAs, ...options }?: UseFetchOptions): Promise<Result<T>>;
+
 declare const getPgLocalConnectionString: (id: string) => string;
 declare const getPgDatabaseIdFromWrangler: () => string | undefined;
 declare const getPgCredentials: (serviceName?: string) => {
@@ -467,18 +485,6 @@ declare const RPCResponse: {
     validationError<T>(error: InternalError): IRPCResponse<T>;
 };
 
-/**
- * A utility function to handle operations and return a standardized result.
- *
- * This function wraps the call and ensures that both the resolved value
- * and any potential errors are captured in a structured tuple format.
- *
- * @template T - The type of the expected result.
- * @returns A call that resolves to a tuple containing:
- *          - The resolved data (`T | null`) if successful.
- *          - An `RPCError` object (`RPCError | null`) if an error occurs.
- */
-type Result<T> = [data: T | null, error: InternalError | null];
 /**
  * Executes a given promise and returns the result in a structured format.
  *
@@ -525,5 +531,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, Infrastructure, RPCResponse, action, bankAccount, bankAccountBankCodeEnum, bankAccountCountryCodeEnum, bankAccountCurrencyEnum, bankAccountPostgres, base, basePostgres, calculateExponentialBackoff, cloudflareQueue, composeBindingName, createAuditLogWriter, createInternalError, defineCommand, derivePortFromId, develitWorker, durableObjectNamespaceIdFromName, first, firstOrError, getD1Credentials, getD1DatabaseIdFromWrangler, getDrizzleD1Config, getDrizzlePgConfig, getPgCredentials, getPgDatabaseIdFromWrangler, getPgLocalConnectionString, handleAction, handleActionResponse, ibanZodSchema, isInternalError, paginationQuerySchema, paginationSchema, service, swiftZodSchema, useResult, useResultSync, uuidv4, validateEnvironment };
+export { DatabaseTransaction, ENVIRONMENT, Infrastructure, RPCResponse, action, bankAccount, bankAccountBankCodeEnum, bankAccountCountryCodeEnum, bankAccountCurrencyEnum, bankAccountPostgres, base, basePostgres, calculateExponentialBackoff, cloudflareQueue, composeBindingName, createAuditLogWriter, createInternalError, defineCommand, derivePortFromId, develitWorker, durableObjectNamespaceIdFromName, first, firstOrError, getD1Credentials, getD1DatabaseIdFromWrangler, getDrizzleD1Config, getDrizzlePgConfig, getPgCredentials, getPgDatabaseIdFromWrangler, getPgLocalConnectionString, handleAction, handleActionResponse, ibanZodSchema, isInternalError, paginationQuerySchema, paginationSchema, service, swiftZodSchema, useFetch, useResult, useResultSync, uuidv4, validateEnvironment };
 export type { ActionExecution, ActionHandlerOptions, AuditLogWriter, Command, CommandLogPayload, DevelitWorkerMethods, Environment, GatewayResponse, IRPCResponse, IncludeRelation, InferResultType, InternalError, InternalErrorResponseStatus, Project, ValidatedInput };

package/dist/index.d.mts

@@ -4,9 +4,9 @@ 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 z from 'zod/v4/core';
 import { StatusCodes, ReasonPhrases } from 'http-status-codes';
 export { ReasonPhrases as InternalResponsePhrase, StatusCodes as InternalResponseStatus } from 'http-status-codes';
-import * as z from 'zod/v4/core';
 import { Queue } from '@cloudflare/workers-types';
 import { BatchItem } from 'drizzle-orm/batch';
 import { DrizzleD1Database } from 'drizzle-orm/d1';
@@ -130,25 +130,28 @@ declare class Infrastructure {
     }): any;
 }
 
-type Resource = 'kv' | 'd1' | 'queue' | 'r2' | 'worker' | 'service' | 'orchestrator';
-
-type InternalErrorResponseStatus = Exclude<StatusCodes, 200 | 201 | 202 | 203 | 204 | 205 | 206 | 207>;
-interface InternalError {
-    status: InternalErrorResponseStatus;
-    code: string;
-    message: string;
+interface AuditLogPayload<T> {
+    action: T;
+    actorId: string;
+    actorUsername?: string;
+    service: string;
+    entityId?: string;
 }
-interface IRPCResponse<T> {
-    status: StatusCodes;
-    message: string;
-    data: T | null | undefined;
-    error: boolean;
-    phrase?: ReasonPhrases;
+
+declare const ibanZodSchema: z.$ZodString<unknown>;
+declare const swiftZodSchema: z.$ZodString<unknown>;
+
+interface CommandLogPayload<T = string> {
+    action: T;
+    actorId: string;
+    actorUsername?: string;
+    entityId?: string;
 }
-interface GatewayResponse<T> {
-    status?: number;
-    message: string;
-    data?: T;
+
+interface CommandItem<TAuditAction = string> {
+    command: BatchItem<'sqlite'>;
+    logPayload: CommandLogPayload<TAuditAction>;
+    id: string;
 }
 
 /**
@@ -171,21 +174,7 @@ type InferResultType<Tables extends Record<string, unknown>, TableName extends k
     with: With;
 }>;
 
-declare const ibanZodSchema: z.$ZodString<unknown>;
-declare const swiftZodSchema: z.$ZodString<unknown>;
-
-interface CommandLogPayload<T = string> {
-    action: T;
-    actorId: string;
-    actorUsername?: string;
-    entityId?: string;
-}
-
-interface CommandItem<TAuditAction = string> {
-    command: BatchItem<'sqlite'>;
-    logPayload: CommandLogPayload<TAuditAction>;
-    id: string;
-}
+type Resource = 'kv' | 'd1' | 'queue' | 'r2' | 'worker' | 'service' | 'orchestrator';
 
 declare const paginationQuerySchema: z.$ZodObject<Readonly<Readonly<{
     [k: string]: z.$ZodType<unknown, unknown, z.$ZodTypeInternals<unknown, unknown>>;
@@ -194,6 +183,38 @@ declare const paginationSchema: z.$ZodObject<Readonly<Readonly<{
     [k: string]: z.$ZodType<unknown, unknown, z.$ZodTypeInternals<unknown, unknown>>;
 }>>, z.$ZodObjectConfig>;
 
+type InternalErrorResponseStatus = Exclude<StatusCodes, 200 | 201 | 202 | 203 | 204 | 205 | 206 | 207>;
+interface InternalError {
+    status: InternalErrorResponseStatus;
+    code: string;
+    message: string;
+}
+interface IRPCResponse<T> {
+    status: StatusCodes;
+    message: string;
+    data: T | null | undefined;
+    error: boolean;
+    phrase?: ReasonPhrases;
+}
+interface GatewayResponse<T> {
+    status?: number;
+    message: string;
+    data?: T;
+}
+
+/**
+ * A utility function to handle operations and return a standardized result.
+ *
+ * This function wraps the call and ensures that both the resolved value
+ * and any potential errors are captured in a structured tuple format.
+ *
+ * @template T - The type of the expected result.
+ * @returns A call that resolves to a tuple containing:
+ *          - The resolved data (`T | null`) if successful.
+ *          - An `RPCError` object (`RPCError | null`) if an error occurs.
+ */
+type Result<T> = [data: T | null, error: InternalError | null];
+
 declare const composeBindingName: ({ resource, resourceName, bindingName, }: {
     resource: Resource;
     resourceName: string;
@@ -287,14 +308,6 @@ type ValidatedInput<T extends z.$ZodType> = z.infer<T>;
  */
 type ActionExecution<TInput, TOutput> = TInput extends null ? () => Promise<TOutput> : (input: TInput) => Promise<TOutput>;
 
-interface AuditLogPayload<T> {
-    action: T;
-    actorId: string;
-    actorUsername?: string;
-    service: string;
-    entityId?: string;
-}
-
 type AuditLogTable = AnySQLiteTable | AnyPgTable;
 type AuditLogWriter<TAuditAction = string> = (logs: AuditLogPayload<TAuditAction>[], db: DrizzleD1Database<Record<string, unknown>>) => BatchItem<'sqlite'>[];
 /**
@@ -406,6 +419,11 @@ declare const createInternalError: (error: unknown, details?: {
 }) => InternalError;
 declare const isInternalError: (error: unknown) => error is InternalError;
 
+interface UseFetchOptions extends RequestInit {
+    parseAs?: 'json' | 'text' | 'blob';
+}
+declare function useFetch<T = unknown>(url: string, { parseAs, ...options }?: UseFetchOptions): Promise<Result<T>>;
+
 declare const getPgLocalConnectionString: (id: string) => string;
 declare const getPgDatabaseIdFromWrangler: () => string | undefined;
 declare const getPgCredentials: (serviceName?: string) => {
@@ -467,18 +485,6 @@ declare const RPCResponse: {
     validationError<T>(error: InternalError): IRPCResponse<T>;
 };
 
-/**
- * A utility function to handle operations and return a standardized result.
- *
- * This function wraps the call and ensures that both the resolved value
- * and any potential errors are captured in a structured tuple format.
- *
- * @template T - The type of the expected result.
- * @returns A call that resolves to a tuple containing:
- *          - The resolved data (`T | null`) if successful.
- *          - An `RPCError` object (`RPCError | null`) if an error occurs.
- */
-type Result<T> = [data: T | null, error: InternalError | null];
 /**
  * Executes a given promise and returns the result in a structured format.
  *
@@ -525,5 +531,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, Infrastructure, RPCResponse, action, bankAccount, bankAccountBankCodeEnum, bankAccountCountryCodeEnum, bankAccountCurrencyEnum, bankAccountPostgres, base, basePostgres, calculateExponentialBackoff, cloudflareQueue, composeBindingName, createAuditLogWriter, createInternalError, defineCommand, derivePortFromId, develitWorker, durableObjectNamespaceIdFromName, first, firstOrError, getD1Credentials, getD1DatabaseIdFromWrangler, getDrizzleD1Config, getDrizzlePgConfig, getPgCredentials, getPgDatabaseIdFromWrangler, getPgLocalConnectionString, handleAction, handleActionResponse, ibanZodSchema, isInternalError, paginationQuerySchema, paginationSchema, service, swiftZodSchema, useResult, useResultSync, uuidv4, validateEnvironment };
+export { DatabaseTransaction, ENVIRONMENT, Infrastructure, RPCResponse, action, bankAccount, bankAccountBankCodeEnum, bankAccountCountryCodeEnum, bankAccountCurrencyEnum, bankAccountPostgres, base, basePostgres, calculateExponentialBackoff, cloudflareQueue, composeBindingName, createAuditLogWriter, createInternalError, defineCommand, derivePortFromId, develitWorker, durableObjectNamespaceIdFromName, first, firstOrError, getD1Credentials, getD1DatabaseIdFromWrangler, getDrizzleD1Config, getDrizzlePgConfig, getPgCredentials, getPgDatabaseIdFromWrangler, getPgLocalConnectionString, handleAction, handleActionResponse, ibanZodSchema, isInternalError, paginationQuerySchema, paginationSchema, service, swiftZodSchema, useFetch, useResult, useResultSync, uuidv4, validateEnvironment };
 export type { ActionExecution, ActionHandlerOptions, AuditLogWriter, Command, CommandLogPayload, DevelitWorkerMethods, Environment, GatewayResponse, IRPCResponse, IncludeRelation, InferResultType, InternalError, InternalErrorResponseStatus, Project, ValidatedInput };

package/dist/index.d.ts

@@ -4,9 +4,9 @@ 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 z from 'zod/v4/core';
 import { StatusCodes, ReasonPhrases } from 'http-status-codes';
 export { ReasonPhrases as InternalResponsePhrase, StatusCodes as InternalResponseStatus } from 'http-status-codes';
-import * as z from 'zod/v4/core';
 import { Queue } from '@cloudflare/workers-types';
 import { BatchItem } from 'drizzle-orm/batch';
 import { DrizzleD1Database } from 'drizzle-orm/d1';
@@ -130,25 +130,28 @@ declare class Infrastructure {
     }): any;
 }
 
-type Resource = 'kv' | 'd1' | 'queue' | 'r2' | 'worker' | 'service' | 'orchestrator';
-
-type InternalErrorResponseStatus = Exclude<StatusCodes, 200 | 201 | 202 | 203 | 204 | 205 | 206 | 207>;
-interface InternalError {
-    status: InternalErrorResponseStatus;
-    code: string;
-    message: string;
+interface AuditLogPayload<T> {
+    action: T;
+    actorId: string;
+    actorUsername?: string;
+    service: string;
+    entityId?: string;
 }
-interface IRPCResponse<T> {
-    status: StatusCodes;
-    message: string;
-    data: T | null | undefined;
-    error: boolean;
-    phrase?: ReasonPhrases;
+
+declare const ibanZodSchema: z.$ZodString<unknown>;
+declare const swiftZodSchema: z.$ZodString<unknown>;
+
+interface CommandLogPayload<T = string> {
+    action: T;
+    actorId: string;
+    actorUsername?: string;
+    entityId?: string;
 }
-interface GatewayResponse<T> {
-    status?: number;
-    message: string;
-    data?: T;
+
+interface CommandItem<TAuditAction = string> {
+    command: BatchItem<'sqlite'>;
+    logPayload: CommandLogPayload<TAuditAction>;
+    id: string;
 }
 
 /**
@@ -171,21 +174,7 @@ type InferResultType<Tables extends Record<string, unknown>, TableName extends k
     with: With;
 }>;
 
-declare const ibanZodSchema: z.$ZodString<unknown>;
-declare const swiftZodSchema: z.$ZodString<unknown>;
-
-interface CommandLogPayload<T = string> {
-    action: T;
-    actorId: string;
-    actorUsername?: string;
-    entityId?: string;
-}
-
-interface CommandItem<TAuditAction = string> {
-    command: BatchItem<'sqlite'>;
-    logPayload: CommandLogPayload<TAuditAction>;
-    id: string;
-}
+type Resource = 'kv' | 'd1' | 'queue' | 'r2' | 'worker' | 'service' | 'orchestrator';
 
 declare const paginationQuerySchema: z.$ZodObject<Readonly<Readonly<{
     [k: string]: z.$ZodType<unknown, unknown, z.$ZodTypeInternals<unknown, unknown>>;
@@ -194,6 +183,38 @@ declare const paginationSchema: z.$ZodObject<Readonly<Readonly<{
     [k: string]: z.$ZodType<unknown, unknown, z.$ZodTypeInternals<unknown, unknown>>;
 }>>, z.$ZodObjectConfig>;
 
+type InternalErrorResponseStatus = Exclude<StatusCodes, 200 | 201 | 202 | 203 | 204 | 205 | 206 | 207>;
+interface InternalError {
+    status: InternalErrorResponseStatus;
+    code: string;
+    message: string;
+}
+interface IRPCResponse<T> {
+    status: StatusCodes;
+    message: string;
+    data: T | null | undefined;
+    error: boolean;
+    phrase?: ReasonPhrases;
+}
+interface GatewayResponse<T> {
+    status?: number;
+    message: string;
+    data?: T;
+}
+
+/**
+ * A utility function to handle operations and return a standardized result.
+ *
+ * This function wraps the call and ensures that both the resolved value
+ * and any potential errors are captured in a structured tuple format.
+ *
+ * @template T - The type of the expected result.
+ * @returns A call that resolves to a tuple containing:
+ *          - The resolved data (`T | null`) if successful.
+ *          - An `RPCError` object (`RPCError | null`) if an error occurs.
+ */
+type Result<T> = [data: T | null, error: InternalError | null];
+
 declare const composeBindingName: ({ resource, resourceName, bindingName, }: {
     resource: Resource;
     resourceName: string;
@@ -287,14 +308,6 @@ type ValidatedInput<T extends z.$ZodType> = z.infer<T>;
  */
 type ActionExecution<TInput, TOutput> = TInput extends null ? () => Promise<TOutput> : (input: TInput) => Promise<TOutput>;
 
-interface AuditLogPayload<T> {
-    action: T;
-    actorId: string;
-    actorUsername?: string;
-    service: string;
-    entityId?: string;
-}
-
 type AuditLogTable = AnySQLiteTable | AnyPgTable;
 type AuditLogWriter<TAuditAction = string> = (logs: AuditLogPayload<TAuditAction>[], db: DrizzleD1Database<Record<string, unknown>>) => BatchItem<'sqlite'>[];
 /**
@@ -406,6 +419,11 @@ declare const createInternalError: (error: unknown, details?: {
 }) => InternalError;
 declare const isInternalError: (error: unknown) => error is InternalError;
 
+interface UseFetchOptions extends RequestInit {
+    parseAs?: 'json' | 'text' | 'blob';
+}
+declare function useFetch<T = unknown>(url: string, { parseAs, ...options }?: UseFetchOptions): Promise<Result<T>>;
+
 declare const getPgLocalConnectionString: (id: string) => string;
 declare const getPgDatabaseIdFromWrangler: () => string | undefined;
 declare const getPgCredentials: (serviceName?: string) => {
@@ -467,18 +485,6 @@ declare const RPCResponse: {
     validationError<T>(error: InternalError): IRPCResponse<T>;
 };
 
-/**
- * A utility function to handle operations and return a standardized result.
- *
- * This function wraps the call and ensures that both the resolved value
- * and any potential errors are captured in a structured tuple format.
- *
- * @template T - The type of the expected result.
- * @returns A call that resolves to a tuple containing:
- *          - The resolved data (`T | null`) if successful.
- *          - An `RPCError` object (`RPCError | null`) if an error occurs.
- */
-type Result<T> = [data: T | null, error: InternalError | null];
 /**
  * Executes a given promise and returns the result in a structured format.
  *
@@ -525,5 +531,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, Infrastructure, RPCResponse, action, bankAccount, bankAccountBankCodeEnum, bankAccountCountryCodeEnum, bankAccountCurrencyEnum, bankAccountPostgres, base, basePostgres, calculateExponentialBackoff, cloudflareQueue, composeBindingName, createAuditLogWriter, createInternalError, defineCommand, derivePortFromId, develitWorker, durableObjectNamespaceIdFromName, first, firstOrError, getD1Credentials, getD1DatabaseIdFromWrangler, getDrizzleD1Config, getDrizzlePgConfig, getPgCredentials, getPgDatabaseIdFromWrangler, getPgLocalConnectionString, handleAction, handleActionResponse, ibanZodSchema, isInternalError, paginationQuerySchema, paginationSchema, service, swiftZodSchema, useResult, useResultSync, uuidv4, validateEnvironment };
+export { DatabaseTransaction, ENVIRONMENT, Infrastructure, RPCResponse, action, bankAccount, bankAccountBankCodeEnum, bankAccountCountryCodeEnum, bankAccountCurrencyEnum, bankAccountPostgres, base, basePostgres, calculateExponentialBackoff, cloudflareQueue, composeBindingName, createAuditLogWriter, createInternalError, defineCommand, derivePortFromId, develitWorker, durableObjectNamespaceIdFromName, first, firstOrError, getD1Credentials, getD1DatabaseIdFromWrangler, getDrizzleD1Config, getDrizzlePgConfig, getPgCredentials, getPgDatabaseIdFromWrangler, getPgLocalConnectionString, handleAction, handleActionResponse, ibanZodSchema, isInternalError, paginationQuerySchema, paginationSchema, service, swiftZodSchema, useFetch, useResult, useResultSync, uuidv4, validateEnvironment };
 export type { ActionExecution, ActionHandlerOptions, AuditLogWriter, Command, CommandLogPayload, DevelitWorkerMethods, Environment, GatewayResponse, IRPCResponse, IncludeRelation, InferResultType, InternalError, InternalErrorResponseStatus, Project, ValidatedInput };

package/dist/index.mjs

@@ -3,8 +3,8 @@ import { timestamp, uuid, pgEnum, text as text$1 } from 'drizzle-orm/pg-core';
 import { integer, text } from 'drizzle-orm/sqlite-core';
 import { COUNTRY_CODES_2, CURRENCY_CODES, BANK_CODES } from '@develit-io/general-codes';
 import { toSnakeCase } from '@std/text';
-import 'http-status-codes';
 import * as z from 'zod/v4/core';
+import 'http-status-codes';
 import { createError } from 'h3';
 import fs from 'node:fs';
 import crypto$1 from 'node:crypto';
@@ -663,6 +663,39 @@ const defineCommand = (handler) => {
   }));
 };
 
+async function useFetch(url, { parseAs = "json", ...options } = {}) {
+  const [response, fetchError] = await useResult(fetch(url, options));
+  if (fetchError || !response) {
+    return [null, createInternalError(fetchError, { code: "NETWORK_ERROR" })];
+  }
+  const parsers = {
+    json: () => response.json(),
+    text: () => response.text(),
+    blob: () => response.blob()
+  };
+  const [body, parseError] = await useResult(parsers[parseAs]());
+  if (!response.ok) {
+    return [
+      null,
+      createInternalError(parseError, {
+        message: body?.message ?? response.statusText,
+        code: "HTTP_ERROR",
+        status: response.status
+      })
+    ];
+  }
+  if (parseError) {
+    return [
+      null,
+      createInternalError(parseError, {
+        code: "PARSE_ERROR",
+        status: response.status
+      })
+    ];
+  }
+  return [body, null];
+}
+
 const getPgLocalConnectionString = (id) => `postgres://db_user:db_password@127.0.0.1:${derivePortFromId(id)}/db`;
 const getPgDatabaseIdFromWrangler = () => {
   try {
@@ -852,4 +885,4 @@ function develitWorker(Worker) {
   return DevelitWorker;
 }
 
-export { DatabaseTransaction, ENVIRONMENT, Infrastructure, RPCResponse, action, bankAccount, bankAccountBankCodeEnum, bankAccountCountryCodeEnum, bankAccountCurrencyEnum, bankAccountPostgres, base, basePostgres, calculateExponentialBackoff, cloudflareQueue, composeBindingName, createAuditLogWriter, createInternalError, defineCommand, derivePortFromId, develitWorker, durableObjectNamespaceIdFromName, first, firstOrError, getD1Credentials, getD1DatabaseIdFromWrangler, getDrizzleD1Config, getDrizzlePgConfig, getPgCredentials, getPgDatabaseIdFromWrangler, getPgLocalConnectionString, handleAction, handleActionResponse, ibanZodSchema, isInternalError, paginationQuerySchema, paginationSchema, service, swiftZodSchema, useResult, useResultSync, uuidv4, validateEnvironment };
+export { DatabaseTransaction, ENVIRONMENT, Infrastructure, RPCResponse, action, bankAccount, bankAccountBankCodeEnum, bankAccountCountryCodeEnum, bankAccountCurrencyEnum, bankAccountPostgres, base, basePostgres, calculateExponentialBackoff, cloudflareQueue, composeBindingName, createAuditLogWriter, createInternalError, defineCommand, derivePortFromId, develitWorker, durableObjectNamespaceIdFromName, first, firstOrError, getD1Credentials, getD1DatabaseIdFromWrangler, getDrizzleD1Config, getDrizzlePgConfig, getPgCredentials, getPgDatabaseIdFromWrangler, getPgLocalConnectionString, handleAction, handleActionResponse, ibanZodSchema, isInternalError, paginationQuerySchema, paginationSchema, service, swiftZodSchema, useFetch, useResult, useResultSync, uuidv4, validateEnvironment };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@develit-io/backend-sdk",
-  "version": "5.19.0",
+  "version": "5.21.0",
   "description": "Develit Backend SDK",
   "author": "Develit.io",
   "license": "ISC",
@@ -18,19 +18,17 @@
   },
   "exports": {
     ".": {
+      "types": "./dist/index.d.ts",
       "import": "./dist/index.mjs",
-      "require": "./dist/index.cjs",
-      "types": "./dist/index.d.ts"
+      "require": "./dist/index.cjs"
     },
     "./node": {
+      "types": "./dist/node/index.d.ts",
       "import": "./dist/node/index.mjs",
-      "require": "./dist/node/index.cjs",
-      "types": "./dist/node/index.d.ts"
+      "require": "./dist/node/index.cjs"
     },
     "./package.json": "./package.json"
   },
-  "main": "./dist/index.cjs",
-  "types": "./dist/index.d.ts",
   "files": [
     "dist"
   ],