@ruvyxa/adapter-cloudflare 1.0.1 → 1.0.3

package/README.md

@@ -1,9 +1,35 @@
 # @ruvyxa/adapter-cloudflare
 
-Cloudflare edge deployment adapter contract for Ruvyxa.
+Cloudflare edge deployment adapter metadata for Ruvyxa production builds.
+
+## Install
+
+```bash
+npm install @ruvyxa/adapter-cloudflare
+```
+
+## Usage
 
 ```ts
+import { defineConfig } from "ruvyxa/config"
 import { cloudflareAdapter } from "@ruvyxa/adapter-cloudflare"
 
-export default cloudflareAdapter()
+export default defineConfig({
+  adapter: cloudflareAdapter(),
+})
 ```
+
+## Output Metadata
+
+```json
+{
+  "name": "cloudflare",
+  "target": "edge",
+  "platform": "cloudflare",
+  "entry": ".ruvyxa/server/app",
+  "assetsDir": ".ruvyxa/assets",
+  "configFiles": ["wrangler.toml"]
+}
+```
+
+Use this adapter for Cloudflare Workers and Pages-style edge deployments.

package/dist/index.d.ts

@@ -1,7 +1,27 @@
 import type { Adapter } from "@ruvyxa/core";
+/**
+ * Options for the Cloudflare Workers adapter.
+ */
 export interface CloudflareAdapterOptions {
+    /** Custom worker entry point path. Defaults to `${outDir}/server/app`. */
     workerEntry?: string;
 }
+/**
+ * Create a Cloudflare Workers deployment adapter for Ruvyxa.
+ *
+ * Produces an edge-compatible worker bundle and static assets ready for
+ * deployment via `wrangler`. Generates a `wrangler.toml` config reference.
+ *
+ * @example
+ * ```ts
+ * import { defineConfig } from "ruvyxa/config"
+ * import { cloudflareAdapter } from "@ruvyxa/adapter-cloudflare"
+ *
+ * export default defineConfig({
+ *   adapter: cloudflareAdapter({ workerEntry: "./src/worker.ts" })
+ * })
+ * ```
+ */
 export declare function cloudflareAdapter(options?: CloudflareAdapterOptions): Adapter;
 export default cloudflareAdapter;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAA+B,MAAM,cAAc,CAAA;AAExE,MAAM,WAAW,wBAAwB;IACvC,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,wBAA6B,GAAG,OAAO,CAejF;AAED,eAAe,iBAAiB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAA+B,MAAM,cAAc,CAAA;AAExE;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,0EAA0E;IAC1E,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,wBAA6B,GAAG,OAAO,CA4BjF;AAED,eAAe,iBAAiB,CAAA"}

package/dist/index.js

