glasswork 1.5.0 → 1.6.1

package/dist/utils/module-interop.js

@@ -0,0 +1,16 @@
+/**
+ * Named exports of a dynamically imported module.
+ *
+ * Node exposes the named exports of a CommonJS package through `import()`, but a bundler that
+ * turns the package into an ESM chunk may expose them only as `default`. Optional peers such
+ * as the AWS SDK clients are CommonJS packages, so read their exports from either place.
+ */
+export function namedExports(module) {
+    // Check first: module mocks may throw for an export they do not define.
+    const fallback = 'default' in module ? module.default : undefined;
+    if (fallback === null || (typeof fallback !== 'object' && typeof fallback !== 'function')) {
+        return module;
+    }
+    return { ...fallback, ...module };
+}
+//# sourceMappingURL=module-interop.js.map

package/dist/utils/module-interop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-interop.js","sourceRoot":"","sources":["../../src/utils/module-interop.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAmB,MAAS;IACtD,wEAAwE;IACxE,MAAM,QAAQ,GAAG,SAAS,IAAI,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IAClE,IAAI,QAAQ,KAAK,IAAI,IAAI,CAAC,OAAO,QAAQ,KAAK,QAAQ,IAAI,OAAO,QAAQ,KAAK,UAAU,CAAC,EAAE,CAAC;QAC1F,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,OAAO,EAAE,GAAG,QAAQ,EAAE,GAAG,MAAM,EAAO,CAAC;AACzC,CAAC"}

package/dist/utils/optional-dependency.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Loads an optional peer the first time an adapter needs it, so importing the adapter's entry
+ * point works without the peer installed. A missing peer fails with an install hint.
+ */
+export declare function optionalDependency<T extends object>(name: string, user: string, load: () => Promise<T>): () => Promise<T>;
+//# sourceMappingURL=optional-dependency.d.ts.map

package/dist/utils/optional-dependency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"optional-dependency.d.ts","sourceRoot":"","sources":["../../src/utils/optional-dependency.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,MAAM,EACjD,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACrB,MAAM,OAAO,CAAC,CAAC,CAAC,CASlB"}

package/dist/utils/optional-dependency.js

@@ -0,0 +1,16 @@
+import { namedExports } from './module-interop.js';
+/**
+ * Loads an optional peer the first time an adapter needs it, so importing the adapter's entry
+ * point works without the peer installed. A missing peer fails with an install hint.
+ */
+export function optionalDependency(name, user, load) {
+    let loading;
+    return () => {
+        loading ??= load().then(namedExports, (cause) => {
+            loading = undefined;
+            throw new Error(`${user} requires ${name}. Install it with: npm install ${name}`, { cause });
+        });
+        return loading;
+    };
+}
+//# sourceMappingURL=optional-dependency.js.map

package/dist/utils/optional-dependency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"optional-dependency.js","sourceRoot":"","sources":["../../src/utils/optional-dependency.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAAY,EACZ,IAAY,EACZ,IAAsB;IAEtB,IAAI,OAA+B,CAAC;IACpC,OAAO,GAAG,EAAE;QACV,OAAO,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,KAAc,EAAE,EAAE;YACvD,OAAO,GAAG,SAAS,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,aAAa,IAAI,kCAAkC,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC/F,CAAC,CAAC,CAAC;QACH,OAAO,OAAO,CAAC;IACjB,CAAC,CAAC;AACJ,CAAC"}

package/dist/utils/serialize-prisma-types.d.ts

@@ -1,34 +1,62 @@
+import type { ConfiguredDecimalSerialization, DecimalSerialization } from '../core/glasswork-config.js';
 /**
  * Type helper to recursively convert Date and Decimal fields in an object type
  * - Date → string (ISO 8601)
- * - Decimal → number
+ * - Decimal → number, or string when `TDecimals` is `'string'`
  *
  * Note: Decimal is from Prisma's Decimal.js, but we don't import the type
- * to avoid hard dependency on @prisma/client
+ * to avoid hard dependency on @prisma/client. It is matched structurally through
+ * {@link PrismaDecimalLike}.
  */
