@dereekb/nestjs 13.6.9 → 13.6.10

package/discord/index.cjs.js

@@ -113,6 +113,9 @@ function _define_property$5(obj, key, value) {
 /**
  * Default environment variable for the Discord application public key.
  */ var DISCORD_PUBLIC_KEY_ENV_VAR = 'DISCORD_PUBLIC_KEY';
+/**
+ * The byte length of a Discord Ed25519 public key (32 bytes = 64 hex characters).
+ */ var DISCORD_ED25519_PUBLIC_KEY_BYTE_LENGTH = 32;
 /**
  * Configuration for the DiscordWebhookService.
  */ var DiscordWebhookServiceConfig = /*#__PURE__*/ function() {
@@ -124,9 +127,15 @@ function _define_property$5(obj, key, value) {
         {
             key: "assertValidConfig",
             value: function assertValidConfig(config) {
-                if (!config.discordWebhook.publicKey) {
+                var publicKey = config.discordWebhook.publicKey;
+                if (!publicKey) {
                     throw new Error('No Discord public key specified.');
                 }
+                if (!util.isHexWithByteLength(publicKey, {
+                    byteLength: DISCORD_ED25519_PUBLIC_KEY_BYTE_LENGTH
+                })) {
+                    throw new Error('Discord public key is not available or is invalid. Expected a 64-character hex string (32-byte Ed25519 key).');
+                }
             }
         }
     ]);
@@ -1463,6 +1472,7 @@ function _unsupported_iterable_to_array(o, minLen) {
 exports.DISCORD_BOT_TOKEN_ENV_VAR = DISCORD_BOT_TOKEN_ENV_VAR;
 exports.DISCORD_DEFAULT_INTENTS = DISCORD_DEFAULT_INTENTS;
 exports.DISCORD_DEFAULT_MESSAGES_PER_PAGE = DISCORD_DEFAULT_MESSAGES_PER_PAGE;
+exports.DISCORD_ED25519_PUBLIC_KEY_BYTE_LENGTH = DISCORD_ED25519_PUBLIC_KEY_BYTE_LENGTH;
 exports.DISCORD_PUBLIC_KEY_ENV_VAR = DISCORD_PUBLIC_KEY_ENV_VAR;
 exports.DiscordServiceConfig = DiscordServiceConfig;
 exports.DiscordWebhookServiceConfig = DiscordWebhookServiceConfig;

package/discord/index.esm.js

@@ -1,4 +1,4 @@
-import { handlerFactory, handlerConfigurerFactory, handlerMappedSetFunctionFactory, lastValue } from '@dereekb/util';
+import { handlerFactory, handlerConfigurerFactory, handlerMappedSetFunctionFactory, isHexWithByteLength, lastValue } from '@dereekb/util';
 import { InteractionType, GatewayIntentBits, Client, Events, TextChannel } from 'discord.js';
 import { RawBody } from '@dereekb/nestjs';
 import { Injectable, Inject, Logger, Post, Req, Controller, Module } from '@nestjs/common';
@@ -111,6 +111,9 @@ function _define_property$5(obj, key, value) {
 /**
  * Default environment variable for the Discord application public key.
  */ var DISCORD_PUBLIC_KEY_ENV_VAR = 'DISCORD_PUBLIC_KEY';
+/**
+ * The byte length of a Discord Ed25519 public key (32 bytes = 64 hex characters).
+ */ var DISCORD_ED25519_PUBLIC_KEY_BYTE_LENGTH = 32;
 /**
  * Configuration for the DiscordWebhookService.
  */ var DiscordWebhookServiceConfig = /*#__PURE__*/ function() {
@@ -122,9 +125,15 @@ function _define_property$5(obj, key, value) {
         {
             key: "assertValidConfig",
             value: function assertValidConfig(config) {
-                if (!config.discordWebhook.publicKey) {
+                var publicKey = config.discordWebhook.publicKey;
+                if (!publicKey) {
                     throw new Error('No Discord public key specified.');
                 }
+                if (!isHexWithByteLength(publicKey, {
+                    byteLength: DISCORD_ED25519_PUBLIC_KEY_BYTE_LENGTH
+                })) {
+                    throw new Error('Discord public key is not available or is invalid. Expected a 64-character hex string (32-byte Ed25519 key).');
+                }
             }
         }
     ]);
@@ -1458,4 +1467,4 @@ function _unsupported_iterable_to_array(o, minLen) {
     };
 }
 
-export { DISCORD_BOT_TOKEN_ENV_VAR, DISCORD_DEFAULT_INTENTS, DISCORD_DEFAULT_MESSAGES_PER_PAGE, DISCORD_PUBLIC_KEY_ENV_VAR, DiscordApi, DiscordModule, DiscordServiceConfig, DiscordWebhookController, DiscordWebhookModule, DiscordWebhookService, DiscordWebhookServiceConfig, discordClientOptionsWithIntents, discordDefaultClientOptions, discordFetchMessagePageFactory, discordInteractionHandlerConfigurerFactory, discordInteractionHandlerFactory, discordServiceConfigFactory, discordWebhookEventVerifier, discordWebhookInteraction, discordWebhookServiceConfigFactory };
+export { DISCORD_BOT_TOKEN_ENV_VAR, DISCORD_DEFAULT_INTENTS, DISCORD_DEFAULT_MESSAGES_PER_PAGE, DISCORD_ED25519_PUBLIC_KEY_BYTE_LENGTH, DISCORD_PUBLIC_KEY_ENV_VAR, DiscordApi, DiscordModule, DiscordServiceConfig, DiscordWebhookController, DiscordWebhookModule, DiscordWebhookService, DiscordWebhookServiceConfig, discordClientOptionsWithIntents, discordDefaultClientOptions, discordFetchMessagePageFactory, discordInteractionHandlerConfigurerFactory, discordInteractionHandlerFactory, discordServiceConfigFactory, discordWebhookEventVerifier, discordWebhookInteraction, discordWebhookServiceConfigFactory };

package/discord/package.json

@@ -1,9 +1,10 @@
 {
   "name": "@dereekb/nestjs/discord",
-  "version": "13.6.9",
+  "version": "13.6.10",
   "peerDependencies": {
-    "@dereekb/nestjs": "13.6.9",
-    "@dereekb/util": "13.6.9",
+    "@dereekb/nestjs": "13.6.10",
+    "@dereekb/rxjs": "13.6.10",
+    "@dereekb/util": "13.6.10",
     "@nestjs/common": "^11.1.17",
     "@nestjs/config": "^4.0.3",
     "discord.js": "^14.25.1",

package/discord/src/lib/webhook/webhook.discord.config.d.ts

@@ -3,6 +3,10 @@ import { type DiscordPublicKey } from '../discord.type';
  * Default environment variable for the Discord application public key.
  */
 export declare const DISCORD_PUBLIC_KEY_ENV_VAR = "DISCORD_PUBLIC_KEY";
+/**
+ * The byte length of a Discord Ed25519 public key (32 bytes = 64 hex characters).
+ */
+export declare const DISCORD_ED25519_PUBLIC_KEY_BYTE_LENGTH = 32;
 export interface DiscordWebhookConfig {
     /**
      * The Ed25519 public key used to verify incoming interaction webhook signatures.

package/index.cjs.js

@@ -1,5 +1,8 @@
 'use strict';
 
+var rxjs = require('@dereekb/rxjs');
+var promises = require('fs/promises');
+var path = require('path');
 var common = require('@nestjs/common');
 var rawbody = require('raw-body');
 var querystring = require('querystring');
@@ -8,6 +11,214 @@ var util = require('@dereekb/util');
 var config = require('@nestjs/config');
 var crypto = require('crypto');
 
+function asyncGeneratorStep$1(gen, resolve, reject, _next, _throw, key, arg) {
+    try {
+        var info = gen[key](arg);
+        var value = info.value;
+    } catch (error) {
+        reject(error);
+        return;
+    }
+    if (info.done) {
+        resolve(value);
+    } else {
+        Promise.resolve(value).then(_next, _throw);
+    }
+}
+function _async_to_generator$1(fn) {
+    return function() {
+        var self = this, args = arguments;
+        return new Promise(function(resolve, reject) {
+            var gen = fn.apply(self, args);
+            function _next(value) {
+                asyncGeneratorStep$1(gen, resolve, reject, _next, _throw, "next", value);
+            }
+            function _throw(err) {
+                asyncGeneratorStep$1(gen, resolve, reject, _next, _throw, "throw", err);
+            }
+            _next(undefined);
+        });
+    };
+}
+function _ts_generator$1(thisArg, body) {
+    var f, y, t, _ = {
+        label: 0,
+        sent: function() {
+            if (t[0] & 1) throw t[1];
+            return t[1];
+        },
+        trys: [],
+        ops: []
+    }, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype), d = Object.defineProperty;
+    return d(g, "next", {
+        value: verb(0)
+    }), d(g, "throw", {
+        value: verb(1)
+    }), d(g, "return", {
+        value: verb(2)
+    }), typeof Symbol === "function" && d(g, Symbol.iterator, {
+        value: function() {
+            return this;
+        }
+    }), g;
+    function verb(n) {
+        return function(v) {
+            return step([
+                n,
+                v
+            ]);
+        };
+    }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while(g && (g = 0, op[0] && (_ = 0)), _)try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [
+                op[0] & 2,
+                t.value
+            ];
+            switch(op[0]){
+                case 0:
+                case 1:
+                    t = op;
+                    break;
+                case 4:
+                    _.label++;
+                    return {
+                        value: op[1],
+                        done: false
+                    };
+                case 5:
+                    _.label++;
+                    y = op[1];
+                    op = [
+                        0
+                    ];
+                    continue;
+                case 7:
+                    op = _.ops.pop();
+                    _.trys.pop();
+                    continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) {
+                        _ = 0;
+                        continue;
+                    }
+                    if (op[0] === 3 && (!t || op[1] > t[0] && op[1] < t[3])) {
+                        _.label = op[1];
+                        break;
+                    }
+                    if (op[0] === 6 && _.label < t[1]) {
+                        _.label = t[1];
+                        t = op;
+                        break;
+                    }
+                    if (t && _.label < t[2]) {
+                        _.label = t[2];
+                        _.ops.push(op);
+                        break;
+                    }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop();
+                    continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) {
+            op = [
+                6,
+                e
+            ];
+            y = 0;
+        } finally{
+            f = t = 0;
+        }
+        if (op[0] & 5) throw op[1];
+        return {
+            value: op[0] ? op[1] : void 0,
+            done: true
+        };
+    }
+}
+/**
+ * Creates an {@link AssetLoader} that reads local assets from the
+ * filesystem using Node.js `fs/promises`.
+ *
+ * The ref's {@link AssetLocalPathRef.path} is resolved relative
+ * to the configured {@link NodeJsLocalAssetLoaderConfig.basePath}.
+ *
+ * @example
+ * ```ts
+ * const loader = nodeJsLocalAssetLoader({ basePath: './assets' });
+ * loader.get(localAsset('data/districts.json')).load().subscribe((buffer) => {
+ *   // reads from ./assets/data/districts.json
+ * });
+ * ```
+ *
+ * @param config - Filesystem configuration with base path.
+ */ function nodeJsLocalAssetLoader(config) {
+    var basePath = config.basePath;
+    var getFn = function getFn(ref) {
+        return _async_to_generator$1(function() {
+            var localRef, fullPath, buffer;
+            return _ts_generator$1(this, function(_state) {
+                switch(_state.label){
+                    case 0:
+                        localRef = ref;
+                        fullPath = path.resolve(basePath, localRef.path);
+                        return [
+                            4,
+                            promises.readFile(fullPath)
+                        ];
+                    case 1:
+                        buffer = _state.sent();
+                        return [
+                            2,
+                            buffer.buffer.slice(buffer.byteOffset, buffer.byteOffset + buffer.byteLength)
+                        ];
+                }
+            });
+        })();
+    };
+    return rxjs.assetLoaderFromGetFn(getFn);
+}
+
+/**
+ * Creates NestJS module metadata that provides an {@link AssetLoader}
+ * using {@link delegatedAssetLoader} with Node.js-specific leaf loaders.
+ *
+ * Local assets are loaded from the filesystem. Remote assets (which always
+ * have absolute URLs) are loaded via `fetch`.
+ *
+ * @example
+ * ```ts
+ * @Module(appAssetLoaderModuleMetadata({
+ *   local: { basePath: './assets' }
+ * }))
+ * export class AppAssetLoaderModule {}
+ * ```
+ *
+ * @param config - Local filesystem config and optional remote fetch config.
+ */ function appAssetLoaderModuleMetadata(config) {
+    var local = nodeJsLocalAssetLoader(config.local);
+    var remote = rxjs.fetchAssetLoader(config.remote);
+    var loader = rxjs.delegatedAssetLoader({
+        local: local,
+        remote: remote
+    });
+    var providers = [
+        {
+            provide: rxjs.AssetLoader,
+            useValue: loader
+        }
+    ];
+    return {
+        providers: providers,
+        exports: [
+            rxjs.AssetLoader
+        ]
+    };
+}
+
 /**
  * Returns true if the request is from localhost.
  */ var IsRequestFromLocalHost = common.createParamDecorator(function(data, context) {
@@ -1108,6 +1319,7 @@ exports.RawBodyToParsedQueryString = RawBodyToParsedQueryString;
 exports.RawBodyToString = RawBodyToString;
 exports.SERVER_ENV_TOKEN = SERVER_ENV_TOKEN;
 exports.ServerEnvironmentConfig = ServerEnvironmentConfig;
+exports.appAssetLoaderModuleMetadata = appAssetLoaderModuleMetadata;
 exports.clientAppConfigFactory = clientAppConfigFactory;
 exports.consumeWebhooksWithRawBodyMiddleware = consumeWebhooksWithRawBodyMiddleware;
 exports.createAES256GCMEncryption = createAES256GCMEncryption;
@@ -1119,5 +1331,6 @@ exports.isLocalhost = isLocalhost;
 exports.isTestNodeEnv = isTestNodeEnv;
 exports.isValidAES256GCMEncryptionSecret = isValidAES256GCMEncryptionSecret;
 exports.mergeModuleMetadata = mergeModuleMetadata;
+exports.nodeJsLocalAssetLoader = nodeJsLocalAssetLoader;
 exports.resolveEncryptionKey = resolveEncryptionKey;
 exports.serverEnvTokenProvider = serverEnvTokenProvider;

package/index.esm.js

@@ -1,3 +1,6 @@
+import { assetLoaderFromGetFn, fetchAssetLoader, delegatedAssetLoader, AssetLoader } from '@dereekb/rxjs';
+import { readFile } from 'fs/promises';
+import { resolve } from 'path';
 import { createParamDecorator, Logger, BadRequestException, InternalServerErrorException, Injectable, RequestMethod, Module, Inject } from '@nestjs/common';
 import rawbody from 'raw-body';
 import { parse } from 'querystring';
@@ -6,6 +9,214 @@ import { asArray, mergeArrays, isHex, getValueFromGetter } from '@dereekb/util';
 import { ConfigService, ConfigModule } from '@nestjs/config';
 import { createDecipheriv, randomBytes, createCipheriv } from 'crypto';
 
+function asyncGeneratorStep$1(gen, resolve, reject, _next, _throw, key, arg) {
+    try {
+        var info = gen[key](arg);
+        var value = info.value;
+    } catch (error) {
+        reject(error);
+        return;
+    }
+    if (info.done) {
+        resolve(value);
+    } else {
+        Promise.resolve(value).then(_next, _throw);
+    }
+}
+function _async_to_generator$1(fn) {
+    return function() {
+        var self = this, args = arguments;
+        return new Promise(function(resolve, reject) {
+            var gen = fn.apply(self, args);
+            function _next(value) {
+                asyncGeneratorStep$1(gen, resolve, reject, _next, _throw, "next", value);
+            }
+            function _throw(err) {
+                asyncGeneratorStep$1(gen, resolve, reject, _next, _throw, "throw", err);
+            }
+            _next(undefined);
+        });
+    };
+}
+function _ts_generator$1(thisArg, body) {
+    var f, y, t, _ = {
+        label: 0,
+        sent: function() {
+            if (t[0] & 1) throw t[1];
+            return t[1];
+        },
+        trys: [],
+        ops: []
+    }, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype), d = Object.defineProperty;
+    return d(g, "next", {
+        value: verb(0)
+    }), d(g, "throw", {
+        value: verb(1)
+    }), d(g, "return", {
+        value: verb(2)
+    }), typeof Symbol === "function" && d(g, Symbol.iterator, {
+        value: function() {
+            return this;
+        }
+    }), g;
+    function verb(n) {
+        return function(v) {
+            return step([
+                n,
+                v
+            ]);
+        };
+    }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while(g && (g = 0, op[0] && (_ = 0)), _)try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [
+                op[0] & 2,
+                t.value
+            ];
+            switch(op[0]){
+                case 0:
+                case 1:
+                    t = op;
+                    break;
+                case 4:
+                    _.label++;
+                    return {
+                        value: op[1],
+                        done: false
+                    };
+                case 5:
+                    _.label++;
+                    y = op[1];
+                    op = [
+                        0
+                    ];
+                    continue;
+                case 7:
+                    op = _.ops.pop();
+                    _.trys.pop();
+                    continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) {
+                        _ = 0;
+                        continue;
+                    }
+                    if (op[0] === 3 && (!t || op[1] > t[0] && op[1] < t[3])) {
+                        _.label = op[1];
+                        break;
+                    }
+                    if (op[0] === 6 && _.label < t[1]) {
+                        _.label = t[1];
+                        t = op;
+                        break;
+                    }
+                    if (t && _.label < t[2]) {
+                        _.label = t[2];
+                        _.ops.push(op);
+                        break;
+                    }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop();
+                    continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) {
+            op = [
+                6,
+                e
+            ];
+            y = 0;
+        } finally{
+            f = t = 0;
+        }
+        if (op[0] & 5) throw op[1];
+        return {
+            value: op[0] ? op[1] : void 0,
+            done: true
+        };
+    }
+}
+/**
+ * Creates an {@link AssetLoader} that reads local assets from the
+ * filesystem using Node.js `fs/promises`.
+ *
+ * The ref's {@link AssetLocalPathRef.path} is resolved relative
+ * to the configured {@link NodeJsLocalAssetLoaderConfig.basePath}.
+ *
+ * @example
+ * ```ts
+ * const loader = nodeJsLocalAssetLoader({ basePath: './assets' });
+ * loader.get(localAsset('data/districts.json')).load().subscribe((buffer) => {
+ *   // reads from ./assets/data/districts.json
+ * });
+ * ```
+ *
+ * @param config - Filesystem configuration with base path.
+ */ function nodeJsLocalAssetLoader(config) {
+    var basePath = config.basePath;
+    var getFn = function getFn(ref) {
+        return _async_to_generator$1(function() {
+            var localRef, fullPath, buffer;
+            return _ts_generator$1(this, function(_state) {
+                switch(_state.label){
+                    case 0:
+                        localRef = ref;
+                        fullPath = resolve(basePath, localRef.path);
+                        return [
+                            4,
+                            readFile(fullPath)
+                        ];
+                    case 1:
+                        buffer = _state.sent();
+                        return [
+                            2,
+                            buffer.buffer.slice(buffer.byteOffset, buffer.byteOffset + buffer.byteLength)
+                        ];
+                }
+            });
+        })();
+    };
+    return assetLoaderFromGetFn(getFn);
+}
+
+/**
+ * Creates NestJS module metadata that provides an {@link AssetLoader}
+ * using {@link delegatedAssetLoader} with Node.js-specific leaf loaders.
+ *
+ * Local assets are loaded from the filesystem. Remote assets (which always
+ * have absolute URLs) are loaded via `fetch`.
+ *
+ * @example
+ * ```ts
+ * @Module(appAssetLoaderModuleMetadata({
+ *   local: { basePath: './assets' }
+ * }))
+ * export class AppAssetLoaderModule {}
+ * ```
+ *
+ * @param config - Local filesystem config and optional remote fetch config.
+ */ function appAssetLoaderModuleMetadata(config) {
+    var local = nodeJsLocalAssetLoader(config.local);
+    var remote = fetchAssetLoader(config.remote);
+    var loader = delegatedAssetLoader({
+        local: local,
+        remote: remote
+    });
+    var providers = [
+        {
+            provide: AssetLoader,
+            useValue: loader
+        }
+    ];
+    return {
+        providers: providers,
+        exports: [
+            AssetLoader
+        ]
+    };
+}
+
 /**
  * Returns true if the request is from localhost.
  */ var IsRequestFromLocalHost = createParamDecorator(function(data, context) {
@@ -1092,4 +1303,4 @@ var ENCRYPTED_FIELD_KEY_LENGTH = 32;
     return result;
 }
 
-export { AppModuleWithWebhooksEnabled, CLIENT_WEB_APP_URL_ENV_VAR, ClientAppModule, ClientAppService, ClientAppServiceConfig, ConfigureWebhookMiddlewareModule, DEFAULT_BASE_WEBHOOK_PATH, DEFAULT_WEBHOOK_MIDDLEWARE_ROUTE_INFO, IsRequestFromLocalHost, JsonBodyMiddleware, ParseRawBody, ParsedQueryRawBody, RawBody, RawBodyMiddleware, RawBodyToJson, RawBodyToParsedQueryString, RawBodyToString, SERVER_ENV_TOKEN, ServerEnvironmentConfig, ServerEnvironmentService, clientAppConfigFactory, consumeWebhooksWithRawBodyMiddleware, createAES256GCMEncryption, createAesStringEncryptionProvider, decryptValue, encryptValue, injectionTokensFromProviders, isLocalhost, isTestNodeEnv, isValidAES256GCMEncryptionSecret, mergeModuleMetadata, resolveEncryptionKey, serverEnvTokenProvider };
+export { AppModuleWithWebhooksEnabled, CLIENT_WEB_APP_URL_ENV_VAR, ClientAppModule, ClientAppService, ClientAppServiceConfig, ConfigureWebhookMiddlewareModule, DEFAULT_BASE_WEBHOOK_PATH, DEFAULT_WEBHOOK_MIDDLEWARE_ROUTE_INFO, IsRequestFromLocalHost, JsonBodyMiddleware, ParseRawBody, ParsedQueryRawBody, RawBody, RawBodyMiddleware, RawBodyToJson, RawBodyToParsedQueryString, RawBodyToString, SERVER_ENV_TOKEN, ServerEnvironmentConfig, ServerEnvironmentService, appAssetLoaderModuleMetadata, clientAppConfigFactory, consumeWebhooksWithRawBodyMiddleware, createAES256GCMEncryption, createAesStringEncryptionProvider, decryptValue, encryptValue, injectionTokensFromProviders, isLocalhost, isTestNodeEnv, isValidAES256GCMEncryptionSecret, mergeModuleMetadata, nodeJsLocalAssetLoader, resolveEncryptionKey, serverEnvTokenProvider };

package/mailgun/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@dereekb/nestjs/mailgun",
-  "version": "13.6.9",
+  "version": "13.6.10",
   "peerDependencies": {
-    "@dereekb/date": "13.6.9",
-    "@dereekb/model": "13.6.9",
-    "@dereekb/nestjs": "13.6.9",
-    "@dereekb/rxjs": "13.6.9",
-    "@dereekb/util": "13.6.9",
+    "@dereekb/date": "13.6.10",
+    "@dereekb/model": "13.6.10",
+    "@dereekb/nestjs": "13.6.10",
+    "@dereekb/rxjs": "13.6.10",
+    "@dereekb/util": "13.6.10",
     "@nestjs/common": "^11.1.17",
     "@nestjs/config": "^4.0.3",
     "form-data": "^4.0.0",

package/openai/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@dereekb/nestjs/openai",
-  "version": "13.6.9",
+  "version": "13.6.10",
   "peerDependencies": {
-    "@dereekb/date": "13.6.9",
-    "@dereekb/model": "13.6.9",
-    "@dereekb/nestjs": "13.6.9",
-    "@dereekb/rxjs": "13.6.9",
-    "@dereekb/util": "13.6.9",
+    "@dereekb/date": "13.6.10",
+    "@dereekb/model": "13.6.10",
+    "@dereekb/nestjs": "13.6.10",
+    "@dereekb/rxjs": "13.6.10",
+    "@dereekb/util": "13.6.10",
     "@nestjs/common": "^11.1.17",
     "@nestjs/config": "^4.0.3",
     "express": "^5.0.0",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dereekb/nestjs",
-  "version": "13.6.9",
+  "version": "13.6.10",
   "types": "./src/index.d.ts",
   "module": "./index.esm.js",
   "main": "./index.cjs.js",
@@ -50,7 +50,8 @@
     }
   },
   "peerDependencies": {
-    "@dereekb/util": "13.6.9",
+    "@dereekb/rxjs": "13.6.10",
+    "@dereekb/util": "13.6.10",
     "discord.js": "^14.25.1",
     "@nestjs/common": "^11.1.17",
     "@nestjs/config": "^4.0.3",

package/src/lib/asset/asset.loader.node.d.ts

@@ -0,0 +1,31 @@
+import { type SlashPath } from '@dereekb/util';
+import { AssetLoader } from '@dereekb/rxjs';
+/**
+ * Configuration for {@link nodeJsLocalAssetLoader}.
+ */
+export interface NodeJsLocalAssetLoaderConfig {
+    /**
+     * Base filesystem directory for local assets.
+     *
+     * @example `'./assets'` or `'/app/dist/assets'`
+     */
+    readonly basePath: SlashPath;
+}
+/**
+ * Creates an {@link AssetLoader} that reads local assets from the
+ * filesystem using Node.js `fs/promises`.
+ *
+ * The ref's {@link AssetLocalPathRef.path} is resolved relative
+ * to the configured {@link NodeJsLocalAssetLoaderConfig.basePath}.
+ *
+ * @example
+ * ```ts
+ * const loader = nodeJsLocalAssetLoader({ basePath: './assets' });
+ * loader.get(localAsset('data/districts.json')).load().subscribe((buffer) => {
+ *   // reads from ./assets/data/districts.json
+ * });
+ * ```
+ *
+ * @param config - Filesystem configuration with base path.
+ */
+export declare function nodeJsLocalAssetLoader(config: NodeJsLocalAssetLoaderConfig): AssetLoader;

package/src/lib/asset/asset.nest.d.ts

@@ -0,0 +1,37 @@
+import { type ModuleMetadata } from '@nestjs/common';
+import { type FetchAssetLoaderConfig } from '@dereekb/rxjs';
+import { type NodeJsLocalAssetLoaderConfig } from './asset.loader.node';
+/**
+ * Configuration for {@link appAssetLoaderModuleMetadata}.
+ */
+export interface AppAssetLoaderModuleMetadataConfig {
+    /**
+     * Filesystem config for local assets.
+     */
+    readonly local: NodeJsLocalAssetLoaderConfig;
+    /**
+     * Optional fetch config for remote assets (e.g., custom fetch function
+     * with pre-configured auth headers).
+     *
+     * If omitted, remote assets use the global `fetch`.
+     */
+    readonly remote?: FetchAssetLoaderConfig;
+}
+/**
+ * Creates NestJS module metadata that provides an {@link AssetLoader}
+ * using {@link delegatedAssetLoader} with Node.js-specific leaf loaders.
+ *
+ * Local assets are loaded from the filesystem. Remote assets (which always
+ * have absolute URLs) are loaded via `fetch`.
+ *
+ * @example
+ * ```ts
+ * @Module(appAssetLoaderModuleMetadata({
+ *   local: { basePath: './assets' }
+ * }))
+ * export class AppAssetLoaderModule {}
+ * ```
+ *
+ * @param config - Local filesystem config and optional remote fetch config.
+ */
+export declare function appAssetLoaderModuleMetadata(config: AppAssetLoaderModuleMetadataConfig): ModuleMetadata;

package/src/lib/asset/index.d.ts

@@ -0,0 +1,2 @@
+export * from './asset.loader.node';
+export * from './asset.nest';

package/src/lib/index.d.ts

@@ -1,3 +1,4 @@
+export * from './asset';
 export * from './decorators';
 export * from './middlewares';
 export * from './module';

package/stripe/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@dereekb/nestjs/stripe",
-  "version": "13.6.9",
+  "version": "13.6.10",
   "peerDependencies": {
-    "@dereekb/date": "13.6.9",
-    "@dereekb/model": "13.6.9",
-    "@dereekb/nestjs": "13.6.9",
-    "@dereekb/rxjs": "13.6.9",
-    "@dereekb/util": "13.6.9",
+    "@dereekb/date": "13.6.10",
+    "@dereekb/model": "13.6.10",
+    "@dereekb/nestjs": "13.6.10",
+    "@dereekb/rxjs": "13.6.10",
+    "@dereekb/util": "13.6.10",
     "@nestjs/common": "^11.1.17",
     "@nestjs/config": "^4.0.3",
     "express": "^5.0.0",

package/typeform/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@dereekb/nestjs/typeform",
-  "version": "13.6.9",
+  "version": "13.6.10",
   "peerDependencies": {
-    "@dereekb/date": "13.6.9",
-    "@dereekb/model": "13.6.9",
-    "@dereekb/nestjs": "13.6.9",
-    "@dereekb/rxjs": "13.6.9",
-    "@dereekb/util": "13.6.9",
+    "@dereekb/date": "13.6.10",
+    "@dereekb/model": "13.6.10",
+    "@dereekb/nestjs": "13.6.10",
+    "@dereekb/rxjs": "13.6.10",
+    "@dereekb/util": "13.6.10",
     "@nestjs/common": "^11.1.17",
     "@nestjs/config": "^4.0.3",
     "@typeform/api-client": "^2.5.1",

package/vapiai/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@dereekb/nestjs/vapiai",
-  "version": "13.6.9",
+  "version": "13.6.10",
   "peerDependencies": {
-    "@dereekb/date": "13.6.9",
-    "@dereekb/model": "13.6.9",
-    "@dereekb/nestjs": "13.6.9",
-    "@dereekb/rxjs": "13.6.9",
-    "@dereekb/util": "13.6.9",
+    "@dereekb/date": "13.6.10",
+    "@dereekb/model": "13.6.10",
+    "@dereekb/nestjs": "13.6.10",
+    "@dereekb/rxjs": "13.6.10",
+    "@dereekb/util": "13.6.10",
     "@nestjs/common": "^11.1.17",
     "@nestjs/config": "^4.0.3",
     "@vapi-ai/server-sdk": "^0.11.0",