@wolfstar/kit 0.1.0

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2022 Wolfstar Project
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,81 @@
+# @wolfstar/kit
+
+`defineModule` and the module runtime for installable Stars modules — the `@nuxt/kit` counterpart. A module is a
+package that says it is one; the project lists it in `modules` in `stars.config`:
+
+```ts
+// stars.config.ts
+import { defineConfig } from '@wolfstar/http-framework/config';
+
+export default defineConfig({
+	modules: ['@wolfstar/plugin-cache', ['@wolfstar/plugin-gateway', { shards: 2 }]]
+});
+```
+
+```ts
+// the module's package: its default export
+import { defineModule } from '@wolfstar/kit';
+
+export default defineModule<{ ttl: number }>({
+	meta: {
+		name: '@wolfstar/plugin-cache',
+		compatibility: { framework: '>=6.1.0' }
+	},
+	defaults: { ttl: 60_000 },
+	hooks: {
+		'build:done': (outcome) => {}
+	},
+	setup(options, ctx) {
+		ctx.addPlugin({ from: new URL('./plugin.js', import.meta.url), options });
+		ctx.addImports('@wolfstar/plugin-cache');
+	}
+});
+```
+
+```ts
+// plugin.js — runs in the bot
+import { definePlugin } from '@wolfstar/http-framework';
+
+export default definePlugin((options) => ({
+	name: '@wolfstar/plugin-cache',
+	preLoad(client) {}
+}));
+```
+
+`@wolfstar/kit` depends on `@wolfstar/schema` only, so a module depends on it (as a peer) without pulling in the
+framework or the CLI.
+
+## What `setup` can do
+
+`setup(options, ctx)` runs once, in the CLI process, while the project loads. `options` is the module's `defaults`
+merged under the ones written in `stars.config` (plain objects merge deeply, arrays are replaced).
+
+- `ctx.addPlugin(source)` registers a runtime plugin. The plugin lives in the bot's process and `setup` in the CLI's,
+  so a plugin is given by **source** — `{ from, export?, options? }` — rather than by value. `from` is a package
+  specifier, an absolute path or a `file:` URL (a relative path is rejected: it would resolve differently in each
+  build tool); the `export` (default `'default'`) is the plugin or, when it is a function, a factory called with
+  `options`, which must be JSON-serialisable. A legacy `Plugin` class is registered as it is, never called.
+- `ctx.addImports(preset)` adds a package to the auto imports presets.
+- `ctx.hook(name, callback)` / `ctx.callHook(name, …)` use the CLI's hooks (`StarsHooks`), the same registry as `hooks`
+  in `stars.config`. A module's `hooks` are registered before `setup` runs; an unknown hook name or a value that is not
+  a function fails the install.
+- `ctx.installModule(module, options?)` installs another module, and `dependencies` installs modules first. A module
+  is installed once, by `meta.name`: the first installation wins.
+
+`meta.compatibility` (`framework`, `stars`) is a semver range checked against the project's installed
+`@wolfstar/http-framework` and the running `@wolfstar/cli`; a mismatch fails early instead of leaving a plugin that
+silently never runs. `meta.configKey` is reserved.
+
+## Production with `tsc` or `none`
+
+`tsdown`, `vite` and Nitro builds register the runtime plugins through the entry. `tsc` and `none` builds cannot be
+transformed: `stars dev` preloads the plugins with `node --import`, and for production `stars prepare` (and
+`stars build`) writes `.stars/modules.mjs`, to be preloaded the same way: `node --import ./.stars/modules.mjs dist/main.js`.
+`stars build`, `stars prepare` and `stars info` report a warning (`MODULES_PRELOAD_REQUIRED`) when such a project has modules with runtime plugins; `stars dev` does not print it, since it preloads them itself. With `env` enabled, `modules.mjs` imports `.stars/env.mjs` first, so the environment is loaded before any plugin is evaluated.
+
+## Programmatic usage
+
+`setupModules({ config, hooks, load, versions })` is what the CLI calls: `load` imports a specifier from the project,
+`hooks` is a `hookable`-shaped registry, and the result (`ModulesRuntime`) lists the installed modules, the runtime
+plugins and the import presets they contributed. Failures are `ModuleError`s with a `code` (`MODULE_LOAD_FAILED`,
+`MODULE_INVALID`, `MODULE_INCOMPATIBLE`, `MODULE_SETUP_FAILED`, `MODULE_PLUGIN_INVALID`) and the `moduleName`.

package/dist/esm/index.d.ts

