@adrianhall/cloudflare-toolkit 0.0.1 → 1.0.0

package/README.md

@@ -54,6 +54,12 @@ use every export in this package:
 npx skills add adrianhall/cloudflare-toolkit
 ```
 
+## Contributing
+
+See [`CONTRIBUTING.md`](./CONTRIBUTING.md) for the PR/changeset process,
+[`RELEASING.md`](./RELEASING.md) for how releases are cut, and [`AGENTS.md`](./AGENTS.md) for
+engineering conventions.
+
 ## License
 
 [MIT](./LICENSE)

package/dist/cli/generate-wrangler-types/index.js

@@ -169,7 +169,7 @@ async function run(argv, deps) {
 	const commanderArgv = separatorIndex === -1 ? argv : argv.slice(0, separatorIndex);
 	const extraArgs = separatorIndex === -1 ? [] : argv.slice(separatorIndex + 1);
 	const program = new Command();
-	program.name("generate-wrangler-types").description("Regenerate worker-configuration.d.ts only when wrangler.jsonc has changed").version("0.0.1", "--version", "Print version and exit").option("-c, --config <file>", "Wrangler config file to watch", "wrangler.jsonc").option("-d, --dir <dir>", "Base directory for resolving relative paths", ".").option("-f, --force", "Force regeneration even if types are already fresh").option("-o, --output <file>", "Output .d.ts file path (relative to --dir)", "worker-configuration.d.ts").option("-q, --quiet", "Quiet logging (min level: warn)").option("-v, --verbose", "Verbose logging (min level: debug)").allowUnknownOption(false);
+	program.name("generate-wrangler-types").description("Regenerate worker-configuration.d.ts only when wrangler.jsonc has changed").version("1.0.0", "--version", "Print version and exit").option("-c, --config <file>", "Wrangler config file to watch", "wrangler.jsonc").option("-d, --dir <dir>", "Base directory for resolving relative paths", ".").option("-f, --force", "Force regeneration even if types are already fresh").option("-o, --output <file>", "Output .d.ts file path (relative to --dir)", "worker-configuration.d.ts").option("-q, --quiet", "Quiet logging (min level: warn)").option("-v, --verbose", "Verbose logging (min level: debug)").allowUnknownOption(false);
 	program.exitOverride();
 	try {
 		program.parse(commanderArgv);

package/dist/errors/index.d.ts

@@ -1,2 +1,2 @@
-import { a as forbidden, c as methodNotAllowed, d as serviceUnavailable, f as unauthorized, i as contentTooLarge, l as notFound, m as unsupportedMediaType, n as InvalidShapeError, o as gone, p as unprocessableContent, r as badRequest, s as internalServerError, t as NullError, u as notImplemented } from "../index-CUICemFw.js";
-export { InvalidShapeError, NullError, badRequest, contentTooLarge, forbidden, gone, internalServerError, methodNotAllowed, notFound, notImplemented, serviceUnavailable, unauthorized, unprocessableContent, unsupportedMediaType };
+import { a as contentTooLarge, c as internalServerError, d as notImplemented, f as serviceUnavailable, h as unsupportedMediaType, i as badRequest, l as methodNotAllowed, m as unprocessableContent, n as InvalidShapeError, o as forbidden, p as unauthorized, r as HttpErrorInput, s as gone, t as NullError, u as notFound } from "../index-DSHomPUi.js";
+export { type HttpErrorInput, InvalidShapeError, NullError, badRequest, contentTooLarge, forbidden, gone, internalServerError, methodNotAllowed, notFound, notImplemented, serviceUnavailable, unauthorized, unprocessableContent, unsupportedMediaType };

package/dist/hono/index.d.ts

@@ -343,5 +343,5 @@ declare function cloudflareAccess(options?: CloudflareAccessOptions): Middleware
   Variables: AuthVariables;
 }>;
 //#endregion
-export { type AuthVariables, type CloudflareAccessOptions, type CloudflareLoggerOptions, type CloudflareToolkitVariables, type LoggerVariables, type NotFoundHandlerOptions, type ProblemDetailsErrorHandlerOptions, cloudflareAccess, cloudflareLogger, notFoundHandler, problemDetailsErrorHandler };
+export { type AuthVariables, type CloudflareAccessOptions, type CloudflareLoggerOptions, type CloudflareToolkitVariables, type LoggerVariables, type NotFoundHandlerOptions, type PathPolicy, type ProblemDetailsErrorHandlerOptions, cloudflareAccess, cloudflareLogger, notFoundHandler, problemDetailsErrorHandler };
 //# sourceMappingURL=index.d.ts.map

package/dist/{index-DRIhR-Xn.d.ts → index-D5bfk4cR.d.ts}

@@ -18,16 +18,25 @@ import { t as ProblemDetailsError } from "./error-CLYcAvBM.js";
 declare function problemDetails<T extends Record<string, unknown>>(input: ProblemDetailsInput<T>): ProblemDetailsError;
 //#endregion
 //#region src/lib/problem-details/registry.d.ts
+/** The base RFC 9457 definition (type, status, title) registered for a problem type key. */
 interface ProblemTypeDefinition {
+  /** A URI identifying the problem type, per RFC 9457. */
   readonly type: string;
+  /** The HTTP status code for this problem type. */
   readonly status: number;
+  /** A short, human-readable summary of the problem type. */
   readonly title: string;
 }
+/** Per-instance overrides accepted by {@link ProblemTypeRegistry}'s `create()` method. */
 interface CreateOptions<T extends Record<string, unknown> = Record<string, unknown>> {
+  /** A human-readable explanation specific to this occurrence of the problem. */
   detail?: string;
+  /** A URI identifying this specific occurrence of the problem. */
   instance?: string;
+  /** Additional problem-specific extension members. */
   extensions?: T;
 }
+/** A registry of pre-defined problem types, returned by {@link createProblemTypeRegistry}. */
 interface ProblemTypeRegistry<K extends string> {
   /** Create a {@link ProblemDetailsError} from a registered problem type key. */
   create: <T extends Record<string, unknown>>(key: K, options?: CreateOptions<T>) => ProblemDetailsError;
@@ -77,5 +86,5 @@ declare function statusToPhrase(status: number): string | undefined;
  */
 declare function statusToSlug(status: number): string | undefined;
 //#endregion
-export { problemDetails as i, statusToSlug as n, createProblemTypeRegistry as r, statusToPhrase as t };
-//# sourceMappingURL=index-DRIhR-Xn.d.ts.map
+export { ProblemTypeRegistry as a, ProblemTypeDefinition as i, statusToSlug as n, createProblemTypeRegistry as o, CreateOptions as r, problemDetails as s, statusToPhrase as t };
+//# sourceMappingURL=index-D5bfk4cR.d.ts.map

package/dist/{index-CUICemFw.d.ts → index-DSHomPUi.d.ts}

@@ -125,5 +125,5 @@ declare class NullError extends ProblemDetailsError {
   constructor(message: string);
 }
 //#endregion
-export { forbidden as a, methodNotAllowed as c, serviceUnavailable as d, unauthorized as f, contentTooLarge as i, notFound as l, unsupportedMediaType as m, InvalidShapeError as n, gone as o, unprocessableContent as p, badRequest as r, internalServerError as s, NullError as t, notImplemented as u };
-//# sourceMappingURL=index-CUICemFw.d.ts.map
+export { contentTooLarge as a, internalServerError as c, notImplemented as d, serviceUnavailable as f, unsupportedMediaType as h, badRequest as i, methodNotAllowed as l, unprocessableContent as m, InvalidShapeError as n, forbidden as o, unauthorized as p, HttpErrorInput as r, gone as s, NullError as t, notFound as u };
+//# sourceMappingURL=index-DSHomPUi.d.ts.map

package/dist/index.d.ts

@@ -1,8 +1,8 @@
 import { n as throwIfNull, r as valueOrDefault, t as sqlCount } from "./index-434HN8jN.js";
 import { n as ProblemDetailsInput, t as ProblemDetails } from "./types-Cx6NNILW.js";
 import { t as ProblemDetailsError } from "./error-CLYcAvBM.js";
-import { a as forbidden, c as methodNotAllowed, d as serviceUnavailable, f as unauthorized, l as notFound, m as unsupportedMediaType, n as InvalidShapeError, o as gone, p as unprocessableContent, r as badRequest, s as internalServerError, t as NullError, u as notImplemented } from "./index-CUICemFw.js";
-import { i as problemDetails, n as statusToSlug, r as createProblemTypeRegistry, t as statusToPhrase } from "./index-DRIhR-Xn.js";
+import { c as internalServerError, d as notImplemented, f as serviceUnavailable, h as unsupportedMediaType, i as badRequest, l as methodNotAllowed, m as unprocessableContent, n as InvalidShapeError, o as forbidden, p as unauthorized, s as gone, t as NullError, u as notFound } from "./index-DSHomPUi.js";
+import { n as statusToSlug, o as createProblemTypeRegistry, s as problemDetails, t as statusToPhrase } from "./index-D5bfk4cR.js";
 import { a as Environment, c as LogRecord, d as Runtime, f as StructuredTransportOptions, i as CreateLoggerOptions, l as Logger, m as TransportErrorHandler, n as CaptureTransport, o as LogContext, p as Transport, r as ConsoleTransportOptions, s as LogLevel, t as BrowserTransportOptions, u as ResolvedLoggerConfig } from "./types-DCSMb1cp.js";
 import { a as createCaptureTransport, c as resolveLoggerConfig, i as combineTransports, l as createLogger, n as createSilentTransport, o as createBrowserTransport, r as createConsoleTransport, s as serializeError, t as createStructuredTransport } from "./index-Byl-ZrCy.js";
 export { type BrowserTransportOptions, type CaptureTransport, type ConsoleTransportOptions, type CreateLoggerOptions, type Environment, InvalidShapeError, type LogContext, type LogLevel, type LogRecord, type Logger, NullError, type ProblemDetails, ProblemDetailsError, type ProblemDetailsInput, type ResolvedLoggerConfig, type Runtime, type StructuredTransportOptions, type Transport, type TransportErrorHandler, badRequest, combineTransports, createBrowserTransport, createCaptureTransport, createConsoleTransport, createLogger, createProblemTypeRegistry, createSilentTransport, createStructuredTransport, forbidden, gone, internalServerError, methodNotAllowed, notFound, notImplemented, problemDetails, resolveLoggerConfig, serializeError, serviceUnavailable, sqlCount, statusToPhrase, statusToSlug, throwIfNull, unauthorized, unprocessableContent, unsupportedMediaType, valueOrDefault };

package/dist/problem-details/index.d.ts

@@ -1,4 +1,4 @@
 import { n as ProblemDetailsInput, t as ProblemDetails } from "../types-Cx6NNILW.js";
 import { t as ProblemDetailsError } from "../error-CLYcAvBM.js";
-import { i as problemDetails, n as statusToSlug, r as createProblemTypeRegistry, t as statusToPhrase } from "../index-DRIhR-Xn.js";
-export { type ProblemDetails, ProblemDetailsError, type ProblemDetailsInput, createProblemTypeRegistry, problemDetails, statusToPhrase, statusToSlug };
+import { a as ProblemTypeRegistry, i as ProblemTypeDefinition, n as statusToSlug, o as createProblemTypeRegistry, r as CreateOptions, s as problemDetails, t as statusToPhrase } from "../index-D5bfk4cR.js";
+export { type CreateOptions, type ProblemDetails, ProblemDetailsError, type ProblemDetailsInput, type ProblemTypeDefinition, type ProblemTypeRegistry, createProblemTypeRegistry, problemDetails, statusToPhrase, statusToSlug };

package/dist/problem-details-CuRsLy3Q.js.map

@@ -1 +1 @@
-{"version":3,"file":"problem-details-CuRsLy3Q.js","names":[],"sources":["../src/lib/problem-details/registry.ts"],"sourcesContent":["/**\n * @file A registry for pre-defined, type-safe RFC 9457 problem types.\n */\nimport { ProblemDetailsError } from \"./error.js\";\n\ninterface ProblemTypeDefinition {\n  readonly type: string;\n  readonly status: number;\n  readonly title: string;\n}\n\ninterface CreateOptions<T extends Record<string, unknown> = Record<string, unknown>> {\n  detail?: string;\n  instance?: string;\n  extensions?: T;\n}\n\ninterface ProblemTypeRegistry<K extends string> {\n  /** Create a {@link ProblemDetailsError} from a registered problem type key. */\n  create: <T extends Record<string, unknown>>(\n    key: K,\n    options?: CreateOptions<T>\n  ) => ProblemDetailsError;\n  /**\n   * Get the base definition (type, status, title) for a registered key.\n   * Returns a defensive shallow copy on every call, so mutating the result never affects the\n   * registry's internal definitions.\n   */\n  get: (key: K) => Readonly<ProblemTypeDefinition>;\n  /** List all registered problem type keys. */\n  types: () => K[];\n}\n\n/**\n * Create a registry of pre-defined problem types.\n * Provides type-safe error creation from registered definitions.\n *\n * @param definitions - A map of problem type keys to their base definition (type, status, title).\n * @returns A {@link ProblemTypeRegistry} for the given definitions.\n * @example\n * ```ts\n * const problems = createProblemTypeRegistry({\n *   ORDER_CONFLICT: {\n *     type: \"https://api.example.com/problems/order-conflict\",\n *     status: 409,\n *     title: \"Order Conflict\",\n *   },\n * });\n * throw problems.create(\"ORDER_CONFLICT\", { detail: \"Already exists\" });\n * ```\n */\nexport function createProblemTypeRegistry<K extends string>(\n  definitions: Record<K, ProblemTypeDefinition>\n): ProblemTypeRegistry<K> {\n  return {\n    create: (key, options) => new ProblemDetailsError({ ...definitions[key], ...options }),\n    get: (key) => ({ ...definitions[key] }),\n    types: () => Object.keys(definitions) as K[]\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAmDA,SAAgB,0BACd,aACwB;CACxB,OAAO;EACL,SAAS,KAAK,YAAY,IAAI,oBAAoB;GAAE,GAAG,YAAY;GAAM,GAAG;EAAQ,CAAC;EACrF,MAAM,SAAS,EAAE,GAAG,YAAY,KAAK;EACrC,aAAa,OAAO,KAAK,WAAW;CACtC;AACF"}
+{"version":3,"file":"problem-details-CuRsLy3Q.js","names":[],"sources":["../src/lib/problem-details/registry.ts"],"sourcesContent":["/**\n * @file A registry for pre-defined, type-safe RFC 9457 problem types.\n */\nimport { ProblemDetailsError } from \"./error.js\";\n\n/** The base RFC 9457 definition (type, status, title) registered for a problem type key. */\nexport interface ProblemTypeDefinition {\n  /** A URI identifying the problem type, per RFC 9457. */\n  readonly type: string;\n  /** The HTTP status code for this problem type. */\n  readonly status: number;\n  /** A short, human-readable summary of the problem type. */\n  readonly title: string;\n}\n\n/** Per-instance overrides accepted by {@link ProblemTypeRegistry}'s `create()` method. */\nexport interface CreateOptions<T extends Record<string, unknown> = Record<string, unknown>> {\n  /** A human-readable explanation specific to this occurrence of the problem. */\n  detail?: string;\n  /** A URI identifying this specific occurrence of the problem. */\n  instance?: string;\n  /** Additional problem-specific extension members. */\n  extensions?: T;\n}\n\n/** A registry of pre-defined problem types, returned by {@link createProblemTypeRegistry}. */\nexport interface ProblemTypeRegistry<K extends string> {\n  /** Create a {@link ProblemDetailsError} from a registered problem type key. */\n  create: <T extends Record<string, unknown>>(\n    key: K,\n    options?: CreateOptions<T>\n  ) => ProblemDetailsError;\n  /**\n   * Get the base definition (type, status, title) for a registered key.\n   * Returns a defensive shallow copy on every call, so mutating the result never affects the\n   * registry's internal definitions.\n   */\n  get: (key: K) => Readonly<ProblemTypeDefinition>;\n  /** List all registered problem type keys. */\n  types: () => K[];\n}\n\n/**\n * Create a registry of pre-defined problem types.\n * Provides type-safe error creation from registered definitions.\n *\n * @param definitions - A map of problem type keys to their base definition (type, status, title).\n * @returns A {@link ProblemTypeRegistry} for the given definitions.\n * @example\n * ```ts\n * const problems = createProblemTypeRegistry({\n *   ORDER_CONFLICT: {\n *     type: \"https://api.example.com/problems/order-conflict\",\n *     status: 409,\n *     title: \"Order Conflict\",\n *   },\n * });\n * throw problems.create(\"ORDER_CONFLICT\", { detail: \"Already exists\" });\n * ```\n */\nexport function createProblemTypeRegistry<K extends string>(\n  definitions: Record<K, ProblemTypeDefinition>\n): ProblemTypeRegistry<K> {\n  return {\n    create: (key, options) => new ProblemDetailsError({ ...definitions[key], ...options }),\n    get: (key) => ({ ...definitions[key] }),\n    types: () => Object.keys(definitions) as K[]\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AA4DA,SAAgB,0BACd,aACwB;CACxB,OAAO;EACL,SAAS,KAAK,YAAY,IAAI,oBAAoB;GAAE,GAAG,YAAY;GAAM,GAAG;EAAQ,CAAC;EACrF,MAAM,SAAS,EAAE,GAAG,YAAY,KAAK;EACrC,aAAa,OAAO,KAAK,WAAW;CACtC;AACF"}

package/dist/vite/index.d.ts

@@ -75,5 +75,5 @@ interface CloudflareAccessPluginOptions {
  */
 declare function cloudflareAccessPlugin(options?: CloudflareAccessPluginOptions): Plugin;
 //#endregion
-export { type CloudflareAccessPluginOptions, cloudflareAccessPlugin };
+export { type CloudflareAccessPluginOptions, type DevLoginUser, type PathPolicy, cloudflareAccessPlugin };
 //# sourceMappingURL=index.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adrianhall/cloudflare-toolkit",
-  "version": "0.0.1",
+  "version": "1.0.0",
   "description": "A toolkit of utilities and skills for developing Workers on the Cloudflare Dev Platform",
   "keywords": [
     "cloudflare",
@@ -93,6 +93,7 @@
     "jose": "^6.2.3"
   },
   "devDependencies": {
+    "@changesets/cli": "^2.31.0",
     "@cloudflare/vitest-pool-workers": "^0.18.3",
     "@cloudflare/workers-types": "5.20260708.1",
     "@types/cross-spawn": "^6.0.6",
@@ -114,6 +115,7 @@
   },
   "scripts": {
     "build": "tsdown",
+    "changeset": "changeset",
     "check": "run-s check:types check:lint check:format check:pack",
     "check:format": "prettier --check .",
     "check:lint": "eslint .",
@@ -125,8 +127,10 @@
     "prepare": "husky",
     "pretest": "npm run build",
     "pretest:coverage": "npm run build",
+    "release": "npm run build && changeset publish",
     "test": "vitest run",
-    "test:coverage": "vitest run --coverage"
+    "test:coverage": "vitest run --coverage",
+    "version-packages": "changeset version && prettier --write ."
   },
   "allowScripts": {
     "esbuild@0.28.1": true,