-export type SerializedTypes<T> = T extends Date ? string : T extends {
+export type SerializedTypes<T, TDecimals extends DecimalSerialization = 'number'> = T extends Date ? string : T extends PrismaDecimalLike | {
     constructor: {
         name: 'Decimal';
     };
-} ? number : T extends Array<infer U> ? Array<SerializedTypes<U>> : T extends object ? {
-    [K in keyof T]: SerializedTypes<T[K]>;
+} ? TDecimals extends 'string' ? string : number : T extends Array<infer U> ? Array<SerializedTypes<U, TDecimals>> : T extends object ? {
+    [K in keyof T]: SerializedTypes<T[K], TDecimals>;
 } : T;
 /**
  * Type for a transformer function that converts a value to a serializable type
  */
 export type TypeTransformer = (value: unknown) => unknown;
 /**
- * Configuration for type serialization
+ * Configuration for type serialization. Build one with {@link createSerializationConfig}, or
+ * list the transformers directly.
  */
-export interface SerializationConfig {
+export interface SerializationConfig<TDecimals extends DecimalSerialization = 'number'> {
     /**
      * Custom transformers to apply to specific types
      * The function should return the transformed value or undefined if not applicable
      */
     transformers: TypeTransformer[];
+    /**
+     * How the built-in transformer serializes Decimal values; `'number'` when absent. Set by
+     * {@link createSerializationConfig}, which picks the matching transformer.
+     */
+    decimals?: TDecimals;
 }
 /**
- * Default configuration with built-in transformers for Date and Decimal types.
+ * Build a serialization configuration: your transformers first, then the built-in Date and
+ * Decimal handling. `bootstrap()` builds the application-wide configuration this way from its
+ * `serialization` option; use this for calls to `serializePrismaTypes()` outside routes.
+ *
+ * @example
+ * ```typescript
+ * const config = createSerializationConfig({
+ *   decimals: 'string',
+ *   transformers: [moneyTransformer],
+ * });
+ *
+ * serializePrismaTypes({ price: new Decimal('10.50') }, config);
+ * // { price: '10.50' }
+ * ```
+ */
+export declare function createSerializationConfig<TDecimals extends DecimalSerialization = 'number'>(options?: {
+    decimals?: TDecimals;
+    transformers?: TypeTransformer[];
+}): SerializationConfig<TDecimals>;
+/**
+ * Default configuration with built-in transformers for Date and Decimal types (as numbers).
  * Export this if you want to extend it with custom transformers.
  *
  * @example
@@ -51,7 +79,7 @@ export declare const defaultConfig: SerializationConfig;
  *
  * This utility handles the mismatch between Prisma's data types and API response DTOs:
  * - Date objects → ISO 8601 strings
- * - Decimal objects → numbers
+ * - Decimal objects → numbers, or strings with a `decimals: 'string'` configuration
  *
  * It preserves null values and handles nested objects and arrays.
  * You can extend it with custom transformers for additional types.
@@ -62,8 +90,9 @@ export declare const defaultConfig: SerializationConfig;
  * you'll need to use type assertions or `strictTypes: true` in your route handlers.
  *
  * @template T - The type of data to transform
+ * @template TDecimals - The Decimal serialization of `config`, which decides the result type
  * @param data - The data to transform (object, array, or primitive)
- * @param config - Optional configuration with custom transformers
+ * @param config - Optional configuration, see {@link createSerializationConfig}
  * @returns The same structure with Prisma types converted to JSON-serializable types
  *
  * @example
@@ -103,7 +132,7 @@ export declare const defaultConfig: SerializationConfig;
  * }
  * ```
  */
-export declare function serializePrismaTypes<T>(data: T, config?: SerializationConfig, _depth?: number, _ancestors?: WeakSet<object>): SerializedTypes<T>;
+export declare function serializePrismaTypes<T, TDecimals extends DecimalSerialization = 'number'>(data: T, config?: SerializationConfig<TDecimals>, _depth?: number, _ancestors?: WeakSet<object>): SerializedTypes<T, TDecimals>;
 /**
  * Type representing Prisma's Decimal type structure.
  * We use a structural type to avoid importing from @prisma/client.
@@ -136,6 +165,8 @@ type DateFieldPattern = `${string}At` | `${string}Date` | `${string}Time` | `${s
  * - For Date fields: Only string fields with conventional date names (ending in `At`, `Date`, `Time`, etc.)
  *   accept Date objects. Other string fields only accept strings.
  * - For Decimal fields: All number fields accept Decimal-like objects (see rationale below).
+ *   When `GlassworkConfig` declares `decimals: 'string'`, the non-date string fields accept
+ *   them instead, because Decimals then serialize to strings.
  * - Recursively applies to objects and arrays.
  *
  * **Date Field Detection:**
@@ -208,12 +239,17 @@ type DateFieldPattern = `${string}At` | `${string}Date` | `${string}Time` | `${s
  */
 type WithDateSupport<T> = T extends string | infer Rest ? string | Date | Rest : T;
 /**
- * Helper type to add Decimal support to number types (including nullable numbers).
- * Preserves null and undefined in unions.
+ * The type a Decimal serializes into, as declared in `GlassworkConfig` (`number` by default).
+ */
+type DecimalField = ConfiguredDecimalSerialization extends 'string' ? string : number;
+/**
+ * Helper type to add Decimal support to the fields Decimals serialize into (including nullable
+ * ones). Preserves null and undefined in unions. Literal unions such as `'open' | 'closed'`
+ * and `1 | 2` stay as they are, because a Decimal never serializes into one of them.
  */
-type WithDecimalSupport<T> = T extends number | infer Rest ? number | PrismaDecimalLike | Rest : T;
+type WithDecimalSupport<T> = DecimalField extends T ? T | PrismaDecimalLike : T;
 export type AcceptPrismaTypes<T, AdditionalDatePatterns extends string = never> = T extends object ? T extends Array<infer U> ? Array<AcceptPrismaTypes<U, AdditionalDatePatterns>> : {
-    [K in keyof T]: K extends string ? K extends DateFieldPattern | AdditionalDatePatterns ? T[K] extends string | null | undefined ? WithDateSupport<T[K]> : AcceptPrismaTypes<T[K], AdditionalDatePatterns> : T[K] extends number | null | undefined ? WithDecimalSupport<T[K]> : AcceptPrismaTypes<T[K], AdditionalDatePatterns> : AcceptPrismaTypes<T[K], AdditionalDatePatterns>;
+    [K in keyof T]: K extends string ? K extends DateFieldPattern | AdditionalDatePatterns ? T[K] extends string | null | undefined ? WithDateSupport<T[K]> : AcceptPrismaTypes<T[K], AdditionalDatePatterns> : T[K] extends DecimalField | null | undefined ? WithDecimalSupport<T[K]> : AcceptPrismaTypes<T[K], AdditionalDatePatterns> : AcceptPrismaTypes<T[K], AdditionalDatePatterns>;
 } : T;
 export {};
 //# sourceMappingURL=serialize-prisma-types.d.ts.map

package/dist/utils/serialize-prisma-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serialize-prisma-types.d.ts","sourceRoot":"","sources":["../../src/utils/serialize-prisma-types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"serialize-prisma-types.d.ts","sourceRoot":"","sources":["../../src/utils/serialize-prisma-types.ts"],"names":[],"mappings":"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"}

package/dist/utils/serialize-prisma-types.js

@@ -38,19 +38,51 @@ function isDecimal(value) {
     return hasDecimalStructure || hasDecimalConstructor;
 }
 /**
- * Default transformer that handles Date and Decimal types
+ * Serialize a Decimal in plain notation with every digit and the stored scale. `toString()`
+ * and `toJSON()` switch to exponential notation for large and small values.
  */
-const defaultTransformer = (value) => {
-    if (value instanceof Date) {
-        return value.toISOString();
-    }
-    if (isDecimal(value)) {
-        return value.toNumber();
-    }
-    return undefined; // Not handled by this transformer
-};
+function decimalToString(value) {
+    return typeof value.toFixed === 'function' ? value.toFixed() : String(value);
+}
+/**
+ * Build the transformer that handles Date and Decimal types
+ */
+function createDefaultTransformer(decimals) {
+    return (value) => {
+        if (value instanceof Date) {
+            return value.toISOString();
+        }
+        if (isDecimal(value)) {
+            return decimals === 'string' ? decimalToString(value) : value.toNumber();
+        }
+        return undefined; // Not handled by this transformer
+    };
+}
+/**
+ * Build a serialization configuration: your transformers first, then the built-in Date and
+ * Decimal handling. `bootstrap()` builds the application-wide configuration this way from its
+ * `serialization` option; use this for calls to `serializePrismaTypes()` outside routes.
+ *
+ * @example
+ * ```typescript
+ * const config = createSerializationConfig({
+ *   decimals: 'string',
+ *   transformers: [moneyTransformer],
+ * });
+ *
+ * serializePrismaTypes({ price: new Decimal('10.50') }, config);
+ * // { price: '10.50' }
+ * ```
+ */
+export function createSerializationConfig(options = {}) {
+    const decimals = (options.decimals ?? 'number');
+    return {
+        decimals,
+        transformers: [...(options.transformers ?? []), createDefaultTransformer(decimals)],
+    };
+}
 /**
- * Default configuration with built-in transformers for Date and Decimal types.
+ * Default configuration with built-in transformers for Date and Decimal types (as numbers).
  * Export this if you want to extend it with custom transformers.
  *
  * @example
@@ -67,15 +99,13 @@ const defaultTransformer = (value) => {
  * serializePrismaTypes(data, customConfig);
  * ```
  */
-export const defaultConfig = {
-    transformers: [defaultTransformer],
-};
+export const defaultConfig = createSerializationConfig();
 /**
  * Recursively converts Prisma types to JSON-serializable equivalents.
  *
  * This utility handles the mismatch between Prisma's data types and API response DTOs:
  * - Date objects → ISO 8601 strings
- * - Decimal objects → numbers
+ * - Decimal objects → numbers, or strings with a `decimals: 'string'` configuration
  *
  * It preserves null values and handles nested objects and arrays.
  * You can extend it with custom transformers for additional types.
@@ -86,8 +116,9 @@ export const defaultConfig = {
  * you'll need to use type assertions or `strictTypes: true` in your route handlers.
  *
  * @template T - The type of data to transform
+ * @template TDecimals - The Decimal serialization of `config`, which decides the result type
  * @param data - The data to transform (object, array, or primitive)
- * @param config - Optional configuration with custom transformers
+ * @param config - Optional configuration, see {@link createSerializationConfig}
  * @returns The same structure with Prisma types converted to JSON-serializable types
  *
  * @example

package/dist/utils/serialize-prisma-types.js.map

@@ -1 +1 @@
-{"version":3,"file":"serialize-prisma-types.js","sourceRoot":"","sources":["../../src/utils/serialize-prisma-types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"serialize-prisma-types.js","sourceRoot":"","sources":["../../src/utils/serialize-prisma-types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "glasswork",
-  "version": "1.5.0",
+  "version": "1.6.1",
   "description": "A transparent, Lambda-optimized web framework for building OpenAPI-compliant REST APIs.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -41,11 +41,41 @@
       "import": "./dist/jobs/index.js",
       "default": "./dist/jobs/index.js"
     },
+    "./jobs/sqs": {
+      "types": "./dist/jobs/sqs.d.ts",
+      "import": "./dist/jobs/sqs.js",
+      "default": "./dist/jobs/sqs.js"
+    },
+    "./jobs/scheduler": {
+      "types": "./dist/jobs/scheduler.d.ts",
+      "import": "./dist/jobs/scheduler.js",
+      "default": "./dist/jobs/scheduler.js"
+    },
     "./email": {
       "types": "./dist/email/index.d.ts",
       "import": "./dist/email/index.js",
       "default": "./dist/email/index.js"
     },
+    "./email/ses": {
+      "types": "./dist/email/ses.d.ts",
+      "import": "./dist/email/ses.js",
+      "default": "./dist/email/ses.js"
+    },
+    "./email/smtp": {
+      "types": "./dist/email/smtp.d.ts",
+      "import": "./dist/email/smtp.js",
+      "default": "./dist/email/smtp.js"
+    },
+    "./email/compiler": {
+      "types": "./dist/email/compiler/index.d.ts",
+      "import": "./dist/email/compiler/index.js",
+      "default": "./dist/email/compiler/index.js"
+    },
+    "./email/webhooks": {
+      "types": "./dist/email/webhooks/index.d.ts",
+      "import": "./dist/email/webhooks/index.js",
+      "default": "./dist/email/webhooks/index.js"
+    },
     "./uploads": {
       "types": "./dist/uploads/index.d.ts",
       "import": "./dist/uploads/index.js",
@@ -120,9 +150,10 @@
     "lint": "biome check . --write",
     "lint:ci": "biome check .",
     "typecheck": "prisma generate --schema test/rls/fixtures/schema.prisma && tsc --noEmit && tsc --noEmit -p tsconfig.rls-tests.json && tsc --noEmit -p tsconfig.scripts.json",
-    "typecheck:strict": "tsc --noEmit -p tsconfig.strict.json",
+    "typecheck:strict": "prisma generate --schema test/rls/fixtures/schema.prisma && tsc --noEmit -p tsconfig.strict.json",
     "smoke:pack": "npm run build:scripts && node .scripts/smoke-pack-consumer.js",
-    "verify": "npm run typecheck && npm run lint:ci && npm run build && npm run test && npm run smoke:pack",
+    "consumer:reference": "npm run build:scripts && node .scripts/reference-consumer.js",
+    "verify": "npm run typecheck && npm run typecheck:strict && npm run lint:ci && npm run build && npm run test && npm run smoke:pack",
     "prepublishOnly": "npm run verify",
     "docs:dev": "vitepress dev docs",
     "docs:build": "vitepress build docs",
@@ -150,6 +181,7 @@
     "dotenv": "^17.0.0",
     "hono": "^4.12.0",
     "hono-openapi": "^1.3.0",
+    "nodemailer": ">=7.0.0",
     "valibot": "^1.4.0"
   },
   "peerDependenciesMeta": {
@@ -197,6 +229,9 @@
     },
     "dotenv": {
       "optional": true
+    },
+    "nodemailer": {
+      "optional": true
     }
   },
   "devDependencies": {
@@ -213,26 +248,28 @@
     "@casl/ability": "^7.0.1",
     "@casl/prisma": "^2.0.2",
     "@hono/swagger-ui": "^0.6.1",
-    "@prisma/adapter-pg": "7.10.0",
-    "@prisma/client": "^7.10.0",
+    "@prisma/adapter-pg": "7.10.1",
+    "@prisma/client": "^7.10.1",
     "@types/aws-lambda": "^8.10.163",
     "@types/node": "^26.5.0",
-    "@vitest/coverage-v8": "^4.1.11",
+    "@types/swagger-ui-dist": "^3.30.6",
+    "@vitest/coverage-v8": "^4.1.12",
     "awilix": "^13.0.5",
-    "better-auth": "^1.7.5",
+    "better-auth": "^1.7.15",
     "dotenv": "^17.4.2",
-    "hono": "^4.13.7",
+    "hono": "^4.13.16",
     "hono-openapi": "^1.3.2",
     "mermaid": "^11.17.2",
-    "mjml": "^5.4.0",
+    "mjml": "^5.4.1",
+    "nodemailer": "^10.1.7",
     "postal-mime": "^2.7.6",
-    "prisma": "7.10.0",
+    "prisma": "7.10.1",
     "typescript": "^7.0.2",
     "valibot": "^1.4.2",
     "vitepress": "^1.6.4",
     "vitepress-plugin-llms": "^1.13.5",
     "vitepress-plugin-mermaid": "^2.0.17",
-    "vitest": "^4.1.11",
+    "vitest": "^4.1.12",
     "vue": "^3.5.42",
     "yaml": "^2.9.1"
   },
@@ -240,8 +277,15 @@
     "@hono/standard-validator": "^0.2.3",
     "@hono/valibot-validator": "^0.6.1",
     "@valibot/to-json-schema": "^1.7.1",
-    "deepmerge": "^4.3.1",
     "nanoid": "^5.1.16",
     "openapi-types": "^12.1.3"
+  },
+  "overrides": {
+    "vitepress": {
+      "vite": "^6.4.5"
+    },
+    "mermaid": {
+      "katex": "^0.18.2"
+    }
   }
 }