@@ -0,0 +1,136 @@
+import { InstalledModule, ModulesRuntime, ModulesRuntime as ModulesRuntime$1, ResolvedStarsConfig, RuntimePluginRegistration, StarsHookName, StarsHooks } from "@wolfstar/schema";
+//#region src/types.d.ts
+type Awaitable<T> = T | PromiseLike<T>;
+/** The options a module declares, merged from its `defaults` and the ones written in `stars.config`. */
+type ModuleOptions = Record<string, any>;
+interface ModuleMeta {
+  /** The module's identity, used to install it once, to attribute errors and to report it. Usually the package name. */
+  name: string;
+  version?: string;
+  /** Reserved for reading the module's options from a `stars.config` key of this name. */
+  configKey?: string;
+  /** Version ranges the module works with. A range is only checked when the host knows the version. */
+  compatibility?: {
+    /** A range for the project's installed `@wolfstar/http-framework`. */
+    framework?: string;
+    /** A range for the running `@wolfstar/cli`. */
+    stars?: string;
+  };
+}
+/** What the host knows about the project: `null` when a version could not be found. */
+interface ModuleVersions {
+  framework?: string | null;
+  stars?: string | null;
+}
+/**
+ * The hook registry of the host. The CLI hands over its `hookable` instance, so a module's hooks, `stars.config`'s
+ * `hooks` and the CLI's own `callHook` calls all share one registry.
+ */
+interface ModuleHookHost {
+  hook<Name extends StarsHookName>(name: Name, callback: StarsHooks[Name]): unknown;
+  callHook<Name extends StarsHookName>(name: Name, ...args: Parameters<StarsHooks[Name]>): Awaitable<unknown>;
+}
+/**
+ * A runtime plugin to register with `Client.use`. It is given by source: the plugin lives in the bot's process, the
+ * module's `setup` in the CLI's. The `export` of `from` is the plugin (`definePlugin({ … })`) or, when it is a
+ * function, a factory called with `options` (`definePlugin((options) => ({ … }))`). A legacy `Plugin` class is
+ * passed to `Client.use` as it is, never called.
+ */
+interface ModulePluginSource {
+  /**
+   * A package specifier (resolved from the project), an absolute path or a `file:` URL, e.g. `new URL('./plugin.js',
+   * import.meta.url)`. A relative path is rejected: it would resolve differently in each build tool.
+   */
+  from: string | URL;
+  /** @default 'default' */
+  export?: string;
+  /** Must be JSON-serialisable: it is written into the built entry. */
+  options?: unknown;
+}
+/** A module to install: its specifier, or its definition, optionally with options. */
+type ModuleInput<Options extends ModuleOptions = ModuleOptions> = string | StarsModule<Options>;
+interface ModuleContext {
+  /** Absolute project root. */
+  readonly root: string;
+  /** The resolved `stars.config`, before any module contributed. */
+  readonly config: ResolvedStarsConfig;
+  readonly versions: Readonly<ModuleVersions>;
+  /** Registers a runtime plugin. See {@link ModulePluginSource}. */
+  addPlugin(plugin: string | URL | ModulePluginSource): void;
+  /** Adds a package to the auto imports presets (`imports.presets`): all its exports become auto imports. */
+  addImports(preset: string | {
+    from: string;
+  }): void;
+  /** Registers a hook of the `stars` CLI. */
+  hook: ModuleHookHost['hook'];
+  /** Calls a hook of the `stars` CLI. */
+  callHook: ModuleHookHost['callHook'];
+  /** Installs another module, once: a module that is already installed is left as it is, whatever options it got. */
+  installModule<Options extends ModuleOptions>(module: ModuleInput<Options>, options?: Partial<Options>): Promise<void>;
+}
+interface StarsModule<Options extends ModuleOptions = ModuleOptions> {
+  meta: ModuleMeta;
+  /** Merged under the options written in `stars.config`. */
+  defaults?: Options;
+  /** Modules installed before this one. */
+  dependencies?: readonly ModuleInput[];
+  /** Hooks of the `stars` CLI, registered before `setup` runs. An unknown hook name or a value that is not a function is rejected. */
+  hooks?: { [Name in StarsHookName]?: StarsHooks[Name]; };
+  /** Runs in the CLI process, once, while the project loads. */
+  setup?(options: Options, ctx: ModuleContext): Awaitable<void>;
+}
+type ModuleErrorCode = 'MODULE_LOAD_FAILED' | 'MODULE_INVALID' | 'MODULE_INCOMPATIBLE' | 'MODULE_SETUP_FAILED' | 'MODULE_PLUGIN_INVALID';
+//#endregion
+//#region src/define.d.ts
+/**
+ * Defines an installable module. This is an identity helper that types the definition; the module is installed by
+ * listing its package in `modules` in `stars.config`.
+ *
+ * @example
+ * ```ts
+ * import { defineModule } from '@wolfstar/kit';
+ *
+ * export default defineModule<{ ttl: number }>({
+ * 	meta: { name: '@wolfstar/plugin-cache', compatibility: { framework: '>=6.1.0' } },
+ * 	defaults: { ttl: 60_000 },
+ * 	setup(options, ctx) {
+ * 		ctx.addPlugin({ from: new URL('./plugin.js', import.meta.url), options });
+ * 		ctx.addImports('@wolfstar/plugin-cache');
+ * 	}
+ * });
+ * ```
+ */
+export declare function defineModule<Options extends ModuleOptions = ModuleOptions>(module: StarsModule<Options>): StarsModule<Options>;
+//#endregion
+//#region src/errors.d.ts
+/** Why a module could not be installed. `moduleName` is the module's `meta.name`, or the specifier it was listed by. */
+export declare class ModuleError extends Error {
+  readonly code: ModuleErrorCode;
+  readonly moduleName: string;
+  constructor(code: ModuleErrorCode, moduleName: string, message: string, cause?: unknown);
+}
+//#endregion
+//#region src/options.d.ts
+/**
+ * Merges `options` over `defaults`: plain objects merge deeply, everything else (arrays included) is replaced, and an
+ * `undefined` value in `options` keeps the default.
+ */
+export declare function mergeOptions<T extends Record<string, unknown>>(defaults: T | undefined, options: Record<string, unknown> | undefined): T;
+//#endregion
+//#region src/setup.d.ts
+interface SetupModulesOptions {
+  /** The resolved configuration: `root` and `modules` are read from it. */
+  config: ResolvedStarsConfig;
+  hooks: ModuleHookHost;
+  /** Imports a module specifier from the project. Its default export (or the namespace itself) is the module. */
+  load(specifier: string): Promise<unknown>;
+  versions?: ModuleVersions;
+}
+/**
+ * Installs the modules listed in `config.modules`, in order and each dependency first, and returns what they
+ * contributed. A module that is already installed (by `meta.name`) is skipped.
+ */
+export declare function setupModules(options: SetupModulesOptions): Promise<ModulesRuntime$1>;
+//#endregion
+export type { InstalledModule, ModuleContext, ModuleErrorCode, ModuleHookHost, ModuleInput, ModuleMeta, ModuleOptions, ModulePluginSource, ModuleVersions, ModulesRuntime, RuntimePluginRegistration, SetupModulesOptions, StarsModule };
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":["ModulesRuntime"],"sources":["../../src/types.ts","../../src/define.ts","../../src/errors.ts","../../src/options.ts","../../src/setup.ts"],"mappings":";;KAEK,UAAU,KAAK,IAAI,YAAY;;KAGxB,gBAAgB;UAEX;;EAEhB;EACA;;EAEA;;EAEA;;IAEC;;IAEA;;;;UAKe;EAChB;EACA;;;;;;UAOgB;EAChB,KAAK,aAAa,eAAe,MAAM,MAAM,UAAU,WAAW;EAClE,SAAS,aAAa,eAAe,MAAM,SAAS,MAAM,WAAW,WAAW,SAAS;;;;;;;;UASzE;;;;;EAKhB,eAAe;;EAEf;;EAEA;;;KAIW,YAAY,gBAAgB,gBAAgB,0BAA0B,YAAY;UAE7E;;WAEP;;WAEA,QAAQ;WACR,UAAU,SAAS;;EAE5B,UAAU,iBAAiB,MAAM;;EAEjC,WAAW;IAAmB;;;EAE9B,MAAM;;EAEN,UAAU;;EAEV,cAAc,gBAAgB,eAAe,QAAQ,YAAY,UAAU,UAAU,QAAQ,WAAW;;UAGxF,YAAY,gBAAgB,gBAAgB;EAC5D,MAAM;;EAEN,WAAW;;EAEX,wBAAwB;;EAExB,WAAW,QAAQ,iBAAiB,WAAW;;EAE/C,OAAO,SAAS,SAAS,KAAK,gBAAgB;;KAGnC;;;;;;;;;;;;;;;;;;;;;wBCpEI,aAAa,gBAAgB,gBAAgB,eAAe,QAAQ,YAAY,WAAW,YAAY;;;;qBCjB1G,oBAAoB;WAChB,MAAM;WACN;EAEhB,YAAmB,MAAM,iBAAiB,oBAAoB,iBAAiB;;;;;;;;wBCChE,aAAa,UAAU,yBAAyB,UAAU,eAAe,SAAS,sCAAsC;;;UCKvH;;EAEhB,QAAQ;EACR,OAAO;;EAEP,KAAK,oBAAoB;EACzB,WAAW;;;;;;wBAOU,aAAa,SAAS,sBAAsB,QAAQA"}

