commandkit 1.2.0-rc.2 → 1.2.0-rc.4

package/dist/index.js

@@ -2,8 +2,8 @@ Object.defineProperty(exports, '__esModule', { value: true });
 const require_chunk = require('./chunk-nOFOJqeH.js');
 require('./colors-Cd4Oz-r-.js');
 const require_ActionRow = require('./ActionRow-CmTHbo2t.js');
-require('./error-codes-C-ViHyu-.js');
-const require_commandkit = require('./commandkit-DMEW0kJg.js');
+const require_error_codes = require('./error-codes-Ds0bnPvT.js');
+const require_commandkit = require('./commandkit-c0sAaK0G.js');
 require('./common-CcfjYnPG.js');
 require('./common-vnMIelAE.js');
 const require_container = require('./container-z621KfH5.js');
@@ -25,11 +25,11 @@ require('./runtime-5fxB4uhe.js');
 require('./utils-BnXM4eKk.js');
 const require_resolve_file_url = require('./resolve-file-url-DHTQj2mU.js');
 require('./types-package-DrnIdWLg.js');
-const require_EventWorkerContext = require('./EventWorkerContext-CSlD9rbx.js');
-const require_signals = require('./signals-DHdYrd-n.js');
-require('./constants-CUND8XkG.js');
-const require_MessageCommandParser = require('./MessageCommandParser-B_BEQ3p8.js');
-const require_CommandsRouter = require('./CommandsRouter-Ci1Pe8Vd.js');
+require('./constants-DxfYtA6t.js');
+const require_EventWorkerContext = require('./EventWorkerContext-TZIKxVCu.js');
+const require_signals = require('./signals-r7qPAvOR.js');
+const require_MessageCommandParser = require('./MessageCommandParser-TPEPhjvx.js');
+const require_CommandsRouter = require('./CommandsRouter-tMAivEfv.js');
 const require_EventsRouter = require('./EventsRouter-C_J0M3uO.js');
 require('./router-DHnFRADH.js');
 require('./common-DNADUU3_.js');
@@ -38,11 +38,15 @@ require('./store-CiqLHedg.js');
 const require_helpers = require('./helpers-BUlN3lIz.js');
 require('./app-HN1cVg8J.js');
 require('./ILogger-dQ7Y9X1f.js');
-const require_version = require('./version-Df1T7P2K.js');
-const require_feature_flags = require('./feature-flags-Cxl9JtVG.js');
-const require_init = require('./init-DTBFphOg.js');
+const require_version = require('./version-BoHnO-Go.js');
+const require_feature_flags = require('./feature-flags-Dxi9TI2e.js');
+const require_init = require('./init-CrFvqdxZ.js');
 const discord_js = require_chunk.__toESM(require("discord.js"));
 
+//#region src/index.ts
+var src_default = require_commandkit.CommandKit;
+
+//#endregion
 exports.ActionRow = require_ActionRow.ActionRow;
 exports.AppCommandHandler = require_commandkit.AppCommandHandler;
 exports.Button = require_commandkit.Button;
@@ -64,6 +68,7 @@ exports.CommandExecutionMode = require_commandkit.CommandExecutionMode;
 exports.CommandKit = require_commandkit.CommandKit;
 exports.CommandKitEnvironment = require_commandkit.CommandKitEnvironment;
 exports.CommandKitEnvironmentType = require_commandkit.CommandKitEnvironmentType;
+exports.CommandKitErrorCodes = require_error_codes.CommandKitErrorCodes;
 exports.CommandKitPluginRuntime = require_commandkit.CommandKitPluginRuntime;
 exports.CommandRegistrar = require_commandkit.CommandRegistrar;
 exports.CommandsRouter = require_CommandsRouter.CommandsRouter;
@@ -105,22 +110,19 @@ exports.TextInput = require_commandkit.TextInput;
 exports.Thumbnail = require_section.Thumbnail;
 exports.UserSelectMenu = require_commandkit.UserSelectMenu;
 exports.UserSelectMenuKit = require_commandkit.UserSelectMenuKit;
-exports.after = require_commandkit.after;
 exports.bootstrapCommandkitCLI = require_init.bootstrapCommandkitCLI;
-exports.cancelAfter = require_commandkit.cancelAfter;
 exports.commandkit = require_commandkit.commandkit;
 exports.createElement = require_element.createElement;
 exports.jsx = require_element.createElement;
 exports.jsxs = require_element.createElement;
 exports.createLogger = require_commandkit.createLogger;
 exports.debounce = require_commandkit.debounce;
-exports.default = require_commandkit.CommandKit;
+exports.default = src_default;
 exports.defer = require_commandkit.defer;
 exports.defineConfig = require_commandkit.defineConfig;
 exports.devOnly = require_commandkit.devOnly;
 exports.eventWorkerContext = require_EventWorkerContext.eventWorkerContext;
 exports.exitContext = require_commandkit.exitContext;
-exports.exitMiddleware = require_signals.exitMiddleware;
 exports.flag = require_feature_flags.flag;
 exports.getCommandKit = require_commandkit.getCommandKit;
 exports.getConfig = require_commandkit.getConfig;
@@ -132,6 +134,7 @@ exports.getSourceDirectories = require_commandkit.getSourceDirectories;
 exports.isCommandKitElement = require_element.isCommandKitElement;
 exports.isCommandWorkerContext = require_commandkit.isCommandWorkerContext;
 exports.isCompilerPlugin = require_CompilerPlugin.isCompilerPlugin;
+exports.isErrorType = require_error_codes.isErrorType;
 exports.isEventWorkerContext = require_EventWorkerContext.isEventWorkerContext;
 exports.isInteractionSource = require_helpers.isInteractionSource;
 exports.isMessageSource = require_helpers.isMessageSource;
@@ -145,6 +148,10 @@ exports.rethrow = require_signals.rethrow;
 exports.runInEventWorkerContext = require_EventWorkerContext.runInEventWorkerContext;
 exports.setFlagProvider = require_feature_flags.setFlagProvider;
 exports.stopEvents = require_signals.stopEvents;
+exports.stopMiddlewares = require_signals.stopMiddlewares;
 exports.toFileURL = require_resolve_file_url.toFileURL;
+exports.unstable_after = require_commandkit.after;
+exports.unstable_cancelAfter = require_commandkit.cancelAfter;
 exports.useEnvironment = require_commandkit.useEnvironment;
-exports.version = require_version.version;
+exports.version = require_version.version;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import { CommandKit } from './commandkit';\n\nexport default CommandKit;\n\nexport * from './commandkit';\nexport * from './components';\nexport * from './config/config';\nexport * from './context/async-context';\nexport {\n  type CommandKitEnvironmentInternalData,\n  CommandKitEnvironment,\n  CommandKitEnvironmentType,\n  cancelAfter as unstable_cancelAfter,\n  after as unstable_after,\n} from './context/environment';\nexport * from './app/index';\nexport * from './logger/DefaultLogger';\nexport * from './logger/ILogger';\nexport * from './logger/Logger';\nexport * from './app/router/index';\nexport type * from './types';\nexport * from './version';\nexport * from './plugins/index';\nexport * from './flags/feature-flags';\nexport {\n  getCurrentDirectory,\n  getSourceDirectories,\n  devOnly,\n  debounce,\n  defer,\n} from './utils/utilities';\nexport { toFileURL } from './utils/resolve-file-url';\nexport * from './app/interrupt/signals';\nexport type { CommandKitHMREvent } from './utils/dev-hooks';\nexport * from './utils/constants';\nexport * from './app/events/EventWorkerContext';\nexport { CommandKitErrorCodes, isErrorType } from './utils/error-codes';\nexport { Collection, type Client } from 'discord.js';\n\n// cli\nexport { bootstrapCommandkitCLI } from './cli/init';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEA,kBAAe"}

package/dist/{init-DTBFphOg.js → init-CrFvqdxZ.js}

@@ -1,5 +1,5 @@
 const require_chunk = require('./chunk-nOFOJqeH.js');
-const require_commandkit = require('./commandkit-DMEW0kJg.js');
+const require_commandkit = require('./commandkit-c0sAaK0G.js');
 const require_constants = require('./constants-B5_Ta7PR.js');
 const require_CompilerPlugin = require('./CompilerPlugin-CjoZAAR8.js');
 const require_types_package = require('./types-package-DrnIdWLg.js');
@@ -89,4 +89,4 @@ Object.defineProperty(exports, 'bootstrapCommandkitCLI', {
     return bootstrapCommandkitCLI;
   }
 });
-//# sourceMappingURL=init-DTBFphOg.js.map
+//# sourceMappingURL=init-CrFvqdxZ.js.map

package/dist/{init-DTBFphOg.js.map → init-CrFvqdxZ.js.map}

