@wild-framework/resources 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Wild Framework contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,28 @@
+# @wild-framework/resources
+
+API resource transformation for [Wild Framework](https://github.com/your-org/wild-framework).
+
+## Install
+
+```bash
+pnpm add @wild-framework/resources
+```
+
+## Usage
+
+```ts
+import { Resource } from "@wild-framework/resources";
+
+class UserResource extends Resource<User> {
+    transform(user: User): Record<string, unknown> {
+        return { id: user.id, name: user.name };
+    }
+}
+
+UserResource.make(user);          // single
+UserResource.collection(users);   // array
+```
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { Resource } from "./resource.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { Resource } from "./resource.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC"}

package/dist/resource.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Base class for API resources.
+ *
+ * Subclasses define a `transform()` method that converts a domain object
+ * into a plain JSON-safe object. The static `make()` and `collection()`
+ * methods handle instantiation and iteration.
+ *
+ * @example
+ * class UserResource extends Resource<User> {
+ *     transform(user: User): Record<string, unknown> {
+ *         return { id: user.id, name: user.name };
+ *     }
+ * }
+ *
+ * UserResource.make(user);
+ * UserResource.collection(users);
+ */
+export declare abstract class Resource<T> {
+    /**
+     * Transform a single item into a plain object.
+     */
+    abstract transform(item: T): Record<string, unknown>;
+    /**
+     * Transform a single item.
+     *
+     * Instantiates the resource class and calls `transform()`.
+     */
+    static make<T>(this: new () => Resource<T>, item: T): Record<string, unknown>;
+    /**
+     * Transform an array of items.
+     *
+     * Calls `make()` for each item.
+     */
+    static collection<T>(this: new () => Resource<T>, items: T[]): Record<string, unknown>[];
+}
+//# sourceMappingURL=resource.d.ts.map

package/dist/resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource.d.ts","sourceRoot":"","sources":["../src/resource.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,8BAAsB,QAAQ,CAAC,CAAC;IAC5B;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAEpD;;;;OAIG;IACH,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAK7E;;;;OAIG;IACH,MAAM,CAAC,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE;CAI3F"}

package/dist/resource.js

@@ -0,0 +1,38 @@
+/**
+ * Base class for API resources.
+ *
+ * Subclasses define a `transform()` method that converts a domain object
+ * into a plain JSON-safe object. The static `make()` and `collection()`
+ * methods handle instantiation and iteration.
+ *
+ * @example
+ * class UserResource extends Resource<User> {
+ *     transform(user: User): Record<string, unknown> {
+ *         return { id: user.id, name: user.name };
+ *     }
+ * }
+ *
+ * UserResource.make(user);
+ * UserResource.collection(users);
+ */
+export class Resource {
+    /**
+     * Transform a single item.
+     *
+     * Instantiates the resource class and calls `transform()`.
+     */
+    static make(item) {
+        const instance = new this();
+        return instance.transform(item);
+    }
+    /**
+     * Transform an array of items.
+     *
+     * Calls `make()` for each item.
+     */
+    static collection(items) {
+        const Ctor = this;
+        return items.map((item) => Ctor.make(item));
+    }
+}
+//# sourceMappingURL=resource.js.map

package/dist/resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource.js","sourceRoot":"","sources":["../src/resource.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAgB,QAAQ;IAM1B;;;;OAIG;IACH,MAAM,CAAC,IAAI,CAAiC,IAAO;QAC/C,MAAM,QAAQ,GAAG,IAAI,IAAI,EAAE,CAAC;QAC5B,OAAO,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,UAAU,CAAiC,KAAU;QACxD,MAAM,IAAI,GAAG,IAA6D,CAAC;QAC3E,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAChD,CAAC;CACJ"}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@wild-framework/resources",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "author": "Sphah",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/KhandaSoftware/wild-framework.git"
+  },
+  "description": "API resource transformation for Wild Framework.",
+  "keywords": [
+    "wild",
+    "framework",
+    "resources",
+    "api",
+    "transform"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "test": "vitest run"
+  }
+}