package/dist/esm/index.js

@@ -0,0 +1,215 @@
+import { STARS_HOOK_NAMES } from "@wolfstar/schema";
+import { satisfies } from "semver";
+import { fileURLToPath } from "node:url";
+
+//#region src/define.ts
+/**
+* Defines an installable module. This is an identity helper that types the definition; the module is installed by
+* listing its package in `modules` in `stars.config`.
+*
+* @example
+* ```ts
+* import { defineModule } from '@wolfstar/kit';
+*
+* export default defineModule<{ ttl: number }>({
+* 	meta: { name: '@wolfstar/plugin-cache', compatibility: { framework: '>=6.1.0' } },
+* 	defaults: { ttl: 60_000 },
+* 	setup(options, ctx) {
+* 		ctx.addPlugin({ from: new URL('./plugin.js', import.meta.url), options });
+* 		ctx.addImports('@wolfstar/plugin-cache');
+* 	}
+* });
+* ```
+*/
+function defineModule(module) {
+	return module;
+}
+
+//#endregion
+//#region \0@oxc-project+runtime@0.151.0/helpers/esm/typeof.js
+function _typeof(o) {
+	"@babel/helpers - typeof";
+	return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function(o) {
+		return typeof o;
+	} : function(o) {
+		return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o;
+	}, _typeof(o);
+}
+
+//#endregion
+//#region \0@oxc-project+runtime@0.151.0/helpers/esm/toPrimitive.js
+function toPrimitive(t, r) {
+	if ("object" != _typeof(t) || !t) return t;
+	var e = t[Symbol.toPrimitive];
+	if (void 0 !== e) {
+		var i = e.call(t, r || "default");
+		if ("object" != _typeof(i)) return i;
+		throw new TypeError("@@toPrimitive must return a primitive value.");
+	}
+	return ("string" === r ? String : Number)(t);
+}
+
+//#endregion
+//#region \0@oxc-project+runtime@0.151.0/helpers/esm/toPropertyKey.js
+function toPropertyKey(t) {
+	var i = toPrimitive(t, "string");
+	return "symbol" == _typeof(i) ? i : i + "";
+}
+
+//#endregion
+//#region \0@oxc-project+runtime@0.151.0/helpers/esm/defineProperty.js
+function _defineProperty(e, r, t) {
+	return (r = toPropertyKey(r)) in e ? Object.defineProperty(e, r, {
+		value: t,
+		enumerable: !0,
+		configurable: !0,
+		writable: !0
+	}) : e[r] = t, e;
+}
+
+//#endregion
+//#region src/errors.ts
+/** Why a module could not be installed. `moduleName` is the module's `meta.name`, or the specifier it was listed by. */
+var ModuleError = class extends Error {
+	constructor(code, moduleName, message, cause) {
+		super(message, cause === void 0 ? void 0 : { cause });
+		_defineProperty(this, "code", void 0);
+		_defineProperty(this, "moduleName", void 0);
+		this.name = "ModuleError";
+		this.code = code;
+		this.moduleName = moduleName;
+	}
+};
+
+//#endregion
+//#region src/options.ts
+function isPlainObject(value) {
+	return value !== null && typeof value === "object" && !Array.isArray(value) && Object.getPrototypeOf(value) === Object.prototype;
+}
+/**
+* Merges `options` over `defaults`: plain objects merge deeply, everything else (arrays included) is replaced, and an
+* `undefined` value in `options` keeps the default.
+*/
+function mergeOptions(defaults, options) {
+	const merged = { ...defaults };
+	for (const [key, value] of Object.entries(options ?? {})) {
+		if (value === void 0) continue;
+		const base = merged[key];
+		merged[key] = isPlainObject(base) && isPlainObject(value) ? mergeOptions(base, value) : value;
+	}
+	return merged;
+}
+
+//#endregion
+//#region src/setup.ts
+/**
+* Installs the modules listed in `config.modules`, in order and each dependency first, and returns what they
+* contributed. A module that is already installed (by `meta.name`) is skipped.
+*/
+async function setupModules(options) {
+	const { config, hooks, load, versions = {} } = options;
+	const installed = /* @__PURE__ */ new Set();
+	const modules = [];
+	const plugins = [];
+	const imports = /* @__PURE__ */ new Set();
+	async function resolveModule(input) {
+		if (typeof input !== "string") return validate(input, input.meta?.name ?? "(inline)");
+		let loaded;
+		try {
+			loaded = await load(input);
+		} catch (error) {
+			throw new ModuleError("MODULE_LOAD_FAILED", input, `The module "${input}" could not be loaded: ${message(error)}`, error);
+		}
+		const exported = loaded?.default ?? loaded;
+		return validate(exported?.default ?? exported, input);
+	}
+	async function install(input, userOptions) {
+		const module = await resolveModule(input);
+		const { name } = module.meta;
+		if (installed.has(name)) return;
+		installed.add(name);
+		checkCompatibility(module, versions);
+		for (const dependency of module.dependencies ?? []) await install(dependency, void 0);
+		for (const [hook, callback] of Object.entries(module.hooks ?? {})) {
+			if (!KNOWN_HOOKS.has(hook) || typeof callback !== "function") throw new ModuleError("MODULE_INVALID", name, KNOWN_HOOKS.has(hook) ? `The hook "${hook}" of the module "${name}" must be a function.` : `The module "${name}" declares an unknown hook "${hook}". Known hooks: ${STARS_HOOK_NAMES.join(", ")}.`);
+			hooks.hook(hook, callback);
+		}
+		const installedModule = module.meta.version === void 0 ? { name } : {
+			name,
+			version: module.meta.version
+		};
+		const context = {
+			root: config.root,
+			config,
+			versions,
+			addPlugin: (plugin) => plugins.push(toRegistration(name, plugin)),
+			addImports: (preset) => void imports.add(typeof preset === "string" ? preset : preset.from),
+			hook: (hookName, callback) => hooks.hook(hookName, callback),
+			callHook: (hookName, ...args) => hooks.callHook(hookName, ...args),
+			installModule: (nested, nestedOptions) => install(nested, nestedOptions)
+		};
+		try {
+			await module.setup?.(mergeOptions(module.defaults, userOptions), context);
+		} catch (error) {
+			if (error instanceof ModuleError) throw error;
+			throw new ModuleError("MODULE_SETUP_FAILED", name, `The module "${name}" failed during setup: ${message(error)}`, error);
+		}
+		modules.push(installedModule);
+	}
+	for (const entry of config.modules) await install(entry.specifier, entry.options);
+	return {
+		modules,
+		plugins,
+		imports: [...imports]
+	};
+}
+const KNOWN_HOOKS = new Set(STARS_HOOK_NAMES);
+function validate(value, label) {
+	const module = value;
+	if (module === null || typeof module !== "object" || typeof module.meta?.name !== "string" || module.meta.name === "") throw new ModuleError("MODULE_INVALID", label, `"${label}" is not a Stars module: its default export must be created with \`defineModule\` and have a \`meta.name\`.`);
+	if (module.setup !== void 0 && typeof module.setup !== "function") throw new ModuleError("MODULE_INVALID", module.meta.name, `The \`setup\` of the module "${module.meta.name}" must be a function.`);
+	return module;
+}
+function checkCompatibility(module, versions) {
+	const { name, compatibility } = module.meta;
+	for (const [key, label] of [["framework", "@wolfstar/http-framework"], ["stars", "@wolfstar/cli"]]) {
+		const range = compatibility?.[key];
+		const version = versions[key];
+		if (range === void 0 || version === void 0 || version === null) continue;
+		if (!satisfies(version, range, { includePrerelease: true })) throw new ModuleError("MODULE_INCOMPATIBLE", name, `The module "${name}" needs ${label} ${range}, but ${version} is installed.`);
+	}
+}
+const RELATIVE_PATH = /^\.\.?(?:[/\\]|$)/;
+function toRegistration(moduleName, plugin) {
+	const source = typeof plugin === "string" || plugin instanceof URL ? { from: plugin } : plugin;
+	const from = typeof source.from === "string" ? source.from : source.from?.href;
+	if (typeof from !== "string" || from === "") throw new ModuleError("MODULE_PLUGIN_INVALID", moduleName, `A plugin added by "${moduleName}" needs a \`from\` specifier, path or URL.`);
+	if (RELATIVE_PATH.test(from)) throw new ModuleError("MODULE_PLUGIN_INVALID", moduleName, `The plugin "${from}" added by "${moduleName}" is a relative path, which would resolve differently per build tool. Use a package specifier, an absolute path or a \`file:\` URL, e.g. \`new URL('./plugin.js', import.meta.url)\`.`);
+	if (source.options !== void 0 && !isJsonSerialisable(source.options)) throw new ModuleError("MODULE_PLUGIN_INVALID", moduleName, `The options of a plugin added by "${moduleName}" must be JSON-serialisable: they are written into the built entry.`);
+	const registration = {
+		module: moduleName,
+		from: from.startsWith("file:") ? fileURLToPath(from) : from,
+		export: source.export ?? "default"
+	};
+	return source.options === void 0 ? registration : {
+		...registration,
+		options: source.options
+	};
+}
+function isJsonSerialisable(value) {
+	try {
+		return JSON.stringify(value, (_key, item) => {
+			if (typeof item === "function" || typeof item === "symbol" || typeof item === "bigint") throw new TypeError("not serialisable");
+			return item;
+		}) !== void 0;
+	} catch {
+		return false;
+	}
+}
+function message(error) {
+	return error instanceof Error ? error.message : String(error);
+}
+
+//#endregion
+export { ModuleError, defineModule, mergeOptions, setupModules };
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/define.ts","../../src/errors.ts","../../src/options.ts","../../src/setup.ts"],"sourcesContent":["import type { ModuleOptions, StarsModule } from './types.js';\r\n\r\n/**\r\n * Defines an installable module. This is an identity helper that types the definition; the module is installed by\r\n * listing its package in `modules` in `stars.config`.\r\n *\r\n * @example\r\n * ```ts\r\n * import { defineModule } from '@wolfstar/kit';\r\n *\r\n * export default defineModule<{ ttl: number }>({\r\n * \tmeta: { name: '@wolfstar/plugin-cache', compatibility: { framework: '>=6.1.0' } },\r\n * \tdefaults: { ttl: 60_000 },\r\n * \tsetup(options, ctx) {\r\n * \t\tctx.addPlugin({ from: new URL('./plugin.js', import.meta.url), options });\r\n * \t\tctx.addImports('@wolfstar/plugin-cache');\r\n * \t}\r\n * });\r\n * ```\r\n */\r\nexport function defineModule<Options extends ModuleOptions = ModuleOptions>(module: StarsModule<Options>): StarsModule<Options> {\r\n\treturn module;\r\n}\r\n","import type { ModuleErrorCode } from './types.js';\r\n\r\n/** Why a module could not be installed. `moduleName` is the module's `meta.name`, or the specifier it was listed by. */\r\nexport class ModuleError extends Error {\r\n\tpublic readonly code: ModuleErrorCode;\r\n\tpublic readonly moduleName: string;\r\n\r\n\tpublic constructor(code: ModuleErrorCode, moduleName: string, message: string, cause?: unknown) {\r\n\t\tsuper(message, cause === undefined ? undefined : { cause });\r\n\t\tthis.name = 'ModuleError';\r\n\t\tthis.code = code;\r\n\t\tthis.moduleName = moduleName;\r\n\t}\r\n}\r\n","function isPlainObject(value: unknown): value is Record<string, unknown> {\r\n\treturn value !== null && typeof value === 'object' && !Array.isArray(value) && Object.getPrototypeOf(value) === Object.prototype;\r\n}\r\n\r\n/**\r\n * Merges `options` over `defaults`: plain objects merge deeply, everything else (arrays included) is replaced, and an\r\n * `undefined` value in `options` keeps the default.\r\n */\r\nexport function mergeOptions<T extends Record<string, unknown>>(defaults: T | undefined, options: Record<string, unknown> | undefined): T {\r\n\tconst merged: Record<string, unknown> = { ...defaults };\r\n\tfor (const [key, value] of Object.entries(options ?? {})) {\r\n\t\tif (value === undefined) continue;\r\n\t\tconst base = merged[key];\r\n\t\tmerged[key] = isPlainObject(base) && isPlainObject(value) ? mergeOptions(base, value) : value;\r\n\t}\r\n\r\n\treturn merged as T;\r\n}\r\n","import {\r\n\tSTARS_HOOK_NAMES,\r\n\ttype InstalledModule,\r\n\ttype ModulesRuntime,\r\n\ttype ResolvedStarsConfig,\r\n\ttype RuntimePluginRegistration\r\n} from '@wolfstar/schema';\r\nimport { satisfies } from 'semver';\r\nimport { fileURLToPath } from 'node:url';\r\nimport { ModuleError } from './errors.js';\r\nimport { mergeOptions } from './options.js';\r\nimport type { ModuleContext, ModuleHookHost, ModuleInput, ModuleOptions, ModulePluginSource, ModuleVersions, StarsModule } from './types.js';\r\n\r\nexport interface SetupModulesOptions {\r\n\t/** The resolved configuration: `root` and `modules` are read from it. */\r\n\tconfig: ResolvedStarsConfig;\r\n\thooks: ModuleHookHost;\r\n\t/** Imports a module specifier from the project. Its default export (or the namespace itself) is the module. */\r\n\tload(specifier: string): Promise<unknown>;\r\n\tversions?: ModuleVersions;\r\n}\r\n\r\n/**\r\n * Installs the modules listed in `config.modules`, in order and each dependency first, and returns what they\r\n * contributed. A module that is already installed (by `meta.name`) is skipped.\r\n */\r\nexport async function setupModules(options: SetupModulesOptions): Promise<ModulesRuntime> {\r\n\tconst { config, hooks, load, versions = {} } = options;\r\n\tconst installed = new Set<string>();\r\n\tconst modules: InstalledModule[] = [];\r\n\tconst plugins: RuntimePluginRegistration[] = [];\r\n\tconst imports = new Set<string>();\r\n\r\n\tasync function resolveModule(input: ModuleInput): Promise<StarsModule> {\r\n\t\tif (typeof input !== 'string') return validate(input, input.meta?.name ?? '(inline)');\r\n\r\n\t\tlet loaded: unknown;\r\n\t\ttry {\r\n\t\t\tloaded = await load(input);\r\n\t\t} catch (error) {\r\n\t\t\tthrow new ModuleError('MODULE_LOAD_FAILED', input, `The module \"${input}\" could not be loaded: ${message(error)}`, error);\r\n\t\t}\r\n\r\n\t\tconst exported = (loaded as { default?: unknown } | null)?.default ?? loaded;\r\n\t\t// A CommonJS package imported from ESM nests its `exports.default` under `default`.\r\n\t\tconst unwrapped = (exported as { default?: unknown } | null)?.default ?? exported;\r\n\t\treturn validate(unwrapped, input);\r\n\t}\r\n\r\n\tasync function install(input: ModuleInput, userOptions: Record<string, unknown> | undefined): Promise<void> {\r\n\t\tconst module = await resolveModule(input);\r\n\t\tconst { name } = module.meta;\r\n\t\tif (installed.has(name)) return;\r\n\t\tinstalled.add(name);\r\n\r\n\t\tcheckCompatibility(module, versions);\r\n\t\tfor (const dependency of module.dependencies ?? []) await install(dependency, undefined);\r\n\r\n\t\tfor (const [hook, callback] of Object.entries(module.hooks ?? {})) {\r\n\t\t\tif (!KNOWN_HOOKS.has(hook) || typeof callback !== 'function') {\r\n\t\t\t\tthrow new ModuleError(\r\n\t\t\t\t\t'MODULE_INVALID',\r\n\t\t\t\t\tname,\r\n\t\t\t\t\tKNOWN_HOOKS.has(hook)\r\n\t\t\t\t\t\t? `The hook \"${hook}\" of the module \"${name}\" must be a function.`\r\n\t\t\t\t\t\t: `The module \"${name}\" declares an unknown hook \"${hook}\". Known hooks: ${STARS_HOOK_NAMES.join(', ')}.`\r\n\t\t\t\t);\r\n\t\t\t}\r\n\r\n\t\t\thooks.hook(hook as never, callback as never);\r\n\t\t}\r\n\r\n\t\tconst installedModule: InstalledModule = module.meta.version === undefined ? { name } : { name, version: module.meta.version };\r\n\t\tconst context: ModuleContext = {\r\n\t\t\troot: config.root,\r\n\t\t\tconfig,\r\n\t\t\tversions,\r\n\t\t\taddPlugin: (plugin) => plugins.push(toRegistration(name, plugin)),\r\n\t\t\taddImports: (preset) => void imports.add(typeof preset === 'string' ? preset : preset.from),\r\n\t\t\thook: (hookName, callback) => hooks.hook(hookName, callback),\r\n\t\t\tcallHook: (hookName, ...args) => hooks.callHook(hookName, ...args),\r\n\t\t\tinstallModule: (nested, nestedOptions) => install(nested as ModuleInput, nestedOptions)\r\n\t\t};\r\n\r\n\t\ttry {\r\n\t\t\tawait module.setup?.(mergeOptions<ModuleOptions>(module.defaults, userOptions), context);\r\n\t\t} catch (error) {\r\n\t\t\tif (error instanceof ModuleError) throw error;\r\n\t\t\tthrow new ModuleError('MODULE_SETUP_FAILED', name, `The module \"${name}\" failed during setup: ${message(error)}`, error);\r\n\t\t}\r\n\r\n\t\tmodules.push(installedModule);\r\n\t}\r\n\r\n\tfor (const entry of config.modules) await install(entry.specifier, entry.options as Record<string, unknown>);\r\n\r\n\treturn { modules, plugins, imports: [...imports] };\r\n}\r\n\r\nconst KNOWN_HOOKS: ReadonlySet<string> = new Set(STARS_HOOK_NAMES);\r\n\r\nfunction validate(value: unknown, label: string): StarsModule {\r\n\tconst module = value as Partial<StarsModule> | null;\r\n\tif (module === null || typeof module !== 'object' || typeof module.meta?.name !== 'string' || module.meta.name === '') {\r\n\t\tthrow new ModuleError(\r\n\t\t\t'MODULE_INVALID',\r\n\t\t\tlabel,\r\n\t\t\t`\"${label}\" is not a Stars module: its default export must be created with \\`defineModule\\` and have a \\`meta.name\\`.`\r\n\t\t);\r\n\t}\r\n\r\n\tif (module.setup !== undefined && typeof module.setup !== 'function') {\r\n\t\tthrow new ModuleError('MODULE_INVALID', module.meta.name, `The \\`setup\\` of the module \"${module.meta.name}\" must be a function.`);\r\n\t}\r\n\r\n\treturn module as StarsModule;\r\n}\r\n\r\nfunction checkCompatibility(module: StarsModule, versions: ModuleVersions): void {\r\n\tconst { name, compatibility } = module.meta;\r\n\tfor (const [key, label] of [\r\n\t\t['framework', '@wolfstar/http-framework'],\r\n\t\t['stars', '@wolfstar/cli']\r\n\t] as const) {\r\n\t\tconst range = compatibility?.[key];\r\n\t\tconst version = versions[key];\r\n\t\tif (range === undefined || version === undefined || version === null) continue;\r\n\t\tif (!satisfies(version, range, { includePrerelease: true })) {\r\n\t\t\tthrow new ModuleError('MODULE_INCOMPATIBLE', name, `The module \"${name}\" needs ${label} ${range}, but ${version} is installed.`);\r\n\t\t}\r\n\t}\r\n}\r\n\r\nconst RELATIVE_PATH = /^\\.\\.?(?:[/\\\\]|$)/;\r\n\r\nfunction toRegistration(moduleName: string, plugin: string | URL | ModulePluginSource): RuntimePluginRegistration {\r\n\tconst source: ModulePluginSource = typeof plugin === 'string' || plugin instanceof URL ? { from: plugin } : plugin;\r\n\tconst from = typeof source.from === 'string' ? source.from : source.from?.href;\r\n\tif (typeof from !== 'string' || from === '') {\r\n\t\tthrow new ModuleError('MODULE_PLUGIN_INVALID', moduleName, `A plugin added by \"${moduleName}\" needs a \\`from\\` specifier, path or URL.`);\r\n\t}\r\n\r\n\tif (RELATIVE_PATH.test(from)) {\r\n\t\tthrow new ModuleError(\r\n\t\t\t'MODULE_PLUGIN_INVALID',\r\n\t\t\tmoduleName,\r\n\t\t\t`The plugin \"${from}\" added by \"${moduleName}\" is a relative path, which would resolve differently per build tool. Use a package specifier, an absolute path or a \\`file:\\` URL, e.g. \\`new URL('./plugin.js', import.meta.url)\\`.`\r\n\t\t);\r\n\t}\r\n\r\n\tif (source.options !== undefined && !isJsonSerialisable(source.options)) {\r\n\t\tthrow new ModuleError(\r\n\t\t\t'MODULE_PLUGIN_INVALID',\r\n\t\t\tmoduleName,\r\n\t\t\t`The options of a plugin added by \"${moduleName}\" must be JSON-serialisable: they are written into the built entry.`\r\n\t\t);\r\n\t}\r\n\r\n\tconst registration = { module: moduleName, from: from.startsWith('file:') ? fileURLToPath(from) : from, export: source.export ?? 'default' };\r\n\treturn source.options === undefined ? registration : { ...registration, options: source.options };\r\n}\r\n\r\nfunction isJsonSerialisable(value: unknown): boolean {\r\n\ttry {\r\n\t\treturn (\r\n\t\t\tJSON.stringify(value, (_key, item: unknown) => {\r\n\t\t\t\tif (typeof item === 'function' || typeof item === 'symbol' || typeof item === 'bigint') throw new TypeError('not serialisable');\r\n\t\t\t\treturn item;\r\n\t\t\t}) !== undefined\r\n\t\t);\r\n\t} catch {\r\n\t\treturn false;\r\n\t}\r\n}\r\n\r\nfunction message(error: unknown): string {\r\n\treturn error instanceof Error ? error.message : String(error);\r\n}\r\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@wolfstar/kit",
+  "version": "0.1.0",
+  "description": "defineModule and the module setup runtime for installable Stars modules, the @nuxt/kit counterpart",
+  "keywords": [
+    "api",
+    "discord",
+    "http",
+    "kit",
+    "modules",
+    "pnpm",
+    "stars",
+    "ts",
+    "typescript",
+    "wolfstar"
+  ],
+  "homepage": "https://github.com/wolfstar-project/stars-components/tree/main/packages/kit",
+  "bugs": {
+    "url": "https://github.com/wolfstar-project/stars-components/issues"
+  },
+  "license": "Apache-2.0",
+  "author": "@wolfstar",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wolfstar-project/stars-components.git",
+    "directory": "packages/kit"
+  },
+  "files": [
+    "dist/"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "main": "dist/esm/index.js",
+  "module": "dist/esm/index.js",
+  "types": "dist/esm/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/esm/index.d.ts",
+        "default": "./dist/esm/index.js"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "dependencies": {
+    "@wolfstar/schema": "^0.5.0",
+    "semver": "^7.8.5"
+  },
+  "devDependencies": {
+    "@types/semver": "^7.8.0",
+    "@vitest/coverage-v8": "^5.0.1",
+    "golar": "^0.1.10",
+    "tsdown": "^0.23.0",
+    "typescript": "~7.0.2",
+    "vitest": "^5.0.1"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "test": "vitest run",
+    "build": "tsdown --config-loader unrun",
+    "watch": "tsdown --config-loader unrun --watch",
+    "typecheck": "golar tsc -p ../../tsconfig.json",
+    "lint": "oxlint src --fix"
+  }
+}