@@ -1,8 +1,31 @@
+/**
+ * Create a Cloudflare Workers deployment adapter for Ruvyxa.
+ *
+ * Produces an edge-compatible worker bundle and static assets ready for
+ * deployment via `wrangler`. Generates a `wrangler.toml` config reference.
+ *
+ * @example
+ * ```ts
+ * import { defineConfig } from "ruvyxa/config"
+ * import { cloudflareAdapter } from "@ruvyxa/adapter-cloudflare"
+ *
+ * export default defineConfig({
+ *   adapter: cloudflareAdapter({ workerEntry: "./src/worker.ts" })
+ * })
+ * ```
+ */
 export function cloudflareAdapter(options = {}) {
+    if (options.workerEntry !== undefined && typeof options.workerEntry !== "string") {
+        throw new Error(`[RUV2001] cloudflareAdapter: "workerEntry" must be a string, got ${typeof options.workerEntry}`);
+    }
+    if (options.workerEntry !== undefined && options.workerEntry.trim() === "") {
+        throw new Error(`[RUV2001] cloudflareAdapter: "workerEntry" must not be an empty string`);
+    }
     return {
         name: "cloudflare",
         target: "edge",
         build(ctx) {
+            validateBuildContext(ctx, "cloudflareAdapter");
             return {
                 name: "cloudflare",
                 target: "edge",
@@ -15,4 +38,12 @@ export function cloudflareAdapter(options = {}) {
     };
 }
 export default cloudflareAdapter;
+function validateBuildContext(ctx, adapterName) {
+    if (!ctx.root || typeof ctx.root !== "string") {
+        throw new Error(`[RUV2000] ${adapterName}: BuildContext.root is required and must be a non-empty string`);
+    }
+    if (!ctx.outDir || typeof ctx.outDir !== "string") {
+        throw new Error(`[RUV2000] ${adapterName}: BuildContext.outDir is required and must be a non-empty string`);
+    }
+}
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,iBAAiB,CAAC,UAAoC,EAAE;IACtE,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,MAAM,EAAE,MAAM;QACd,KAAK,CAAC,GAAiB;YACrB,OAAO;gBACL,IAAI,EAAE,YAAY;gBAClB,MAAM,EAAE,MAAM;gBACd,QAAQ,EAAE,YAAY;gBACtB,KAAK,EAAE,OAAO,CAAC,WAAW,IAAI,GAAG,GAAG,CAAC,MAAM,aAAa;gBACxD,SAAS,EAAE,GAAG,GAAG,CAAC,MAAM,SAAS;gBACjC,WAAW,EAAE,CAAC,eAAe,CAAC;aAC/B,CAAA;QACH,CAAC;KACF,CAAA;AACH,CAAC;AAED,eAAe,iBAAiB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAUA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,iBAAiB,CAAC,UAAoC,EAAE;IACtE,IAAI,OAAO,CAAC,WAAW,KAAK,SAAS,IAAI,OAAO,OAAO,CAAC,WAAW,KAAK,QAAQ,EAAE,CAAC;QACjF,MAAM,IAAI,KAAK,CACb,oEAAoE,OAAO,OAAO,CAAC,WAAW,EAAE,CACjG,CAAA;IACH,CAAC;IAED,IAAI,OAAO,CAAC,WAAW,KAAK,SAAS,IAAI,OAAO,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC3E,MAAM,IAAI,KAAK,CACb,wEAAwE,CACzE,CAAA;IACH,CAAC;IAED,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,MAAM,EAAE,MAAM;QACd,KAAK,CAAC,GAAiB;YACrB,oBAAoB,CAAC,GAAG,EAAE,mBAAmB,CAAC,CAAA;YAC9C,OAAO;gBACL,IAAI,EAAE,YAAY;gBAClB,MAAM,EAAE,MAAM;gBACd,QAAQ,EAAE,YAAY;gBACtB,KAAK,EAAE,OAAO,CAAC,WAAW,IAAI,GAAG,GAAG,CAAC,MAAM,aAAa;gBACxD,SAAS,EAAE,GAAG,GAAG,CAAC,MAAM,SAAS;gBACjC,WAAW,EAAE,CAAC,eAAe,CAAC;aAC/B,CAAA;QACH,CAAC;KACF,CAAA;AACH,CAAC;AAED,eAAe,iBAAiB,CAAA;AAEhC,SAAS,oBAAoB,CAAC,GAAiB,EAAE,WAAmB;IAClE,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CACb,aAAa,WAAW,gEAAgE,CACzF,CAAA;IACH,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CACb,aAAa,WAAW,kEAAkE,CAC3F,CAAA;IACH,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ruvyxa/adapter-cloudflare",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Shape Ruvyxa builds for Cloudflare edge targets with typed worker and asset output metadata.",
   "license": "MIT",
   "type": "module",
@@ -26,7 +26,7 @@
   },
   "homepage": "https://github.com/thirawat27/ruvyxa#readme",
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=22.0.0"
   },
   "publishConfig": {
     "access": "public"
@@ -38,12 +38,12 @@
     }
   },
   "dependencies": {
-    "@ruvyxa/core": "^1.0.1"
+    "@ruvyxa/core": "^1.0.3"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",
     "check": "tsc -p tsconfig.json --noEmit",
-    "test": "vitest run",
+    "test": "node --test \"../../../tests/packages/adapter-cloudflare/**/*.test.ts\"",
     "format": "tsc -p tsconfig.json --noEmit"
   }
 }