@develit-io/backend-sdk 5.20.0 → 5.21.1

package/dist/index.cjs

@@ -5,8 +5,9 @@ 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 cloudflare = require('alchemy/cloudflare');
 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');
@@ -81,12 +82,9 @@ const composeD1Arguments = ({
   resourceName
 }) => {
   return {
-    transform: {
-      database: {
-        name: resourceName,
-        primaryLocationHint: "weur"
-      }
-    }
+    name: resourceName,
+    primaryLocationHint: "weur"
+    // TODO: It's possible that it will take care of migrations as well
   };
 };
 
@@ -94,11 +92,7 @@ const composeKvArguments = ({
   resourceName
 }) => {
   return {
-    transform: {
-      namespace: {
-        title: resourceName
-      }
-    }
+    title: resourceName
   };
 };
 
@@ -108,14 +102,10 @@ const composeQueueArguments = ({
   messageRetentionPeriod = 259200
 }) => {
   return {
-    transform: {
-      queue: {
-        queueName: resourceName,
-        settings: {
-          deliveryDelay,
-          messageRetentionPeriod
-        }
-      }
+    name: resourceName,
+    settings: {
+      deliveryDelay,
+      messageRetentionPeriod
     }
   };
 };
@@ -125,14 +115,10 @@ const composeR2Arguments = ({
   storageClass = "Standard"
 }) => {
   return {
-    transform: {
-      bucket: {
-        name: resourceName,
-        jurisdiction: "eu",
-        location: "weur",
-        storageClass
-      }
-    }
+    name: resourceName,
+    jurisdiction: "eu",
+    locationHint: "weur",
+    storageClass
   };
 };
 
@@ -155,23 +141,20 @@ const composeResourceName = ({
 class Infrastructure {
   project;
   environment;
-  sst;
   constructor({
     project,
-    environment,
-    sst
+    environment
   }) {
     this.project = project;
     this.environment = environment;
-    this.sst = sst;
   }
   /**
    * Creates an instance of Cloudflare KV.
    */
-  kv(options) {
-    const { resourceName, bindingName } = options;
-    return new this.sst.cloudflare.Kv(
-      `${composeBindingName({ resource: "kv", resourceName, bindingName })}`,
+  async kv(options) {
+    const { resourceName } = options;
+    return await cloudflare.KVNamespace(
+      resourceName,
       composeKvArguments({
         resourceName: composeResourceName({
           project: this.project,
@@ -184,10 +167,10 @@ class Infrastructure {
   /**
    * Creates an instance of Cloudflare D1.
    */
-  d1(options) {
-    const { resourceName, bindingName } = options;
-    return new this.sst.cloudflare.D1(
-      `${composeBindingName({ resource: "d1", resourceName, bindingName })}`,
+  async d1(options) {
+    const { resourceName } = options;
+    return await cloudflare.D1Database(
+      resourceName,
       composeD1Arguments({
         resourceName: composeResourceName({
           project: this.project,
@@ -200,10 +183,10 @@ class Infrastructure {
   /**
    * Creates an instance of Cloudflare Queue.
    */
-  queue(options) {
-    const { resourceName, bindingName, deliveryDelay, messageRetentionPeriod } = options;
-    return new this.sst.cloudflare.Queue(
-      `${composeBindingName({ resource: "queue", resourceName, bindingName })}`,
+  async queue(options) {
+    const { resourceName, deliveryDelay, messageRetentionPeriod } = options;
+    return await cloudflare.Queue(
+      resourceName,
       composeQueueArguments({
         resourceName: composeResourceName({
           project: this.project,
@@ -218,10 +201,10 @@ class Infrastructure {
   /**
    * Creates an instance of Cloudflare R2.
    */
-  r2(options) {
-    const { resourceName, bindingName, storageClass } = options;
-    return new this.sst.cloudflare.Bucket(
-      `${composeBindingName({ resource: "r2", resourceName, bindingName })}`,
+  async r2(options) {
+    const { resourceName, storageClass } = options;
+    return await cloudflare.R2Bucket(
+      resourceName,
       composeR2Arguments({
         resourceName: composeResourceName({
           project: this.project,
@@ -685,6 +668,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 +928,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,10 +4,11 @@ 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 { KVNamespace, D1Database, Queue, R2Bucket } from 'alchemy/cloudflare';
+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 { Queue as Queue$1 } from '@cloudflare/workers-types';
 import { BatchItem } from 'drizzle-orm/batch';
 import { DrizzleD1Database } from 'drizzle-orm/d1';
 
@@ -50,19 +51,12 @@ type Project = 'creditio' | 'fp' | 'mdm' | 'moneio' | 'txs';
 
 type Environment = number | 'dev' | 'test' | 'staging' | 'production';
 
-interface SstInstance {
-    cloudflare: {
-        [key: string]: any;
-    };
-}
 declare class Infrastructure {
     private project;
     private environment;
-    private sst;
-    constructor({ project, environment, sst, }: {
+    constructor({ project, environment, }: {
         project: Project;
         environment: Environment;
-        sst: SstInstance;
     });
     /**
      * Creates an instance of Cloudflare KV.
@@ -72,11 +66,7 @@ declare class Infrastructure {
          * Name of the KV. Do not include the 'kv' prefix.
          */
         resourceName: string;
-        /**
-         * Name of the KV's binding. If not set, it is generated automatically based on the provided name.
-         */
-        bindingName?: string;
-    }): any;
+    }): Promise<KVNamespace>;
     /**
      * Creates an instance of Cloudflare D1.
      */
@@ -85,11 +75,7 @@ declare class Infrastructure {
          * Name of the D1. Do not include the 'd1' prefix.
          */
         resourceName: string;
-        /**
-         * Name of the D1's binding. If not set, it is generated automatically based on the provided name.
-         */
-        bindingName?: string;
-    }): any;
+    }): Promise<D1Database>;
     /**
      * Creates an instance of Cloudflare Queue.
      */
@@ -98,10 +84,6 @@ declare class Infrastructure {
          * Name of the Queue. Do not include the 'queue' prefix.
          */
         resourceName: string;
-        /**
-         * Name of the Queue's binding. If not set, it is generated automatically based on the provided name.
-         */
-        bindingName?: string;
         /**
          * The number of seconds to delay delivery of messages to the queue.
          */
@@ -110,7 +92,7 @@ declare class Infrastructure {
          * The number of seconds a message will remain in the queue before being deleted.
          */
         messageRetentionPeriod?: number;
-    }): any;
+    }): Promise<Queue<unknown>>;
     /**
      * Creates an instance of Cloudflare R2.
      */
@@ -119,36 +101,35 @@ declare class Infrastructure {
          * Name of the R2. Do not include the 'r2' prefix.
          */
         resourceName: string;
-        /**
-         * Name of the R2's binding. If not set, it is generated automatically based on the provided name.
-         */
-        bindingName?: string;
         /**
          * The storage class for the R2 bucket.
          */
         storageClass?: 'Standard' | 'InfrequentAccess';
-    }): any;
+    }): Promise<R2Bucket>;
 }
 
-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 +152,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 +161,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;
@@ -223,8 +222,8 @@ interface DevelitWorkerMethods {
     logInput(data: object): void;
     logOutput(data: object): void;
     logError(error: object): void;
-    pushToQueue<T>(queue: Queue, message: T | T[]): Promise<void>;
-    recordAuditLogMessage<T>(queue: Queue, message: T | T[]): Promise<void>;
+    pushToQueue<T>(queue: Queue$1, message: T | T[]): Promise<void>;
+    recordAuditLogMessage<T>(queue: Queue$1, message: T | T[]): Promise<void>;
     handleInput<T extends z.$ZodType>(args: {
         input: z.infer<T>;
         schema: T;
@@ -287,14 +286,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'>[];
 /**
@@ -316,7 +307,7 @@ type AuditLogWriter<TAuditAction = string> = (logs: AuditLogPayload<TAuditAction
  */
 declare function createAuditLogWriter<TAuditAction = string>(table: AuditLogTable): AuditLogWriter<TAuditAction>;
 
-declare function durableObjectNamespaceIdFromName(uniqueKey: string, name: string): string;
+declare function durableObjectNamespaceIdFromName(uniqueKey: string, name: string): any;
 declare const getD1DatabaseIdFromWrangler: () => string | undefined;
 declare const getD1Credentials: () => {
     driver?: undefined;
@@ -324,14 +315,14 @@ declare const getD1Credentials: () => {
 } | {
     driver: string;
     dbCredentials: {
-        accountId: string | undefined;
+        accountId: any;
         databaseId: string;
-        token: string | undefined;
+        token: any;
         url?: undefined;
     };
 } | {
     dbCredentials: {
-        url: string | undefined;
+        url: any;
         accountId?: undefined;
         databaseId?: undefined;
         token?: undefined;
@@ -347,9 +338,9 @@ declare const getDrizzleD1Config: () => {
 } | {
     driver: string;
     dbCredentials: {
-        accountId: string | undefined;
+        accountId: any;
         databaseId: string;
-        token: string | undefined;
+        token: any;
         url?: undefined;
     };
     schema: string;
@@ -357,7 +348,7 @@ declare const getDrizzleD1Config: () => {
     dialect: "sqlite";
 } | {
     dbCredentials: {
-        url: string | undefined;
+        url: any;
         accountId?: undefined;
         databaseId?: undefined;
         token?: undefined;
@@ -406,11 +397,16 @@ 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) => {
     dbCredentials: {
-        url: string;
+        url: any;
     };
 };
 declare const getDrizzlePgConfig: () => {
@@ -419,7 +415,7 @@ declare const getDrizzlePgConfig: () => {
         schema: string;
     };
     dbCredentials: {
-        url: string;
+        url: any;
     };
     schema: string;
     out: string;
@@ -467,18 +463,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 +509,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 };