@@ -1 +1 @@
-{"version":3,"file":"init-DTBFphOg.js","names":[],"sources":["../src/cli/init.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\nimport { mkdir } from 'node:fs/promises';\nimport { join } from 'node:path';\nimport { generateTypesPackage } from '../utils/types-package';\nimport { loadConfigFile } from '../config/loader';\nimport {\n  CompilerPlugin,\n  CompilerPluginRuntime,\n  isCompilerPlugin,\n} from '../plugins';\nimport { panic } from './common';\nimport { COMMANDKIT_CWD } from '../utils/constants';\n\n/**\n * Creates a command line interface for CommandKit.\n * @param argv The arguments passed to the CLI.\n * @param options The options passed to the CLI.\n */\nexport async function bootstrapCommandkitCLI(\n  argv: string[],\n  options?: import('commander').ParseOptions | undefined,\n) {\n  process.title = 'CommandKit CLI';\n\n  // imports are lazily loaded when the cli is used, instead of loading it with the lib itself\n  const { Command } = await import('commander');\n  const { bootstrapDevelopmentServer } = await import('./development');\n  const { bootstrapProductionServer, createProductionBuild } = await import(\n    './production'\n  );\n  const { generateCommand, generateEvent } = await import('./generators');\n  const { version } = await import('../version');\n  const { showInformation } = await import('./information');\n  const { setCLIEnv } = await import('./env');\n\n  const program = new Command('commandkit');\n\n  program\n    .command('dev')\n    .version(version)\n    .description('Start your bot in development mode.')\n    .option(\n      '-c, --config [path]',\n      'Path to your commandkit config file.',\n      './commandkit.js',\n    )\n    .action(() => {\n      const options = program.opts();\n      bootstrapDevelopmentServer(options.config);\n    });\n\n  program\n    .command('info')\n    .description(\n      'Show information about the system which can be used to report bugs.',\n    )\n    .action(async () => {\n      await showInformation();\n    });\n\n  program\n    .command('start')\n    .description(\n      'Start your bot in production mode after running the build command.',\n    )\n    .option('-c, --config [path]', 'Path to your commandkit config file.')\n    .action(() => {\n      const options = program.opts();\n      bootstrapProductionServer(options.config);\n    });\n\n  program\n    .command('build')\n    .description('Build your project for production usage.')\n    .option('-c, --config [path]', 'Path to your commandkit config file.')\n    .action(() => {\n      setCLIEnv();\n      const options = program.opts();\n      return createProductionBuild(options.config);\n    });\n\n  program\n    .command('create')\n    .description(\n      'Create new files using built-in templates or custom plugin templates',\n    )\n    .argument(\n      '<template>',\n      'The template to use (e.g. command, event, or custom plugin template)',\n    )\n    .argument('[args...]', 'Additional arguments for the template')\n    .action(async (template, args) => {\n      setCLIEnv();\n\n      // Handle custom plugin templates\n      const { plugins } = await loadConfigFile();\n      const runtime = new CompilerPluginRuntime(\n        plugins.filter((p) => isCompilerPlugin(p)) as CompilerPlugin[],\n      );\n\n      try {\n        await runtime.init();\n        const templateHandler = runtime.getTemplate(template);\n\n        if (!templateHandler) {\n          // Handle built-in templates\n          if (template === 'command') {\n            const [name] = args;\n            if (!name) {\n              panic('Command name is required');\n            }\n            await generateCommand(name);\n            return;\n          }\n\n          if (template === 'event') {\n            const [name] = args;\n            if (!name) {\n              panic('Event name is required');\n            }\n            await generateEvent(name);\n            return;\n          }\n\n          const valid = Array.from(\n            new Set([\n              'command',\n              'event',\n              ...Array.from(runtime.getTemplates().keys()),\n            ]),\n          ).map((t) => `\"${t}\"`);\n\n          panic(\n            `Template \"${template}\" not found. Available templates: ${valid.join(', ')}`,\n          );\n        }\n\n        await templateHandler(args);\n      } catch (e: any) {\n        panic(`Failed to execute template \"${template}\": ${e?.message || e}`);\n      } finally {\n        await runtime.destroy();\n      }\n    });\n\n  const types = join(COMMANDKIT_CWD, 'node_modules', 'commandkit-types');\n\n  if (!existsSync(types)) {\n    await mkdir(types, { recursive: true }).catch(() => {});\n    await generateTypesPackage(true).catch(() => {});\n  }\n\n  await program.parseAsync(argv, options);\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAkBA,eAAsB,uBACtB,MACA,SACA;AACE,SAAQ,QAAQ;CAGhB,MAAM,EAAE,SAAS,GAAG,MAAM,OAAO;CACjC,MAAM,EAAE,4BAA4B,GAAG,2CAAM;CAC7C,MAAM,EAAE,2BAA2B,uBAAuB,GAAG,2CAAM;CAGnE,MAAM,EAAE,iBAAiB,eAAe,GAAG,2CAAM;CACjD,MAAM,EAAE,SAAS,GAAG,2CAAM;CAC1B,MAAM,EAAE,iBAAiB,GAAG,2CAAM;CAClC,MAAM,EAAE,WAAW,GAAG,2CAAM;CAE5B,MAAM,UAAU,IAAI,QAAQ;AAE5B,SACA,QAAQ,OACR,QAAQ,SACR,YAAY,uCACZ,OACE,uBACA,wCACA,mBAEF,aAAa;EACX,MAAM,YAAU,QAAQ;AACxB,6BAA2B,UAAQ;CACpC;AAED,SACA,QAAQ,QACR,YACE,uEAEF,OAAO,YAAY;AACjB,QAAM;CACP;AAED,SACA,QAAQ,SACR,YACE,sEAEF,OAAO,uBAAuB,wCAC9B,aAAa;EACX,MAAM,YAAU,QAAQ;AACxB,4BAA0B,UAAQ;CACnC;AAED,SACA,QAAQ,SACR,YAAY,4CACZ,OAAO,uBAAuB,wCAC9B,aAAa;AACX;EACA,MAAM,YAAU,QAAQ;AACxB,SAAO,sBAAsB,UAAQ;CACtC;AAED,SACA,QAAQ,UACR,YACE,wEAEF,SACE,cACA,wEAEF,SAAS,aAAa,yCACtB,OAAO,OAAO,UAAU,SAAS;AAC/B;EAGA,MAAM,EAAE,SAAS,GAAG,MAAM;EAC1B,MAAM,UAAU,IAAI,yCAClB,QAAQ,QAAQ,MAAM,wCAAiB;AAGzC,MAAI;AACF,SAAM,QAAQ;GACd,MAAM,kBAAkB,QAAQ,YAAY;AAE5C,OAAI,CAAC,iBAAiB;AAEpB,QAAI,aAAa,WAAW;KAC1B,MAAM,CAAC,KAAK,GAAG;AACf,SAAI,CAAC,KACH,sBAAM;AAER,WAAM,gBAAgB;AACtB;IACD;AAED,QAAI,aAAa,SAAS;KACxB,MAAM,CAAC,KAAK,GAAG;AACf,SAAI,CAAC,KACH,sBAAM;AAER,WAAM,cAAc;AACpB;IACD;IAED,MAAM,QAAQ,MAAM,KAClB,IAAI,IAAI;KACR;KACA;KACA,GAAG,MAAM,KAAK,QAAQ,eAAe;KAAQ,GAE7C,KAAK,MAAM,IAAI,EAAE;AAEnB,yBACE,aAAa,SAAS,oCAAoC,MAAM,KAAK;GAExE;AAED,SAAM,gBAAgB;EACvB,SAAQ,GAAQ;AACf,wBAAM,+BAA+B,SAAS,4CAAK,EAAG,YAAW;EAClE,UAAS;AACR,SAAM,QAAQ;EACf;CACF;CAED,MAAM,4BAAa,kCAAgB,gBAAgB;AAEnD,KAAI,yBAAY,QAAQ;AACtB,oCAAY,OAAO,EAAE,WAAW,MAAM,EAAE,YAAY,CAAE;AACtD,QAAM,2CAAqB,MAAM,YAAY,CAAE;CACjD;AAEA,OAAM,QAAQ,WAAW,MAAM;AACjC"}
+{"version":3,"file":"init-CrFvqdxZ.js","names":[],"sources":["../src/cli/init.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\nimport { mkdir } from 'node:fs/promises';\nimport { join } from 'node:path';\nimport { generateTypesPackage } from '../utils/types-package';\nimport { loadConfigFile } from '../config/loader';\nimport {\n  CompilerPlugin,\n  CompilerPluginRuntime,\n  isCompilerPlugin,\n} from '../plugins';\nimport { panic } from './common';\nimport { COMMANDKIT_CWD } from '../utils/constants';\n\n/**\n * Creates a command line interface for CommandKit.\n * @param argv The arguments passed to the CLI.\n * @param options The options passed to the CLI.\n */\nexport async function bootstrapCommandkitCLI(\n  argv: string[],\n  options?: import('commander').ParseOptions | undefined,\n) {\n  process.title = 'CommandKit CLI';\n\n  // imports are lazily loaded when the cli is used, instead of loading it with the lib itself\n  const { Command } = await import('commander');\n  const { bootstrapDevelopmentServer } = await import('./development');\n  const { bootstrapProductionServer, createProductionBuild } = await import(\n    './production'\n  );\n  const { generateCommand, generateEvent } = await import('./generators');\n  const { version } = await import('../version');\n  const { showInformation } = await import('./information');\n  const { setCLIEnv } = await import('./env');\n\n  const program = new Command('commandkit');\n\n  program\n    .command('dev')\n    .version(version)\n    .description('Start your bot in development mode.')\n    .option(\n      '-c, --config [path]',\n      'Path to your commandkit config file.',\n      './commandkit.js',\n    )\n    .action(() => {\n      const options = program.opts();\n      bootstrapDevelopmentServer(options.config);\n    });\n\n  program\n    .command('info')\n    .description(\n      'Show information about the system which can be used to report bugs.',\n    )\n    .action(async () => {\n      await showInformation();\n    });\n\n  program\n    .command('start')\n    .description(\n      'Start your bot in production mode after running the build command.',\n    )\n    .option('-c, --config [path]', 'Path to your commandkit config file.')\n    .action(() => {\n      const options = program.opts();\n      bootstrapProductionServer(options.config);\n    });\n\n  program\n    .command('build')\n    .description('Build your project for production usage.')\n    .option('-c, --config [path]', 'Path to your commandkit config file.')\n    .action(() => {\n      setCLIEnv();\n      const options = program.opts();\n      return createProductionBuild(options.config);\n    });\n\n  program\n    .command('create')\n    .description(\n      'Create new files using built-in templates or custom plugin templates',\n    )\n    .argument(\n      '<template>',\n      'The template to use (e.g. command, event, or custom plugin template)',\n    )\n    .argument('[args...]', 'Additional arguments for the template')\n    .action(async (template, args) => {\n      setCLIEnv();\n\n      // Handle custom plugin templates\n      const { plugins } = await loadConfigFile();\n      const runtime = new CompilerPluginRuntime(\n        plugins.filter((p) => isCompilerPlugin(p)) as CompilerPlugin[],\n      );\n\n      try {\n        await runtime.init();\n        const templateHandler = runtime.getTemplate(template);\n\n        if (!templateHandler) {\n          // Handle built-in templates\n          if (template === 'command') {\n            const [name] = args;\n            if (!name) {\n              panic('Command name is required');\n            }\n            await generateCommand(name);\n            return;\n          }\n\n          if (template === 'event') {\n            const [name] = args;\n            if (!name) {\n              panic('Event name is required');\n            }\n            await generateEvent(name);\n            return;\n          }\n\n          const valid = Array.from(\n            new Set([\n              'command',\n              'event',\n              ...Array.from(runtime.getTemplates().keys()),\n            ]),\n          ).map((t) => `\"${t}\"`);\n\n          panic(\n            `Template \"${template}\" not found. Available templates: ${valid.join(', ')}`,\n          );\n        }\n\n        await templateHandler(args);\n      } catch (e: any) {\n        panic(`Failed to execute template \"${template}\": ${e?.message || e}`);\n      } finally {\n        await runtime.destroy();\n      }\n    });\n\n  const types = join(COMMANDKIT_CWD, 'node_modules', 'commandkit-types');\n\n  if (!existsSync(types)) {\n    await mkdir(types, { recursive: true }).catch(() => {});\n    await generateTypesPackage(true).catch(() => {});\n  }\n\n  await program.parseAsync(argv, options);\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAkBA,eAAsB,uBACtB,MACA,SACA;AACE,SAAQ,QAAQ;CAGhB,MAAM,EAAE,YAAY,MAAM,OAAO;CACjC,MAAM,EAAE,+BAA+B,2CAAM;CAC7C,MAAM,EAAE,2BAA2B,0BAA0B,2CAAM;CAGnE,MAAM,EAAE,iBAAiB,kBAAkB,2CAAM;CACjD,MAAM,EAAE,YAAY,2CAAM;CAC1B,MAAM,EAAE,oBAAoB,2CAAM;CAClC,MAAM,EAAE,cAAc,2CAAM;CAE5B,MAAM,UAAU,IAAI,QAAQ;AAE5B,SACA,QAAQ,OACR,QAAQ,SACR,YAAY,uCACZ,OACE,uBACA,wCACA,mBAEF,aAAa;EACX,MAAM,YAAU,QAAQ;AACxB,6BAA2B,UAAQ;;AAGrC,SACA,QAAQ,QACR,YACE,uEAEF,OAAO,YAAY;AACjB,QAAM;;AAGR,SACA,QAAQ,SACR,YACE,sEAEF,OAAO,uBAAuB,wCAC9B,aAAa;EACX,MAAM,YAAU,QAAQ;AACxB,4BAA0B,UAAQ;;AAGpC,SACA,QAAQ,SACR,YAAY,4CACZ,OAAO,uBAAuB,wCAC9B,aAAa;AACX;EACA,MAAM,YAAU,QAAQ;AACxB,SAAO,sBAAsB,UAAQ;;AAGvC,SACA,QAAQ,UACR,YACE,wEAEF,SACE,cACA,wEAEF,SAAS,aAAa,yCACtB,OAAO,OAAO,UAAU,SAAS;AAC/B;EAGA,MAAM,EAAE,YAAY,MAAM;EAC1B,MAAM,UAAU,IAAI,yCAClB,QAAQ,QAAQ,MAAM,wCAAiB;AAGzC,MAAI;AACF,SAAM,QAAQ;GACd,MAAM,kBAAkB,QAAQ,YAAY;AAE5C,OAAI,CAAC,iBAAiB;AAEpB,QAAI,aAAa,WAAW;KAC1B,MAAM,CAAC,QAAQ;AACf,SAAI,CAAC,KACH,sBAAM;AAER,WAAM,gBAAgB;AACtB;;AAGF,QAAI,aAAa,SAAS;KACxB,MAAM,CAAC,QAAQ;AACf,SAAI,CAAC,KACH,sBAAM;AAER,WAAM,cAAc;AACpB;;IAGF,MAAM,QAAQ,MAAM,KAClB,IAAI,IAAI;KACR;KACA;KACA,GAAG,MAAM,KAAK,QAAQ,eAAe;QAErC,KAAK,MAAM,IAAI,EAAE;AAEnB,yBACE,aAAa,SAAS,oCAAoC,MAAM,KAAK;;AAIzE,SAAM,gBAAgB;WACf,GAAQ;AACf,wBAAM,+BAA+B,SAAS,4CAAK,EAAG,YAAW;YACzD;AACR,SAAM,QAAQ;;;CAIlB,MAAM,4BAAa,kCAAgB,gBAAgB;AAEnD,KAAI,yBAAY,QAAQ;AACtB,oCAAY,OAAO,EAAE,WAAW,QAAQ,YAAY;AACpD,QAAM,2CAAqB,MAAM,YAAY;;AAG/C,OAAM,QAAQ,WAAW,MAAM"}

package/dist/kv/constants.d.ts

@@ -1,2 +1,2 @@
-import { SerializerType } from "../constants-DrjIvQd6.js";
+import { SerializerType } from "../constants-D8PMA9on.js";
 export { SerializerType };

package/dist/kv/kv.d.ts

@@ -1,5 +1,5 @@
-import "../constants-DrjIvQd6.js";
-import { SerializedValue } from "../serde-BUDI03pX.js";
+import "../constants-D8PMA9on.js";
+import { SerializedValue } from "../serde-BYaKrsOV.js";
 import { DatabaseSync } from "node:sqlite";
 
 //#region src/kv/kv.d.ts

package/dist/kv/kv.js.map

@@ -1 +1 @@
-{"version":3,"file":"kv.js","names":[],"sources":["../../src/kv/kv.ts"],"sourcesContent":["import { DatabaseSync, StatementSync } from 'node:sqlite';\nimport { deserializer, serializer } from './serde';\nimport { getNestedValue, setNestedValue } from './dotprops';\n\nexport type { SerializedValue } from './serde';\n\n/**\n * Mathematical operators supported by the KV math method\n */\nexport type KvMathOperator = '+' | '-' | '*' | '/' | '^' | '%';\n\n/**\n * Configuration options for the KV store\n */\nexport interface KvOptions {\n  /** Enable Write-Ahead Logging for better performance and durability */\n  enableWAL?: boolean;\n  /** Namespace for the key-value store table */\n  namespace?: string;\n}\n\n/**\n * A key-value store implementation using SQLite\n *\n * This class provides a simple, persistent key-value storage solution\n * with support for namespaces, automatic cleanup, iteration, expiration, and JSON serialization.\n *\n * @example\n * ```typescript\n * const kv = new KV('data.db');\n *\n * // Store any JSON-serializable data\n * kv.set('user:123', { name: 'John', age: 30 });\n * kv.set('counter', 42);\n * kv.set('active', true);\n * kv.set('dates', [new Date(), new Date()]);\n *\n * // Use dot notation for nested properties\n * kv.set('user:123.name', 'John');\n * kv.set('user:123.settings.theme', 'dark');\n *\n * // Retrieve data\n * const user = kv.get('user:123'); // { name: 'John', age: 30, settings: { theme: 'dark' } }\n * const name = kv.get('user:123.name'); // 'John'\n * ```\n */\nexport class KV implements Disposable, AsyncDisposable {\n  private db: DatabaseSync;\n  private statements: Record<string, StatementSync> = {};\n\n  /**\n   * Creates a new KV store instance\n   *\n   * @param path - Database file path, buffer, URL, or existing DatabaseSync instance\n   * @param options - Configuration options for the KV store\n   */\n  public constructor(\n    path: string | Buffer | URL | DatabaseSync,\n    private options: KvOptions = {\n      enableWAL: true,\n      namespace: 'commandkit_kv',\n    },\n  ) {\n    this.db =\n      path instanceof DatabaseSync\n        ? path\n        : new DatabaseSync(path, { open: true });\n\n    if (options.enableWAL) {\n      this.db.exec(/* sql */ `PRAGMA journal_mode = WAL;`);\n    }\n\n    const namespace = this.options.namespace ?? 'commandkit_kv';\n\n    this.db.exec(/* sql */ `\n      CREATE TABLE IF NOT EXISTS ${namespace} (\n        key TEXT PRIMARY KEY,\n        value TEXT,\n        expires_at INTEGER\n      )\n    `);\n\n    this.statements = {\n      get: this.db.prepare(\n        /* sql */ `SELECT value, expires_at FROM ${namespace} WHERE key = ?`,\n      ),\n      set: this.db.prepare(\n        /* sql */ `INSERT OR REPLACE INTO ${namespace} (key, value, expires_at) VALUES (?, ?, ?)`,\n      ),\n      setex: this.db.prepare(\n        /* sql */ `INSERT OR REPLACE INTO ${namespace} (key, value, expires_at) VALUES (?, ?, ?)`,\n      ),\n      delete: this.db.prepare(\n        /* sql */ `DELETE FROM ${namespace} WHERE key = ?`,\n      ),\n      has: this.db.prepare(\n        /* sql */ `SELECT COUNT(*) FROM ${namespace} WHERE key = ? AND (expires_at IS NULL OR expires_at > ?)`,\n      ),\n      keys: this.db.prepare(\n        /* sql */ `SELECT key FROM ${namespace} WHERE expires_at IS NULL OR expires_at > ?`,\n      ),\n      values: this.db.prepare(\n        /* sql */ `SELECT value FROM ${namespace} WHERE expires_at IS NULL OR expires_at > ?`,\n      ),\n      clear: this.db.prepare(/* sql */ `DELETE FROM ${namespace}`),\n      count: this.db.prepare(\n        /* sql */ `SELECT COUNT(*) FROM ${namespace} WHERE expires_at IS NULL OR expires_at > ?`,\n      ),\n      all: this.db.prepare(\n        /* sql */ `SELECT key, value FROM ${namespace} WHERE expires_at IS NULL OR expires_at > ?`,\n      ),\n      expire: this.db.prepare(\n        /* sql */ `UPDATE ${namespace} SET expires_at = ? WHERE key = ?`,\n      ),\n      ttl: this.db.prepare(\n        /* sql */ `SELECT expires_at FROM ${namespace} WHERE key = ?`,\n      ),\n      namespaces: this.db.prepare(\n        /* sql */ `SELECT name FROM sqlite_master WHERE type = 'table' AND name NOT LIKE 'sqlite_%'`,\n      ),\n      begin: this.db.prepare(/* sql */ `BEGIN TRANSACTION`),\n      commit: this.db.prepare(/* sql */ `COMMIT`),\n      rollback: this.db.prepare(/* sql */ `ROLLBACK`),\n    };\n  }\n\n  /**\n   * Gets the current timestamp in milliseconds\n   */\n  private getCurrentTime(): number {\n    return Date.now();\n  }\n\n  /**\n   * Checks if the database connection is open\n   *\n   * @returns `true` if the database is open, `false` otherwise\n   */\n  public isOpen(): boolean {\n    return this.db.isOpen;\n  }\n\n  /**\n   * Gets the underlying SQLite database instance\n   *\n   * @returns The DatabaseSync instance\n   */\n  public getDatabase(): DatabaseSync {\n    return this.db;\n  }\n\n  /**\n   * Closes the database connection\n   */\n  public close(): void {\n    if (this.db.isOpen) this.db.close();\n  }\n\n  /**\n   * Disposable implementation - closes the database when disposed\n   */\n  public [Symbol.dispose]() {\n    this.close();\n  }\n\n  /**\n   * AsyncDisposable implementation - closes the database when disposed\n   */\n  public async [Symbol.asyncDispose]() {\n    this.close();\n  }\n\n  /**\n   * Retrieves a value by key\n   *\n   * @param key - The key to retrieve (supports dot notation for nested properties)\n   * @returns The value associated with the key, or `undefined` if not found or expired\n   *\n   * @example\n   * ```typescript\n   * // Store an object\n   * kv.set('user:123', { name: 'John', age: 30, settings: { theme: 'dark' } });\n   *\n   * // Get the entire object\n   * const user = kv.get('user:123');\n   * // { name: 'John', age: 30, settings: { theme: 'dark' } }\n   *\n   * // Get nested properties using dot notation\n   * const name = kv.get('user:123.name'); // 'John'\n   * const theme = kv.get('user:123.settings.theme'); // 'dark'\n   * ```\n   */\n  public get<T = any>(key: string): T | undefined {\n    const result = this.statements.get.get(key);\n\n    if (!result) return undefined;\n\n    // Check if the key has expired\n    if (\n      result.expires_at &&\n      Number(result.expires_at) <= this.getCurrentTime()\n    ) {\n      this.delete(key);\n      return undefined;\n    }\n\n    const serialized = JSON.parse(result.value as string);\n    const deserialized = deserializer(serialized);\n\n    // Handle dot notation for nested properties\n    if (key.includes('.')) {\n      return getNestedValue(deserialized, key.split('.').slice(1).join('.'));\n    }\n\n    return deserialized;\n  }\n\n  /**\n   * Sets a key-value pair\n   *\n   * @param key - The key to set (supports dot notation for nested properties)\n   * @param value - The value to associate with the key (any JSON-serializable type)\n   *\n   * @example\n   * ```typescript\n   * // Store primitive values\n   * kv.set('counter', 42);\n   * kv.set('active', true);\n   * kv.set('name', 'John');\n   *\n   * // Store objects\n   * kv.set('user:123', { name: 'John', age: 30 });\n   *\n   * // Store arrays\n   * kv.set('tags', ['javascript', 'typescript', 'sqlite']);\n   *\n   * // Store dates\n   * kv.set('created', new Date());\n   *\n   * // Store maps and sets\n   * kv.set('permissions', new Map([['admin', true], ['user', false]]));\n   * kv.set('unique_ids', new Set([1, 2, 3, 4, 5]));\n   *\n   * // Use dot notation for nested properties\n   * kv.set('user:123.settings.theme', 'dark');\n   * kv.set('user:123.settings.notifications', true);\n   * ```\n   */\n  public set(key: string, value: any): void {\n    let serializedValue: string;\n\n    if (key.includes('.')) {\n      // Handle dot notation for nested properties\n      const [baseKey, ...pathParts] = key.split('.');\n      const path = pathParts.join('.');\n\n      // Get existing value or create new object\n      const existing = this.get(baseKey) || {};\n      setNestedValue(existing, path, value);\n\n      const serialized = serializer(existing);\n      serializedValue = JSON.stringify(serialized);\n\n      this.statements.set.run(baseKey, serializedValue, null);\n    } else {\n      const serialized = serializer(value);\n      serializedValue = JSON.stringify(serialized);\n\n      this.statements.set.run(key, serializedValue, null);\n    }\n  }\n\n  /**\n   * Sets a key-value pair with expiration\n   *\n   * @param key - The key to set (supports dot notation for nested properties)\n   * @param value - The value to associate with the key (any JSON-serializable type)\n   * @param ttl - Time to live in milliseconds\n   *\n   * @example\n   * ```typescript\n   * // Set with 1 hour expiration\n   * kv.setex('session:123', { userId: 123, token: 'abc123' }, 60 * 60 * 1000);\n   *\n   * // Set with 5 minutes expiration\n   * kv.setex('temp:data', { cached: true, timestamp: Date.now() }, 5 * 60 * 1000);\n   *\n   * // Use dot notation with expiration\n   * kv.setex('user:123.temp_settings', { theme: 'light' }, 30 * 60 * 1000);\n   * ```\n   */\n  public setex(key: string, value: any, ttl: number): void {\n    const expiresAt = this.getCurrentTime() + ttl;\n    let serializedValue: string;\n\n    if (key.includes('.')) {\n      // Handle dot notation for nested properties\n      const [baseKey, ...pathParts] = key.split('.');\n      const path = pathParts.join('.');\n\n      // Get existing value or create new object\n      const existing = this.get(baseKey) || {};\n      setNestedValue(existing, path, value);\n\n      const serialized = serializer(existing);\n      serializedValue = JSON.stringify(serialized);\n\n      this.statements.setex.run(baseKey, serializedValue, expiresAt);\n    } else {\n      const serialized = serializer(value);\n      serializedValue = JSON.stringify(serialized);\n\n      this.statements.setex.run(key, serializedValue, expiresAt);\n    }\n  }\n\n  /**\n   * Performs mathematical operations on numeric values in the KV store\n   *\n   * @param key - The key to perform math operation on (supports dot notation for nested properties)\n   * @param operator - The mathematical operator to apply\n   * @param value - The value to use in the operation\n   * @returns The updated value after the mathematical operation\n   * @throws Error if the existing value is not numeric or if the operation is invalid\n   *\n   * @example\n   * ```typescript\n   * // Initialize a counter\n   * kv.set('counter', 10);\n   *\n   * // Increment by 5\n   * const result1 = kv.math('counter', '+', 5); // 15\n   *\n   * // Multiply by 2\n   * const result2 = kv.math('counter', '*', 2); // 30\n   *\n   * // Use with bigint\n   * kv.set('big_counter', BigInt(1000));\n   * const result3 = kv.math('big_counter', '+', BigInt(500)); // 1500n\n   *\n   * // Use with dot notation\n   * kv.set('user:123', { score: 100, level: 5 });\n   * const result4 = kv.math('user:123.score', '+', 50); // 150\n   * ```\n   */\n  public math(\n    key: string,\n    operator: KvMathOperator,\n    value: number | bigint,\n  ): number | bigint {\n    const existingValue = this.get(key);\n\n    if (existingValue === undefined) {\n      throw new Error(`Key '${key}' does not exist`);\n    }\n\n    if (\n      typeof existingValue !== 'number' &&\n      typeof existingValue !== 'bigint'\n    ) {\n      throw new Error(\n        `Value at key '${key}' is not numeric. Expected number or bigint, got ${typeof existingValue}`,\n      );\n    }\n\n    // Handle mixed number/bigint operations by converting to bigint\n    const isBigIntOperation =\n      typeof existingValue === 'bigint' || typeof value === 'bigint';\n\n    const existing = isBigIntOperation\n      ? typeof existingValue === 'bigint'\n        ? existingValue\n        : BigInt(existingValue)\n      : (existingValue as number);\n    const operand = isBigIntOperation\n      ? typeof value === 'bigint'\n        ? value\n        : BigInt(value)\n      : (value as number);\n\n    let result: number | bigint;\n\n    switch (operator) {\n      case '+':\n        result = (existing as any) + (operand as any);\n        break;\n      case '-':\n        result = (existing as any) - (operand as any);\n        break;\n      case '*':\n        result = (existing as any) * (operand as any);\n        break;\n      case '/':\n        if (operand === 0 || operand === 0n) {\n          throw new Error('Division by zero');\n        }\n        result = (existing as any) / (operand as any);\n        break;\n      case '^':\n        if (isBigIntOperation && operand < 0n) {\n          throw new Error(\n            'Exponentiation with negative exponent is not supported for bigint',\n          );\n        }\n        result = (existing as any) ** (operand as any);\n        break;\n      case '%':\n        if (operand === 0 || operand === 0n) {\n          throw new Error('Modulo by zero');\n        }\n        result = (existing as any) % (operand as any);\n        break;\n      default:\n        throw new Error(`Invalid operator: ${operator}`);\n    }\n\n    // Update the value in the store\n    this.set(key, result);\n\n    return result;\n  }\n\n  /**\n   * Sets expiration for an existing key\n   *\n   * @param key - The key to set expiration for\n   * @param ttl - Time to live in milliseconds\n   * @returns `true` if the key exists and expiration was set, `false` otherwise\n   *\n   * @example\n   * ```typescript\n   * kv.set('user:123', { name: 'John', age: 30 });\n   *\n   * // Set 30 minute expiration\n   * if (kv.expire('user:123', 30 * 60 * 1000)) {\n   *   console.log('Expiration set successfully');\n   * }\n   * ```\n   */\n  public expire(key: string, ttl: number): boolean {\n    if (!this.has(key)) return false;\n\n    const expiresAt = this.getCurrentTime() + ttl;\n    this.statements.expire.run(expiresAt, key);\n    return true;\n  }\n\n  /**\n   * Gets the time to live for a key\n   *\n   * @param key - The key to check\n   * @returns Time to live in milliseconds, or `-1` if the key doesn't exist, or `-2` if the key has no expiration\n   *\n   * @example\n   * ```typescript\n   * const ttl = kv.ttl('user:123');\n   * if (ttl > 0) {\n   *   console.log(`Key expires in ${ttl}ms`);\n   * } else if (ttl === -2) {\n   *   console.log('Key has no expiration');\n   * } else {\n   *   console.log('Key does not exist');\n   * }\n   * ```\n   */\n  public ttl(key: string): number {\n    const result = this.statements.ttl.get(key);\n\n    if (!result) return -1; // Key doesn't exist\n\n    if (!result.expires_at) return -2; // No expiration\n\n    const remaining = Number(result.expires_at) - this.getCurrentTime();\n    return remaining > 0 ? remaining : -1; // Expired or doesn't exist\n  }\n\n  /**\n   * Deletes a key-value pair\n   *\n   * @param key - The key to delete\n   *\n   * @example\n   * ```typescript\n   * kv.delete('user:123');\n   * kv.delete('user:123.settings.theme'); // Delete nested property\n   * ```\n   */\n  public delete(key: string): void {\n    this.statements.delete.run(key);\n  }\n\n  /**\n   * Checks if a key exists and is not expired\n   *\n   * @param key - The key to check\n   * @returns `true` if the key exists and is not expired, `false` otherwise\n   *\n   * @example\n   * ```typescript\n   * if (kv.has('user:123')) {\n   *   console.log('User exists and is not expired');\n   * }\n   *\n   * if (kv.has('user:123.settings.theme')) {\n   *   console.log('Theme setting exists');\n   * }\n   * ```\n   */\n  public has(key: string): boolean {\n    const result = this.statements.has.get(key, this.getCurrentTime());\n\n    return (\n      result?.count !== undefined &&\n      result.count !== null &&\n      Number(result.count) > 0\n    );\n  }\n\n  /**\n   * Gets all keys in the current namespace (excluding expired keys)\n   *\n   * @returns Array of all non-expired keys\n   *\n   * @example\n   * ```typescript\n   * const keys = kv.keys();\n   * console.log('All keys:', keys);\n   * ```\n   */\n  public keys(): string[] {\n    const result = this.statements.keys.all(this.getCurrentTime());\n\n    return result.map((row) => row.key as string);\n  }\n\n  /**\n   * Gets all values in the current namespace (excluding expired keys)\n   *\n   * @returns Array of all non-expired values\n   *\n   * @example\n   * ```typescript\n   * const values = kv.values();\n   * console.log('All values:', values);\n   * ```\n   */\n  public values(): any[] {\n    const result = this.statements.values.all(this.getCurrentTime());\n\n    return result.map((row) => {\n      const serialized = JSON.parse(row.value as string);\n      return deserializer(serialized);\n    });\n  }\n\n  /**\n   * Gets the total number of key-value pairs in the current namespace (excluding expired keys)\n   *\n   * @returns The count of non-expired key-value pairs\n   *\n   * @example\n   * ```typescript\n   * const count = kv.count();\n   * console.log(`Total entries: ${count}`);\n   * ```\n   */\n  public count(): number {\n    const result = this.statements.count.get(this.getCurrentTime());\n\n    return Number(result?.count ?? 0);\n  }\n\n  /**\n   * Removes all key-value pairs from the current namespace\n   *\n   * @example\n   * ```typescript\n   * kv.clear(); // Removes all entries in current namespace\n   * ```\n   */\n  public clear(): void {\n    this.statements.clear.run();\n  }\n\n  /**\n   * Gets all key-value pairs as an object (excluding expired keys)\n   *\n   * @returns Object with all non-expired key-value pairs\n   *\n   * @example\n   * ```typescript\n   * const all = kv.all();\n   * console.log('All entries:', all);\n   * // Output: { 'key1': value1, 'key2': value2 }\n   * ```\n   */\n  public all(): Record<string, any> {\n    const result = this.statements.all.all(this.getCurrentTime());\n\n    return Object.fromEntries(\n      result.map((row) => {\n        const serialized = JSON.parse(row.value as string);\n        return [row.key as string, deserializer(serialized)];\n      }),\n    );\n  }\n\n  /**\n   * Gets all available namespaces (tables) in the database\n   *\n   * @returns Array of namespace names\n   *\n   * @example\n   * ```typescript\n   * const namespaces = kv.namespaces();\n   * console.log('Available namespaces:', namespaces);\n   * ```\n   */\n  public namespaces(): string[] {\n    const result = this.statements.namespaces.all();\n\n    return result.map((row) => row.name as string);\n  }\n\n  /**\n   * Gets the current namespace name\n   *\n   * @returns The current namespace string\n   */\n  public getCurrentNamespace(): string {\n    return this.options.namespace ?? 'commandkit_kv';\n  }\n\n  /**\n   * Creates a new KV instance with a different namespace\n   *\n   * @param namespace - The namespace to use for the new instance\n   * @returns A new KV instance with the specified namespace\n   *\n   * @example\n   * ```typescript\n   * const userKv = kv.namespace('users');\n   * const configKv = kv.namespace('config');\n   *\n   * userKv.set('123', { name: 'John', age: 30 });\n   * configKv.set('theme', 'dark');\n   * ```\n   */\n  public namespace(namespace: string): KV {\n    return new KV(this.db, {\n      enableWAL: this.options.enableWAL,\n      namespace,\n    });\n  }\n\n  /**\n   * Iterator implementation for iterating over all non-expired key-value pairs\n   *\n   * @returns Iterator yielding [key, value] tuples\n   *\n   * @example\n   * ```typescript\n   * for (const [key, value] of kv) {\n   *   console.log(`${key}:`, value);\n   * }\n   *\n   * // Or using spread operator\n   * const entries = [...kv];\n   * ```\n   */\n  public *[Symbol.iterator](): Iterator<[string, any]> {\n    const result = this.statements.all.iterate(this.getCurrentTime());\n\n    for (const row of result) {\n      const serialized = JSON.parse(row.value as string);\n      yield [row.key as string, deserializer(serialized)];\n    }\n  }\n\n  /**\n   * Executes a function within a transaction\n   *\n   * @param fn - Function to execute within the transaction (can be async)\n   * @returns The result of the function\n   *\n   * @example\n   * ```typescript\n   * // Synchronous transaction\n   * kv.transaction(() => {\n   *   kv.set('user:123', { name: 'John', age: 30 });\n   *   kv.set('user:456', { name: 'Jane', age: 25 });\n   *   // If any operation fails, all changes are rolled back\n   * });\n   *\n   * // Async transaction\n   * await kv.transaction(async () => {\n   *   kv.set('user:123', { name: 'John', age: 30 });\n   *   await someAsyncOperation();\n   *   kv.set('user:456', { name: 'Jane', age: 25 });\n   *   // If any operation fails, all changes are rolled back\n   * });\n   * ```\n   */\n  public async transaction<T>(fn: () => T | Promise<T>): Promise<T> {\n    try {\n      // Begin transaction\n      this.statements.begin.run();\n\n      // Execute the function\n      const result = await fn();\n\n      // Commit transaction\n      this.statements.commit.run();\n\n      return result;\n    } catch (error) {\n      // Rollback transaction on error\n      this.statements.rollback.run();\n      throw error;\n    }\n  }\n}\n\n/**\n * Opens a new KV instance\n *\n * @param path - Database file path, buffer, URL, or existing DatabaseSync instance\n * @param options - Configuration options for the KV store\n * @returns A new KV instance\n */\nexport function openKV(\n  path: string | Buffer | URL | DatabaseSync = 'commandkit_kv.db',\n  options: KvOptions = { enableWAL: true, namespace: 'commandkit_kv' },\n): KV {\n  return new KV(path, options);\n}\n"],"mappings":"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"}
+{"version":3,"file":"kv.js","names":[],"sources":["../../src/kv/kv.ts"],"sourcesContent":["import { DatabaseSync, StatementSync } from 'node:sqlite';\nimport { deserializer, serializer } from './serde';\nimport { getNestedValue, setNestedValue } from './dotprops';\n\nexport type { SerializedValue } from './serde';\n\n/**\n * Mathematical operators supported by the KV math method\n */\nexport type KvMathOperator = '+' | '-' | '*' | '/' | '^' | '%';\n\n/**\n * Configuration options for the KV store\n */\nexport interface KvOptions {\n  /** Enable Write-Ahead Logging for better performance and durability */\n  enableWAL?: boolean;\n  /** Namespace for the key-value store table */\n  namespace?: string;\n}\n\n/**\n * A key-value store implementation using SQLite\n *\n * This class provides a simple, persistent key-value storage solution\n * with support for namespaces, automatic cleanup, iteration, expiration, and JSON serialization.\n *\n * @example\n * ```typescript\n * const kv = new KV('data.db');\n *\n * // Store any JSON-serializable data\n * kv.set('user:123', { name: 'John', age: 30 });\n * kv.set('counter', 42);\n * kv.set('active', true);\n * kv.set('dates', [new Date(), new Date()]);\n *\n * // Use dot notation for nested properties\n * kv.set('user:123.name', 'John');\n * kv.set('user:123.settings.theme', 'dark');\n *\n * // Retrieve data\n * const user = kv.get('user:123'); // { name: 'John', age: 30, settings: { theme: 'dark' } }\n * const name = kv.get('user:123.name'); // 'John'\n * ```\n */\nexport class KV implements Disposable, AsyncDisposable {\n  private db: DatabaseSync;\n  private statements: Record<string, StatementSync> = {};\n\n  /**\n   * Creates a new KV store instance\n   *\n   * @param path - Database file path, buffer, URL, or existing DatabaseSync instance\n   * @param options - Configuration options for the KV store\n   */\n  public constructor(\n    path: string | Buffer | URL | DatabaseSync,\n    private options: KvOptions = {\n      enableWAL: true,\n      namespace: 'commandkit_kv',\n    },\n  ) {\n    this.db =\n      path instanceof DatabaseSync\n        ? path\n        : new DatabaseSync(path, { open: true });\n\n    if (options.enableWAL) {\n      this.db.exec(/* sql */ `PRAGMA journal_mode = WAL;`);\n    }\n\n    const namespace = this.options.namespace ?? 'commandkit_kv';\n\n    this.db.exec(/* sql */ `\n      CREATE TABLE IF NOT EXISTS ${namespace} (\n        key TEXT PRIMARY KEY,\n        value TEXT,\n        expires_at INTEGER\n      )\n    `);\n\n    this.statements = {\n      get: this.db.prepare(\n        /* sql */ `SELECT value, expires_at FROM ${namespace} WHERE key = ?`,\n      ),\n      set: this.db.prepare(\n        /* sql */ `INSERT OR REPLACE INTO ${namespace} (key, value, expires_at) VALUES (?, ?, ?)`,\n      ),\n      setex: this.db.prepare(\n        /* sql */ `INSERT OR REPLACE INTO ${namespace} (key, value, expires_at) VALUES (?, ?, ?)`,\n      ),\n      delete: this.db.prepare(\n        /* sql */ `DELETE FROM ${namespace} WHERE key = ?`,\n      ),\n      has: this.db.prepare(\n        /* sql */ `SELECT COUNT(*) FROM ${namespace} WHERE key = ? AND (expires_at IS NULL OR expires_at > ?)`,\n      ),\n      keys: this.db.prepare(\n        /* sql */ `SELECT key FROM ${namespace} WHERE expires_at IS NULL OR expires_at > ?`,\n      ),\n      values: this.db.prepare(\n        /* sql */ `SELECT value FROM ${namespace} WHERE expires_at IS NULL OR expires_at > ?`,\n      ),\n      clear: this.db.prepare(/* sql */ `DELETE FROM ${namespace}`),\n      count: this.db.prepare(\n        /* sql */ `SELECT COUNT(*) FROM ${namespace} WHERE expires_at IS NULL OR expires_at > ?`,\n      ),\n      all: this.db.prepare(\n        /* sql */ `SELECT key, value FROM ${namespace} WHERE expires_at IS NULL OR expires_at > ?`,\n      ),\n      expire: this.db.prepare(\n        /* sql */ `UPDATE ${namespace} SET expires_at = ? WHERE key = ?`,\n      ),\n      ttl: this.db.prepare(\n        /* sql */ `SELECT expires_at FROM ${namespace} WHERE key = ?`,\n      ),\n      namespaces: this.db.prepare(\n        /* sql */ `SELECT name FROM sqlite_master WHERE type = 'table' AND name NOT LIKE 'sqlite_%'`,\n      ),\n      begin: this.db.prepare(/* sql */ `BEGIN TRANSACTION`),\n      commit: this.db.prepare(/* sql */ `COMMIT`),\n      rollback: this.db.prepare(/* sql */ `ROLLBACK`),\n    };\n  }\n\n  /**\n   * Gets the current timestamp in milliseconds\n   */\n  private getCurrentTime(): number {\n    return Date.now();\n  }\n\n  /**\n   * Checks if the database connection is open\n   *\n   * @returns `true` if the database is open, `false` otherwise\n   */\n  public isOpen(): boolean {\n    return this.db.isOpen;\n  }\n\n  /**\n   * Gets the underlying SQLite database instance\n   *\n   * @returns The DatabaseSync instance\n   */\n  public getDatabase(): DatabaseSync {\n    return this.db;\n  }\n\n  /**\n   * Closes the database connection\n   */\n  public close(): void {\n    if (this.db.isOpen) this.db.close();\n  }\n\n  /**\n   * Disposable implementation - closes the database when disposed\n   */\n  public [Symbol.dispose]() {\n    this.close();\n  }\n\n  /**\n   * AsyncDisposable implementation - closes the database when disposed\n   */\n  public async [Symbol.asyncDispose]() {\n    this.close();\n  }\n\n  /**\n   * Retrieves a value by key\n   *\n   * @param key - The key to retrieve (supports dot notation for nested properties)\n   * @returns The value associated with the key, or `undefined` if not found or expired\n   *\n   * @example\n   * ```typescript\n   * // Store an object\n   * kv.set('user:123', { name: 'John', age: 30, settings: { theme: 'dark' } });\n   *\n   * // Get the entire object\n   * const user = kv.get('user:123');\n   * // { name: 'John', age: 30, settings: { theme: 'dark' } }\n   *\n   * // Get nested properties using dot notation\n   * const name = kv.get('user:123.name'); // 'John'\n   * const theme = kv.get('user:123.settings.theme'); // 'dark'\n   * ```\n   */\n  public get<T = any>(key: string): T | undefined {\n    const result = this.statements.get.get(key);\n\n    if (!result) return undefined;\n\n    // Check if the key has expired\n    if (\n      result.expires_at &&\n      Number(result.expires_at) <= this.getCurrentTime()\n    ) {\n      this.delete(key);\n      return undefined;\n    }\n\n    const serialized = JSON.parse(result.value as string);\n    const deserialized = deserializer(serialized);\n\n    // Handle dot notation for nested properties\n    if (key.includes('.')) {\n      return getNestedValue(deserialized, key.split('.').slice(1).join('.'));\n    }\n\n    return deserialized;\n  }\n\n  /**\n   * Sets a key-value pair\n   *\n   * @param key - The key to set (supports dot notation for nested properties)\n   * @param value - The value to associate with the key (any JSON-serializable type)\n   *\n   * @example\n   * ```typescript\n   * // Store primitive values\n   * kv.set('counter', 42);\n   * kv.set('active', true);\n   * kv.set('name', 'John');\n   *\n   * // Store objects\n   * kv.set('user:123', { name: 'John', age: 30 });\n   *\n   * // Store arrays\n   * kv.set('tags', ['javascript', 'typescript', 'sqlite']);\n   *\n   * // Store dates\n   * kv.set('created', new Date());\n   *\n   * // Store maps and sets\n   * kv.set('permissions', new Map([['admin', true], ['user', false]]));\n   * kv.set('unique_ids', new Set([1, 2, 3, 4, 5]));\n   *\n   * // Use dot notation for nested properties\n   * kv.set('user:123.settings.theme', 'dark');\n   * kv.set('user:123.settings.notifications', true);\n   * ```\n   */\n  public set(key: string, value: any): void {\n    let serializedValue: string;\n\n    if (key.includes('.')) {\n      // Handle dot notation for nested properties\n      const [baseKey, ...pathParts] = key.split('.');\n      const path = pathParts.join('.');\n\n      // Get existing value or create new object\n      const existing = this.get(baseKey) || {};\n      setNestedValue(existing, path, value);\n\n      const serialized = serializer(existing);\n      serializedValue = JSON.stringify(serialized);\n\n      this.statements.set.run(baseKey, serializedValue, null);\n    } else {\n      const serialized = serializer(value);\n      serializedValue = JSON.stringify(serialized);\n\n      this.statements.set.run(key, serializedValue, null);\n    }\n  }\n\n  /**\n   * Sets a key-value pair with expiration\n   *\n   * @param key - The key to set (supports dot notation for nested properties)\n   * @param value - The value to associate with the key (any JSON-serializable type)\n   * @param ttl - Time to live in milliseconds\n   *\n   * @example\n   * ```typescript\n   * // Set with 1 hour expiration\n   * kv.setex('session:123', { userId: 123, token: 'abc123' }, 60 * 60 * 1000);\n   *\n   * // Set with 5 minutes expiration\n   * kv.setex('temp:data', { cached: true, timestamp: Date.now() }, 5 * 60 * 1000);\n   *\n   * // Use dot notation with expiration\n   * kv.setex('user:123.temp_settings', { theme: 'light' }, 30 * 60 * 1000);\n   * ```\n   */\n  public setex(key: string, value: any, ttl: number): void {\n    const expiresAt = this.getCurrentTime() + ttl;\n    let serializedValue: string;\n\n    if (key.includes('.')) {\n      // Handle dot notation for nested properties\n      const [baseKey, ...pathParts] = key.split('.');\n      const path = pathParts.join('.');\n\n      // Get existing value or create new object\n      const existing = this.get(baseKey) || {};\n      setNestedValue(existing, path, value);\n\n      const serialized = serializer(existing);\n      serializedValue = JSON.stringify(serialized);\n\n      this.statements.setex.run(baseKey, serializedValue, expiresAt);\n    } else {\n      const serialized = serializer(value);\n      serializedValue = JSON.stringify(serialized);\n\n      this.statements.setex.run(key, serializedValue, expiresAt);\n    }\n  }\n\n  /**\n   * Performs mathematical operations on numeric values in the KV store\n   *\n   * @param key - The key to perform math operation on (supports dot notation for nested properties)\n   * @param operator - The mathematical operator to apply\n   * @param value - The value to use in the operation\n   * @returns The updated value after the mathematical operation\n   * @throws Error if the existing value is not numeric or if the operation is invalid\n   *\n   * @example\n   * ```typescript\n   * // Initialize a counter\n   * kv.set('counter', 10);\n   *\n   * // Increment by 5\n   * const result1 = kv.math('counter', '+', 5); // 15\n   *\n   * // Multiply by 2\n   * const result2 = kv.math('counter', '*', 2); // 30\n   *\n   * // Use with bigint\n   * kv.set('big_counter', BigInt(1000));\n   * const result3 = kv.math('big_counter', '+', BigInt(500)); // 1500n\n   *\n   * // Use with dot notation\n   * kv.set('user:123', { score: 100, level: 5 });\n   * const result4 = kv.math('user:123.score', '+', 50); // 150\n   * ```\n   */\n  public math(\n    key: string,\n    operator: KvMathOperator,\n    value: number | bigint,\n  ): number | bigint {\n    const existingValue = this.get(key);\n\n    if (existingValue === undefined) {\n      throw new Error(`Key '${key}' does not exist`);\n    }\n\n    if (\n      typeof existingValue !== 'number' &&\n      typeof existingValue !== 'bigint'\n    ) {\n      throw new Error(\n        `Value at key '${key}' is not numeric. Expected number or bigint, got ${typeof existingValue}`,\n      );\n    }\n\n    // Handle mixed number/bigint operations by converting to bigint\n    const isBigIntOperation =\n      typeof existingValue === 'bigint' || typeof value === 'bigint';\n\n    const existing = isBigIntOperation\n      ? typeof existingValue === 'bigint'\n        ? existingValue\n        : BigInt(existingValue)\n      : (existingValue as number);\n    const operand = isBigIntOperation\n      ? typeof value === 'bigint'\n        ? value\n        : BigInt(value)\n      : (value as number);\n\n    let result: number | bigint;\n\n    switch (operator) {\n      case '+':\n        result = (existing as any) + (operand as any);\n        break;\n      case '-':\n        result = (existing as any) - (operand as any);\n        break;\n      case '*':\n        result = (existing as any) * (operand as any);\n        break;\n      case '/':\n        if (operand === 0 || operand === 0n) {\n          throw new Error('Division by zero');\n        }\n        result = (existing as any) / (operand as any);\n        break;\n      case '^':\n        if (isBigIntOperation && operand < 0n) {\n          throw new Error(\n            'Exponentiation with negative exponent is not supported for bigint',\n          );\n        }\n        result = (existing as any) ** (operand as any);\n        break;\n      case '%':\n        if (operand === 0 || operand === 0n) {\n          throw new Error('Modulo by zero');\n        }\n        result = (existing as any) % (operand as any);\n        break;\n      default:\n        throw new Error(`Invalid operator: ${operator}`);\n    }\n\n    // Update the value in the store\n    this.set(key, result);\n\n    return result;\n  }\n\n  /**\n   * Sets expiration for an existing key\n   *\n   * @param key - The key to set expiration for\n   * @param ttl - Time to live in milliseconds\n   * @returns `true` if the key exists and expiration was set, `false` otherwise\n   *\n   * @example\n   * ```typescript\n   * kv.set('user:123', { name: 'John', age: 30 });\n   *\n   * // Set 30 minute expiration\n   * if (kv.expire('user:123', 30 * 60 * 1000)) {\n   *   console.log('Expiration set successfully');\n   * }\n   * ```\n   */\n  public expire(key: string, ttl: number): boolean {\n    if (!this.has(key)) return false;\n\n    const expiresAt = this.getCurrentTime() + ttl;\n    this.statements.expire.run(expiresAt, key);\n    return true;\n  }\n\n  /**\n   * Gets the time to live for a key\n   *\n   * @param key - The key to check\n   * @returns Time to live in milliseconds, or `-1` if the key doesn't exist, or `-2` if the key has no expiration\n   *\n   * @example\n   * ```typescript\n   * const ttl = kv.ttl('user:123');\n   * if (ttl > 0) {\n   *   console.log(`Key expires in ${ttl}ms`);\n   * } else if (ttl === -2) {\n   *   console.log('Key has no expiration');\n   * } else {\n   *   console.log('Key does not exist');\n   * }\n   * ```\n   */\n  public ttl(key: string): number {\n    const result = this.statements.ttl.get(key);\n\n    if (!result) return -1; // Key doesn't exist\n\n    if (!result.expires_at) return -2; // No expiration\n\n    const remaining = Number(result.expires_at) - this.getCurrentTime();\n    return remaining > 0 ? remaining : -1; // Expired or doesn't exist\n  }\n\n  /**\n   * Deletes a key-value pair\n   *\n   * @param key - The key to delete\n   *\n   * @example\n   * ```typescript\n   * kv.delete('user:123');\n   * kv.delete('user:123.settings.theme'); // Delete nested property\n   * ```\n   */\n  public delete(key: string): void {\n    this.statements.delete.run(key);\n  }\n\n  /**\n   * Checks if a key exists and is not expired\n   *\n   * @param key - The key to check\n   * @returns `true` if the key exists and is not expired, `false` otherwise\n   *\n   * @example\n   * ```typescript\n   * if (kv.has('user:123')) {\n   *   console.log('User exists and is not expired');\n   * }\n   *\n   * if (kv.has('user:123.settings.theme')) {\n   *   console.log('Theme setting exists');\n   * }\n   * ```\n   */\n  public has(key: string): boolean {\n    const result = this.statements.has.get(key, this.getCurrentTime());\n\n    return (\n      result?.count !== undefined &&\n      result.count !== null &&\n      Number(result.count) > 0\n    );\n  }\n\n  /**\n   * Gets all keys in the current namespace (excluding expired keys)\n   *\n   * @returns Array of all non-expired keys\n   *\n   * @example\n   * ```typescript\n   * const keys = kv.keys();\n   * console.log('All keys:', keys);\n   * ```\n   */\n  public keys(): string[] {\n    const result = this.statements.keys.all(this.getCurrentTime());\n\n    return result.map((row) => row.key as string);\n  }\n\n  /**\n   * Gets all values in the current namespace (excluding expired keys)\n   *\n   * @returns Array of all non-expired values\n   *\n   * @example\n   * ```typescript\n   * const values = kv.values();\n   * console.log('All values:', values);\n   * ```\n   */\n  public values(): any[] {\n    const result = this.statements.values.all(this.getCurrentTime());\n\n    return result.map((row) => {\n      const serialized = JSON.parse(row.value as string);\n      return deserializer(serialized);\n    });\n  }\n\n  /**\n   * Gets the total number of key-value pairs in the current namespace (excluding expired keys)\n   *\n   * @returns The count of non-expired key-value pairs\n   *\n   * @example\n   * ```typescript\n   * const count = kv.count();\n   * console.log(`Total entries: ${count}`);\n   * ```\n   */\n  public count(): number {\n    const result = this.statements.count.get(this.getCurrentTime());\n\n    return Number(result?.count ?? 0);\n  }\n\n  /**\n   * Removes all key-value pairs from the current namespace\n   *\n   * @example\n   * ```typescript\n   * kv.clear(); // Removes all entries in current namespace\n   * ```\n   */\n  public clear(): void {\n    this.statements.clear.run();\n  }\n\n  /**\n   * Gets all key-value pairs as an object (excluding expired keys)\n   *\n   * @returns Object with all non-expired key-value pairs\n   *\n   * @example\n   * ```typescript\n   * const all = kv.all();\n   * console.log('All entries:', all);\n   * // Output: { 'key1': value1, 'key2': value2 }\n   * ```\n   */\n  public all(): Record<string, any> {\n    const result = this.statements.all.all(this.getCurrentTime());\n\n    return Object.fromEntries(\n      result.map((row) => {\n        const serialized = JSON.parse(row.value as string);\n        return [row.key as string, deserializer(serialized)];\n      }),\n    );\n  }\n\n  /**\n   * Gets all available namespaces (tables) in the database\n   *\n   * @returns Array of namespace names\n   *\n   * @example\n   * ```typescript\n   * const namespaces = kv.namespaces();\n   * console.log('Available namespaces:', namespaces);\n   * ```\n   */\n  public namespaces(): string[] {\n    const result = this.statements.namespaces.all();\n\n    return result.map((row) => row.name as string);\n  }\n\n  /**\n   * Gets the current namespace name\n   *\n   * @returns The current namespace string\n   */\n  public getCurrentNamespace(): string {\n    return this.options.namespace ?? 'commandkit_kv';\n  }\n\n  /**\n   * Creates a new KV instance with a different namespace\n   *\n   * @param namespace - The namespace to use for the new instance\n   * @returns A new KV instance with the specified namespace\n   *\n   * @example\n   * ```typescript\n   * const userKv = kv.namespace('users');\n   * const configKv = kv.namespace('config');\n   *\n   * userKv.set('123', { name: 'John', age: 30 });\n   * configKv.set('theme', 'dark');\n   * ```\n   */\n  public namespace(namespace: string): KV {\n    return new KV(this.db, {\n      enableWAL: this.options.enableWAL,\n      namespace,\n    });\n  }\n\n  /**\n   * Iterator implementation for iterating over all non-expired key-value pairs\n   *\n   * @returns Iterator yielding [key, value] tuples\n   *\n   * @example\n   * ```typescript\n   * for (const [key, value] of kv) {\n   *   console.log(`${key}:`, value);\n   * }\n   *\n   * // Or using spread operator\n   * const entries = [...kv];\n   * ```\n   */\n  public *[Symbol.iterator](): Iterator<[string, any]> {\n    const result = this.statements.all.iterate(this.getCurrentTime());\n\n    for (const row of result) {\n      const serialized = JSON.parse(row.value as string);\n      yield [row.key as string, deserializer(serialized)];\n    }\n  }\n\n  /**\n   * Executes a function within a transaction\n   *\n   * @param fn - Function to execute within the transaction (can be async)\n   * @returns The result of the function\n   *\n   * @example\n   * ```typescript\n   * // Synchronous transaction\n   * kv.transaction(() => {\n   *   kv.set('user:123', { name: 'John', age: 30 });\n   *   kv.set('user:456', { name: 'Jane', age: 25 });\n   *   // If any operation fails, all changes are rolled back\n   * });\n   *\n   * // Async transaction\n   * await kv.transaction(async () => {\n   *   kv.set('user:123', { name: 'John', age: 30 });\n   *   await someAsyncOperation();\n   *   kv.set('user:456', { name: 'Jane', age: 25 });\n   *   // If any operation fails, all changes are rolled back\n   * });\n   * ```\n   */\n  public async transaction<T>(fn: () => T | Promise<T>): Promise<T> {\n    try {\n      // Begin transaction\n      this.statements.begin.run();\n\n      // Execute the function\n      const result = await fn();\n\n      // Commit transaction\n      this.statements.commit.run();\n\n      return result;\n    } catch (error) {\n      // Rollback transaction on error\n      this.statements.rollback.run();\n      throw error;\n    }\n  }\n}\n\n/**\n * Opens a new KV instance\n *\n * @param path - Database file path, buffer, URL, or existing DatabaseSync instance\n * @param options - Configuration options for the KV store\n * @returns A new KV instance\n */\nexport function openKV(\n  path: string | Buffer | URL | DatabaseSync = 'commandkit_kv.db',\n  options: KvOptions = { enableWAL: true, namespace: 'commandkit_kv' },\n): KV {\n  return new KV(path, options);\n}\n"],"mappings":"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"}

package/dist/kv/serde.d.ts

@@ -1,3 +1,3 @@
-import "../constants-DrjIvQd6.js";
-import { SerializedValue, deserializer, serializer } from "../serde-BUDI03pX.js";
+import "../constants-D8PMA9on.js";
+import { SerializedValue, deserializer, serializer } from "../serde-BYaKrsOV.js";
 export { SerializedValue, deserializer, serializer };

package/dist/logger/DefaultLogger.d.ts

@@ -1,3 +1,3 @@
-import "../ILogger-DBGON5wx.js";
-import { DefaultLogger } from "../DefaultLogger-Cy55-uPl.js";
+import "../ILogger-BW8GM-YZ.js";
+import { DefaultLogger } from "../DefaultLogger-XCOl5nLd.js";
 export { DefaultLogger };

package/dist/logger/DefaultLogger.js

@@ -1,7 +1,7 @@
 require('../colors-Cd4Oz-r-.js');
 require('../ActionRow-CmTHbo2t.js');
-require('../error-codes-C-ViHyu-.js');
-const require_commandkit = require('../commandkit-DMEW0kJg.js');
+require('../error-codes-Ds0bnPvT.js');
+const require_commandkit = require('../commandkit-c0sAaK0G.js');
 require('../common-CcfjYnPG.js');
 require('../common-vnMIelAE.js');
 require('../container-z621KfH5.js');
@@ -23,11 +23,11 @@ require('../runtime-5fxB4uhe.js');
 require('../utils-BnXM4eKk.js');
 require('../resolve-file-url-DHTQj2mU.js');
 require('../types-package-DrnIdWLg.js');
-require('../EventWorkerContext-CSlD9rbx.js');
-require('../signals-DHdYrd-n.js');
-require('../constants-CUND8XkG.js');
-require('../MessageCommandParser-B_BEQ3p8.js');
-require('../CommandsRouter-Ci1Pe8Vd.js');
+require('../constants-DxfYtA6t.js');
+require('../EventWorkerContext-TZIKxVCu.js');
+require('../signals-r7qPAvOR.js');
+require('../MessageCommandParser-TPEPhjvx.js');
+require('../CommandsRouter-tMAivEfv.js');
 require('../EventsRouter-C_J0M3uO.js');
 require('../router-DHnFRADH.js');
 require('../common-DNADUU3_.js');

package/dist/logger/ILogger.d.ts

@@ -1,2 +1,2 @@
-import { ILogger } from "../ILogger-DBGON5wx.js";
+import { ILogger } from "../ILogger-BW8GM-YZ.js";
 export { ILogger };

package/dist/logger/Logger.d.ts

@@ -1,3 +1,3 @@
-import "../ILogger-DBGON5wx.js";
-import { CommandKitLoggerOptions, Logger, LoggerImpl, createLogger } from "../Logger-iSjA-DWN.js";
+import "../ILogger-BW8GM-YZ.js";
+import { CommandKitLoggerOptions, Logger, LoggerImpl, createLogger } from "../Logger-DyfkPk7u.js";
 export { CommandKitLoggerOptions, Logger, LoggerImpl, createLogger };

package/dist/logger/Logger.js

@@ -1,7 +1,7 @@
 require('../colors-Cd4Oz-r-.js');
 require('../ActionRow-CmTHbo2t.js');
-require('../error-codes-C-ViHyu-.js');
-const require_commandkit = require('../commandkit-DMEW0kJg.js');
+require('../error-codes-Ds0bnPvT.js');
+const require_commandkit = require('../commandkit-c0sAaK0G.js');
 require('../common-CcfjYnPG.js');
 require('../common-vnMIelAE.js');
 require('../container-z621KfH5.js');
@@ -23,11 +23,11 @@ require('../runtime-5fxB4uhe.js');
 require('../utils-BnXM4eKk.js');
 require('../resolve-file-url-DHTQj2mU.js');
 require('../types-package-DrnIdWLg.js');
-require('../EventWorkerContext-CSlD9rbx.js');
-require('../signals-DHdYrd-n.js');
-require('../constants-CUND8XkG.js');
-require('../MessageCommandParser-B_BEQ3p8.js');
-require('../CommandsRouter-Ci1Pe8Vd.js');
+require('../constants-DxfYtA6t.js');
+require('../EventWorkerContext-TZIKxVCu.js');
+require('../signals-r7qPAvOR.js');
+require('../MessageCommandParser-TPEPhjvx.js');
+require('../CommandsRouter-tMAivEfv.js');
 require('../EventsRouter-C_J0M3uO.js');
 require('../router-DHnFRADH.js');
 require('../common-DNADUU3_.js');

package/dist/logger/NoopLogger.d.ts

@@ -1,4 +1,4 @@
-import { ILogger } from "../ILogger-DBGON5wx.js";
+import { ILogger } from "../ILogger-BW8GM-YZ.js";
 
 //#region src/logger/NoopLogger.d.ts
 
@@ -8,29 +8,59 @@ import { ILogger } from "../ILogger-DBGON5wx.js";
 declare class NoopLogger implements ILogger {
   /**
    * Logs a debug message.
-   * @param args The message arguments to log.
+   * @param message The message to log.
    */
-  debug(...args: any[]): void;
+  debug(message: any): void;
+  /**
+   * Logs a debug message using template literals.
+   * @param strings The template literal strings.
+   * @param values The values to interpolate.
+   */
+  debug(strings: TemplateStringsArray, ...values: any[]): void;
   /**
    * Logs an error message.
-   * @param args The message arguments to log.
+   * @param message The error message to log.
    */
-  error(...args: any[]): void;
+  error(message: any): void;
+  /**
+   * Logs an error message using template literals.
+   * @param strings The template literal strings.
+   * @param values The values to interpolate.
+   */
+  error(strings: TemplateStringsArray, ...values: any[]): void;
   /**
    * Logs a default message.
-   * @param args The message arguments to log.
+   * @param message The message to log.
+   */
+  log(message: any): void;
+  /**
+   * Logs a default message using template literals.
+   * @param strings The template literal strings.
+   * @param values The values to interpolate.
    */
-  log(...args: any[]): void;
+  log(strings: TemplateStringsArray, ...values: any[]): void;
   /**
    * Logs an info message.
-   * @param args The message arguments to log.
+   * @param message The informational message to log.
+   */
+  info(message: any): void;
+  /**
+   * Logs an info message using template literals.
+   * @param strings The template literal strings.
+   * @param values The values to interpolate.
    */
-  info(...args: any[]): void;
+  info(strings: TemplateStringsArray, ...values: any[]): void;
   /**
    * Logs a warning message.
-   * @param args The message arguments to log.
+   * @param message The warning message to log.
+   */
+  warn(message: any): void;
+  /**
+   * Logs a warning message using template literals.
+   * @param strings The template literal strings.
+   * @param values The values to interpolate.
    */
-  warn(...args: any[]): void;
+  warn(strings: TemplateStringsArray, ...values: any[]): void;
 }
 //#endregion
 export { NoopLogger };

package/dist/logger/NoopLogger.js

@@ -4,31 +4,11 @@
 * Noop logger implementation that does nothing.
 */
 var NoopLogger = class {
-	/**
-	* Logs a debug message.
-	* @param args The message arguments to log.
-	*/
-	debug(...args) {}
-	/**
-	* Logs an error message.
-	* @param args The message arguments to log.
-	*/
-	error(...args) {}
-	/**
-	* Logs a default message.
-	* @param args The message arguments to log.
-	*/
-	log(...args) {}
-	/**
-	* Logs an info message.
-	* @param args The message arguments to log.
-	*/
-	info(...args) {}
-	/**
-	* Logs a warning message.
-	* @param args The message arguments to log.
-	*/
-	warn(...args) {}
+	debug(messageOrStrings, ...values) {}
+	error(messageOrStrings, ...values) {}
+	log(messageOrStrings, ...values) {}
+	info(messageOrStrings, ...values) {}
+	warn(messageOrStrings, ...values) {}
 };
 
 //#endregion

package/dist/logger/NoopLogger.js.map

@@ -1 +1 @@
-{"version":3,"file":"NoopLogger.js","names":[],"sources":["../../src/logger/NoopLogger.ts"],"sourcesContent":["import { ILogger } from './ILogger';\n\n/**\n * Noop logger implementation that does nothing.\n */\nexport class NoopLogger implements ILogger {\n  /**\n   * Logs a debug message.\n   * @param args The message arguments to log.\n   */\n  public debug(...args: any[]): void {}\n\n  /**\n   * Logs an error message.\n   * @param args The message arguments to log.\n   */\n  public error(...args: any[]): void {}\n\n  /**\n   * Logs a default message.\n   * @param args The message arguments to log.\n   */\n  public log(...args: any[]): void {}\n\n  /**\n   * Logs an info message.\n   * @param args The message arguments to log.\n   */\n  public info(...args: any[]): void {}\n\n  /**\n   * Logs a warning message.\n   * @param args The message arguments to log.\n   */\n  public warn(...args: any[]): void {}\n}\n"],"mappings":";;;;;AAKA,IAAa,aAAb,MAA2C;;;;;CAKzC,AAAO,MAAM,GAAG,MAAmB,CAAC;;;;;CAMpC,AAAO,MAAM,GAAG,MAAmB,CAAC;;;;;CAMpC,AAAO,IAAI,GAAG,MAAmB,CAAC;;;;;CAMlC,AAAO,KAAK,GAAG,MAAmB,CAAC;;;;;CAMnC,AAAO,KAAK,GAAG,MAAmB,CAAC;AACrC"}
+{"version":3,"file":"NoopLogger.js","names":[],"sources":["../../src/logger/NoopLogger.ts"],"sourcesContent":["import { ILogger } from './ILogger';\n\n/**\n * Noop logger implementation that does nothing.\n */\nexport class NoopLogger implements ILogger {\n  /**\n   * Logs a debug message.\n   * @param message The message to log.\n   */\n  public debug(message: any): void;\n  /**\n   * Logs a debug message using template literals.\n   * @param strings The template literal strings.\n   * @param values The values to interpolate.\n   */\n  public debug(strings: TemplateStringsArray, ...values: any[]): void;\n  public debug(\n    messageOrStrings: any | TemplateStringsArray,\n    ...values: any[]\n  ): void {}\n\n  /**\n   * Logs an error message.\n   * @param message The error message to log.\n   */\n  public error(message: any): void;\n  /**\n   * Logs an error message using template literals.\n   * @param strings The template literal strings.\n   * @param values The values to interpolate.\n   */\n  public error(strings: TemplateStringsArray, ...values: any[]): void;\n  public error(\n    messageOrStrings: any | TemplateStringsArray,\n    ...values: any[]\n  ): void {}\n\n  /**\n   * Logs a default message.\n   * @param message The message to log.\n   */\n  public log(message: any): void;\n  /**\n   * Logs a default message using template literals.\n   * @param strings The template literal strings.\n   * @param values The values to interpolate.\n   */\n  public log(strings: TemplateStringsArray, ...values: any[]): void;\n  public log(\n    messageOrStrings: any | TemplateStringsArray,\n    ...values: any[]\n  ): void {}\n\n  /**\n   * Logs an info message.\n   * @param message The informational message to log.\n   */\n  public info(message: any): void;\n  /**\n   * Logs an info message using template literals.\n   * @param strings The template literal strings.\n   * @param values The values to interpolate.\n   */\n  public info(strings: TemplateStringsArray, ...values: any[]): void;\n  public info(\n    messageOrStrings: any | TemplateStringsArray,\n    ...values: any[]\n  ): void {}\n\n  /**\n   * Logs a warning message.\n   * @param message The warning message to log.\n   */\n  public warn(message: any): void;\n  /**\n   * Logs a warning message using template literals.\n   * @param strings The template literal strings.\n   * @param values The values to interpolate.\n   */\n  public warn(strings: TemplateStringsArray, ...values: any[]): void;\n  public warn(\n    messageOrStrings: any | TemplateStringsArray,\n    ...values: any[]\n  ): void {}\n}\n"],"mappings":";;;;;AAKA,IAAa,aAAb,MAA2C;CAYzC,AAAO,MACP,kBACA,GAAG,QACI;CAaP,AAAO,MACP,kBACA,GAAG,QACI;CAaP,AAAO,IACP,kBACA,GAAG,QACI;CAaP,AAAO,KACP,kBACA,GAAG,QACI;CAaP,AAAO,KACP,kBACA,GAAG,QACI"}

package/dist/media-gallery-CIKypjbJ.js.map

@@ -1 +1 @@
-{"version":3,"file":"media-gallery-CIKypjbJ.js","names":[],"sources":["../src/components/v2/media-gallery.ts"],"sourcesContent":["import { MediaGalleryBuilder, MediaGalleryItemBuilder } from 'discord.js';\nimport { applyId } from './common';\n\n/**\n * Represents the properties for a media gallery component.\n */\nexport interface MediaGalleryProps {\n  id?: number;\n  children?: MediaGalleryItemBuilder[];\n}\n\n/**\n * The media gallery component\n * @param props The properties for the media gallery component.\n * @returns The media gallery builder instance.\n * @example ```tsx\n * import { MediaGallery } from 'commandkit';\n *\n * const gallery = (\n *   <MediaGallery>\n *     <MediaGalleryItem url=\"https://example.com/image1.png\" description=\"Image 1\" />\n *     <MediaGalleryItem url=\"https://example.com/image2.png\" description=\"Image 2\" />\n *   </MediaGallery>\n * );\n * ```\n */\nexport function MediaGallery(props: MediaGalleryProps) {\n  const gallery = new MediaGalleryBuilder();\n\n  applyId(props, gallery);\n\n  if (props.children != null) {\n    if (!Array.isArray(props.children)) props.children = [props.children];\n    gallery.addItems(props.children.flat());\n  }\n\n  return gallery;\n}\n\n/**\n * Represents the properties for a media gallery item component.\n */\nexport interface MediaGalleryItemProps {\n  description?: string;\n  spoiler?: boolean;\n  url?: string;\n}\n\n/**\n * The media gallery item component\n * @param props The properties for the media gallery item component.\n * @returns The media gallery item builder instance.\n * @example ```tsx\n * import { MediaGalleryItem } from 'commandkit';\n *\n * const item = <MediaGalleryItem url=\"https://example.com/image.png\" description=\"An image\" />;\n * ```\n */\nexport function MediaGalleryItem(props: MediaGalleryItemProps) {\n  const item = new MediaGalleryItemBuilder();\n\n  if (props.description != null) {\n    item.setDescription(props.description);\n  }\n\n  if (props.spoiler != null) {\n    item.setSpoiler(props.spoiler);\n  }\n\n  if (props.url != null) {\n    item.setURL(props.url);\n  }\n\n  return item;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AA0BA,SAAgB,aAAa,OAA0B;CACrD,MAAM,UAAU,IAAI;AAEpB,wBAAQ,OAAO;AAEf,KAAI,MAAM,YAAY,MAAM;AAC1B,MAAI,CAAC,MAAM,QAAQ,MAAM,UAAW,OAAM,WAAW,CAAC,MAAM,SAAS;AACrE,UAAQ,SAAS,MAAM,SAAS;CAClC;AAEA,QAAO;AACT;;;;;;;;;;;AAqBA,SAAgB,iBAAiB,OAA8B;CAC7D,MAAM,OAAO,IAAI;AAEjB,KAAI,MAAM,eAAe,KACvB,MAAK,eAAe,MAAM;AAG5B,KAAI,MAAM,WAAW,KACnB,MAAK,WAAW,MAAM;AAGxB,KAAI,MAAM,OAAO,KACf,MAAK,OAAO,MAAM;AAGpB,QAAO;AACT"}
+{"version":3,"file":"media-gallery-CIKypjbJ.js","names":[],"sources":["../src/components/v2/media-gallery.ts"],"sourcesContent":["import { MediaGalleryBuilder, MediaGalleryItemBuilder } from 'discord.js';\nimport { applyId } from './common';\n\n/**\n * Represents the properties for a media gallery component.\n */\nexport interface MediaGalleryProps {\n  id?: number;\n  children?: MediaGalleryItemBuilder[];\n}\n\n/**\n * The media gallery component\n * @param props The properties for the media gallery component.\n * @returns The media gallery builder instance.\n * @example ```tsx\n * import { MediaGallery } from 'commandkit';\n *\n * const gallery = (\n *   <MediaGallery>\n *     <MediaGalleryItem url=\"https://example.com/image1.png\" description=\"Image 1\" />\n *     <MediaGalleryItem url=\"https://example.com/image2.png\" description=\"Image 2\" />\n *   </MediaGallery>\n * );\n * ```\n */\nexport function MediaGallery(props: MediaGalleryProps) {\n  const gallery = new MediaGalleryBuilder();\n\n  applyId(props, gallery);\n\n  if (props.children != null) {\n    if (!Array.isArray(props.children)) props.children = [props.children];\n    gallery.addItems(props.children.flat());\n  }\n\n  return gallery;\n}\n\n/**\n * Represents the properties for a media gallery item component.\n */\nexport interface MediaGalleryItemProps {\n  description?: string;\n  spoiler?: boolean;\n  url?: string;\n}\n\n/**\n * The media gallery item component\n * @param props The properties for the media gallery item component.\n * @returns The media gallery item builder instance.\n * @example ```tsx\n * import { MediaGalleryItem } from 'commandkit';\n *\n * const item = <MediaGalleryItem url=\"https://example.com/image.png\" description=\"An image\" />;\n * ```\n */\nexport function MediaGalleryItem(props: MediaGalleryItemProps) {\n  const item = new MediaGalleryItemBuilder();\n\n  if (props.description != null) {\n    item.setDescription(props.description);\n  }\n\n  if (props.spoiler != null) {\n    item.setSpoiler(props.spoiler);\n  }\n\n  if (props.url != null) {\n    item.setURL(props.url);\n  }\n\n  return item;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AA0BA,SAAgB,aAAa,OAA0B;CACrD,MAAM,UAAU,IAAI;AAEpB,wBAAQ,OAAO;AAEf,KAAI,MAAM,YAAY,MAAM;AAC1B,MAAI,CAAC,MAAM,QAAQ,MAAM,UAAW,OAAM,WAAW,CAAC,MAAM;AAC5D,UAAQ,SAAS,MAAM,SAAS;;AAGlC,QAAO;;;;;;;;;;;;AAsBT,SAAgB,iBAAiB,OAA8B;CAC7D,MAAM,OAAO,IAAI;AAEjB,KAAI,MAAM,eAAe,KACvB,MAAK,eAAe,MAAM;AAG5B,KAAI,MAAM,WAAW,KACnB,MAAK,WAAW,MAAM;AAGxB,KAAI,MAAM,OAAO,KACf,MAAK,OAAO,MAAM;AAGpB,QAAO"}

package/dist/plugins/CompilerPlugin.d.ts

@@ -1,4 +1,4 @@
-import { CompilerPlugin, PluginTransformParameters, TransformedResult, isCompilerPlugin } from "../analytics-engine-vA4MaJYx.js";
+import { CompilerPlugin, PluginTransformParameters, TransformedResult, isCompilerPlugin } from "../analytics-engine-Iu_1uJop.js";
 import "../EventInterceptor-x-R2qshQ.js";
 import "../ButtonKit-C7r7RPNf.js";
 import "../ModalKit-Btz58KYn.js";
@@ -23,7 +23,7 @@ import "../text-display-DRw3r_lK.js";
 import "../index-DSBMRX9A.js";
 import "../index-DdqikUQD.js";
 import "../MessageCommandParser-ROLibZPX.js";
-import "../signals-BQbEfy3X.js";
+import "../signals-SHg7J1U_.js";
 import "../helpers-Wg6P5fRQ.js";
 import "../CommandsRouter-CoOA7hkf.js";
 import "../EventsRouter-BacqK6z3.js";

package/dist/plugins/PluginCommon.d.ts

@@ -1,4 +1,4 @@
-import { PluginCommon, PluginOptions, PluginType, isPlugin } from "../analytics-engine-vA4MaJYx.js";
+import { PluginCommon, PluginOptions, PluginType, isPlugin } from "../analytics-engine-Iu_1uJop.js";
 import "../EventInterceptor-x-R2qshQ.js";
 import "../ButtonKit-C7r7RPNf.js";
 import "../ModalKit-Btz58KYn.js";
@@ -23,7 +23,7 @@ import "../text-display-DRw3r_lK.js";
 import "../index-DSBMRX9A.js";
 import "../index-DdqikUQD.js";
 import "../MessageCommandParser-ROLibZPX.js";
-import "../signals-BQbEfy3X.js";
+import "../signals-SHg7J1U_.js";
 import "../helpers-Wg6P5fRQ.js";
 import "../CommandsRouter-CoOA7hkf.js";
 import "../EventsRouter-BacqK6z3.js";

package/dist/plugins/RuntimePlugin.d.ts

@@ -1,4 +1,4 @@
-import { RuntimePlugin, isRuntimePlugin } from "../analytics-engine-vA4MaJYx.js";
+import { RuntimePlugin, isRuntimePlugin } from "../analytics-engine-Iu_1uJop.js";
 import "../EventInterceptor-x-R2qshQ.js";
 import "../ButtonKit-C7r7RPNf.js";
 import "../ModalKit-Btz58KYn.js";
@@ -23,7 +23,7 @@ import "../text-display-DRw3r_lK.js";
 import "../index-DSBMRX9A.js";
 import "../index-DdqikUQD.js";
 import "../MessageCommandParser-ROLibZPX.js";
-import "../signals-BQbEfy3X.js";
+import "../signals-SHg7J1U_.js";
 import "../helpers-Wg6P5fRQ.js";
 import "../CommandsRouter-CoOA7hkf.js";
 import "../EventsRouter-BacqK6z3.js";

package/dist/plugins/index.d.ts

@@ -1,4 +1,4 @@
-import { CommandKitEventDispatch, CommandKitPlugin, CommandKitPluginRuntime, CommonDirectiveTransformer, CommonDirectiveTransformerOptions, CommonPluginRuntime, CompilerPlugin, CompilerPluginRuntime, MaybeFalsey, PluginTransformParameters, RuntimePlugin, TemplateHandler, TransformedResult, isCompilerPlugin, isRuntimePlugin } from "../analytics-engine-vA4MaJYx.js";
+import { CommandKitEventDispatch, CommandKitPlugin, CommandKitPluginRuntime, CommonDirectiveTransformer, CommonDirectiveTransformerOptions, CommonPluginRuntime, CompilerPlugin, CompilerPluginRuntime, MaybeFalsey, PluginTransformParameters, RuntimePlugin, TemplateHandler, TransformedResult, isCompilerPlugin, isRuntimePlugin } from "../analytics-engine-Iu_1uJop.js";
 import "../EventInterceptor-x-R2qshQ.js";
 import "../ButtonKit-C7r7RPNf.js";
 import "../ModalKit-Btz58KYn.js";
@@ -23,7 +23,7 @@ import "../text-display-DRw3r_lK.js";
 import "../index-DSBMRX9A.js";
 import "../index-DdqikUQD.js";
 import "../MessageCommandParser-ROLibZPX.js";
-import "../signals-BQbEfy3X.js";
+import "../signals-SHg7J1U_.js";
 import "../helpers-Wg6P5fRQ.js";
 import "../CommandsRouter-CoOA7hkf.js";
 import "../EventsRouter-BacqK6z3.js";