@ruvyxa/adapter-netlify 1.0.1 → 1.0.3

package/README.md

@@ -1,9 +1,36 @@
 # @ruvyxa/adapter-netlify
 
-Netlify deployment adapter contract for Ruvyxa.
+Netlify functions deployment adapter metadata for Ruvyxa production builds.
+
+## Install
+
+```bash
+npm install @ruvyxa/adapter-netlify
+```
+
+## Usage
 
 ```ts
+import { defineConfig } from "ruvyxa/config"
 import { netlifyAdapter } from "@ruvyxa/adapter-netlify"
 
-export default netlifyAdapter()
+export default defineConfig({
+  adapter: netlifyAdapter(),
+})
 ```
+
+## Output Metadata
+
+```json
+{
+  "name": "netlify",
+  "target": "serverless",
+  "platform": "netlify",
+  "entry": ".ruvyxa/server/app",
+  "assetsDir": ".ruvyxa/assets",
+  "functionsDir": ".ruvyxa/netlify/functions",
+  "configFiles": ["netlify.toml"]
+}
+```
+
+Use this adapter when preparing function and static asset output for Netlify.

package/dist/index.d.ts

@@ -1,7 +1,27 @@
 import type { Adapter } from "@ruvyxa/core";
+/**
+ * Options for the Netlify adapter.
+ */
 export interface NetlifyAdapterOptions {
+    /** Custom Netlify functions directory. Defaults to `${outDir}/netlify/functions`. */
     functionsDir?: string;
 }
+/**
+ * Create a Netlify deployment adapter for Ruvyxa.
+ *
+ * Produces serverless function bundles and static assets for Netlify
+ * deployment. Generates a `netlify.toml` config reference for routing.
+ *
+ * @example
+ * ```ts
+ * import { defineConfig } from "ruvyxa/config"
+ * import { netlifyAdapter } from "@ruvyxa/adapter-netlify"
+ *
+ * export default defineConfig({
+ *   adapter: netlifyAdapter({ functionsDir: "netlify/functions" })
+ * })
+ * ```
+ */
 export declare function netlifyAdapter(options?: NetlifyAdapterOptions): Adapter;
 export default netlifyAdapter;
 //# 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,qBAAqB;IACpC,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,wBAAgB,cAAc,CAAC,OAAO,GAAE,qBAA0B,GAAG,OAAO,CAiB3E;AAED,eAAe,cAAc,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,qBAAqB;IACpC,qFAAqF;IACrF,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,qBAA0B,GAAG,OAAO,CA8B3E;AAED,eAAe,cAAc,CAAA"}

package/dist/index.js

@@ -1,8 +1,31 @@
+/**
+ * Create a Netlify deployment adapter for Ruvyxa.
+ *
+ * Produces serverless function bundles and static assets for Netlify
+ * deployment. Generates a `netlify.toml` config reference for routing.
+ *
+ * @example
+ * ```ts
+ * import { defineConfig } from "ruvyxa/config"
+ * import { netlifyAdapter } from "@ruvyxa/adapter-netlify"
+ *
+ * export default defineConfig({
+ *   adapter: netlifyAdapter({ functionsDir: "netlify/functions" })
+ * })
+ * ```
+ */
 export function netlifyAdapter(options = {}) {
+    if (options.functionsDir !== undefined && typeof options.functionsDir !== "string") {
+        throw new Error(`[RUV2001] netlifyAdapter: "functionsDir" must be a string, got ${typeof options.functionsDir}`);
+    }
+    if (options.functionsDir !== undefined && options.functionsDir.trim() === "") {
+        throw new Error(`[RUV2001] netlifyAdapter: "functionsDir" must not be an empty string`);
+    }
     return {
         name: "netlify",
         target: "serverless",
         build(ctx) {
+            validateBuildContext(ctx, "netlifyAdapter");
             const functionsDir = options.functionsDir ?? `${ctx.outDir}/netlify/functions`;
             return {
                 name: "netlify",
@@ -17,4 +40,12 @@ export function netlifyAdapter(options = {}) {
     };
 }
 export default netlifyAdapter;
+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,cAAc,CAAC,UAAiC,EAAE;IAChE,OAAO;QACL,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,YAAY;QACpB,KAAK,CAAC,GAAiB;YACrB,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,GAAG,GAAG,CAAC,MAAM,oBAAoB,CAAA;YAC9E,OAAO;gBACL,IAAI,EAAE,SAAS;gBACf,MAAM,EAAE,YAAY;gBACpB,QAAQ,EAAE,SAAS;gBACnB,KAAK,EAAE,GAAG,GAAG,CAAC,MAAM,aAAa;gBACjC,SAAS,EAAE,GAAG,GAAG,CAAC,MAAM,SAAS;gBACjC,YAAY;gBACZ,WAAW,EAAE,CAAC,cAAc,CAAC;aAC9B,CAAA;QACH,CAAC;KACF,CAAA;AACH,CAAC;AAED,eAAe,cAAc,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAUA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,cAAc,CAAC,UAAiC,EAAE;IAChE,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS,IAAI,OAAO,OAAO,CAAC,YAAY,KAAK,QAAQ,EAAE,CAAC;QACnF,MAAM,IAAI,KAAK,CACb,kEAAkE,OAAO,OAAO,CAAC,YAAY,EAAE,CAChG,CAAA;IACH,CAAC;IAED,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS,IAAI,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC7E,MAAM,IAAI,KAAK,CACb,sEAAsE,CACvE,CAAA;IACH,CAAC;IAED,OAAO;QACL,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,YAAY;QACpB,KAAK,CAAC,GAAiB;YACrB,oBAAoB,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAA;YAC3C,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,GAAG,GAAG,CAAC,MAAM,oBAAoB,CAAA;YAC9E,OAAO;gBACL,IAAI,EAAE,SAAS;gBACf,MAAM,EAAE,YAAY;gBACpB,QAAQ,EAAE,SAAS;gBACnB,KAAK,EAAE,GAAG,GAAG,CAAC,MAAM,aAAa;gBACjC,SAAS,EAAE,GAAG,GAAG,CAAC,MAAM,SAAS;gBACjC,YAAY;gBACZ,WAAW,EAAE,CAAC,cAAc,CAAC;aAC9B,CAAA;QACH,CAAC;KACF,CAAA;AACH,CAAC;AAED,eAAe,cAAc,CAAA;AAE7B,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-netlify",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Shape Ruvyxa builds for Netlify functions and assets with a small typed adapter contract.",
   "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-netlify/**/*.test.ts\"",
     "format": "tsc -p tsconfig.json --noEmit"
   }
 }