@praxisjs/decorators 1.0.0 → 1.0.2

package/CHANGELOG.md

@@ -1,5 +1,31 @@
 # @praxisjs/decorators
 
+## 1.0.2
+
+### Patch Changes
+
+- cfb0de2: `@Resource` now accepts a self-receiving fetcher as an alternative to the zero-argument arrow function.
+
+  When the fetcher accepts one argument, the component instance is passed automatically at bind time — signal reads on `self` become reactive dependencies and TypeScript knows the type:
+
+  ```tsx
+  // before — arrow function, 'this' was module scope (undefined)
+  @Resource(() => fetch(`/api/posts?page=${this.page}`).then(r => r.json()))
+
+  // after — receive the instance as 'self'
+  @Resource((self: PostList) => fetch(`/api/posts?page=${self.page}`).then(r => r.json()))
+  posts!: ResourceInstance<Post[]>
+  ```
+
+  The zero-argument form is unchanged and continues to work for fetchers with no component dependency.
+
+## 1.0.1
+
+### Patch Changes
+
+- Updated dependencies [74d414a]
+  - @praxisjs/core@1.6.0
+
 ## 1.0.0
 
 ### Major Changes

package/dist/properties/resource.d.ts

@@ -1,14 +1,17 @@
 import { type Resource as ResourceInstance, type ResourceOptions } from "@praxisjs/core/internal";
 export type { ResourceInstance, ResourceOptions };
+type FieldDecoratorReturn = (_value: undefined, context: ClassFieldDecoratorContext) => void;
 /**
- * Binds an async resource to the field. The field holds a Resource<T> object
- * with reactive data, pending, error, and status signals, plus refetch/cancel/mutate methods.
+ * Binds an async resource to the field.
  *
- * class MyComponent extends StatefulComponent {
+ * No component dependency — plain arrow:
  *   @Resource(() => api.getUsers())
  *   users!: ResourceInstance<User[]>;
- *   // access: this.users.data(), this.users.pending(), this.users.refetch()
- * }
+ *
+ * Reads reactive component fields — receive the instance as `self`:
+ *   @Resource((self: MyComponent) => api.getPage(self.page))
+ *   items!: ResourceInstance<Item[]>;
  */
-export declare function Resource<T>(fetcher: () => Promise<T>, options?: ResourceOptions<T>): <This extends import("@praxisjs/core").StatefulComponent, Value = unknown>(_value: undefined, context: ClassFieldDecoratorContext<This, Value>) => void;
+export declare function Resource<T>(fetcher: () => Promise<T>, options?: ResourceOptions<T>): FieldDecoratorReturn;
+export declare function Resource<T, C extends object = any>(fetcher: (self: C) => Promise<T>, options?: ResourceOptions<T>): FieldDecoratorReturn;
 //# sourceMappingURL=resource.d.ts.map

package/dist/properties/resource.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resource.d.ts","sourceRoot":"","sources":["../../src/properties/resource.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,QAAQ,IAAI,gBAAgB,EACjC,KAAK,eAAe,EACrB,MAAM,yBAAyB,CAAC;AAIjC,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,CAAC;AAElD;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,GAAE,eAAe,CAAC,CAAC,CAAM,2JAatF"}
+{"version":3,"file":"resource.d.ts","sourceRoot":"","sources":["../../src/properties/resource.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,QAAQ,IAAI,gBAAgB,EACjC,KAAK,eAAe,EACrB,MAAM,yBAAyB,CAAC;AAIjC,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,CAAC;AAElD,KAAK,oBAAoB,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,0BAA0B,KAAK,IAAI,CAAC;AAE7F;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,oBAAoB,CAAC;AAE3G,wBAAgB,QAAQ,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,GAAG,GAAG,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,oBAAoB,CAAC"}

package/dist/properties/resource.js

@@ -1,19 +1,15 @@
 import { resource, } from "@praxisjs/core/internal";
 import { createFieldDecorator } from "../create-field-decorator";
-/**
- * Binds an async resource to the field. The field holds a Resource<T> object
- * with reactive data, pending, error, and status signals, plus refetch/cancel/mutate methods.
- *
- * class MyComponent extends StatefulComponent {
- *   @Resource(() => api.getUsers())
- *   users!: ResourceInstance<User[]>;
- *   // access: this.users.data(), this.users.pending(), this.users.refetch()
- * }
- */
-export function Resource(fetcher, options = {}) {
+export function Resource(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+fetcher, options = {}) {
     return createFieldDecorator({
-        bind(_instance, _name, _initialValue) {
-            const r = resource(fetcher, options);
+        bind(instance, _name, _initialValue) {
+            const bound = fetcher.length > 0
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                ? () => fetcher(instance)
+                : fetcher;
+            const r = resource(bound, options);
             return {
                 descriptor: {
                     get() { return r; },

package/dist/properties/resource.js.map

@@ -1 +1 @@
-{"version":3,"file":"resource.js","sourceRoot":"","sources":["../../src/properties/resource.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,GAGT,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,oBAAoB,EAAqB,MAAM,2BAA2B,CAAC;AAIpF;;;;;;;;;GASG;AACH,MAAM,UAAU,QAAQ,CAAI,OAAyB,EAAE,UAA8B,EAAE;IACrF,OAAO,oBAAoB,CAAC;QAC1B,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,aAAa;YAClC,MAAM,CAAC,GAAG,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACrC,OAAO;gBACL,UAAU,EAAE;oBACV,GAAG,KAA0B,OAAO,CAAC,CAAC,CAAC,CAAC;oBACxC,gEAAgE;oBAChE,GAAG,KAAU,CAAC;iBACf;aACF,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"resource.js","sourceRoot":"","sources":["../../src/properties/resource.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,GAGT,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,oBAAoB,EAAqB,MAAM,2BAA2B,CAAC;AAoBpF,MAAM,UAAU,QAAQ;AACtB,8DAA8D;AAC9D,OAAyD,EACzD,UAA8B,EAAE;IAEhC,OAAO,oBAAoB,CAAC;QAC1B,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,aAAa;YACjC,MAAM,KAAK,GACT,OAAO,CAAC,MAAM,GAAG,CAAC;gBAChB,8DAA8D;gBAC9D,CAAC,CAAC,GAAG,EAAE,CAAE,OAAqC,CAAC,QAAQ,CAAC;gBACxD,CAAC,CAAE,OAA4B,CAAC;YACpC,MAAM,CAAC,GAAG,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YACnC,OAAO;gBACL,UAAU,EAAE;oBACV,GAAG,KAA0B,OAAO,CAAC,CAAC,CAAC,CAAC;oBACxC,gEAAgE;oBAChE,GAAG,KAAU,CAAC;iBACf;aACF,CAAC;QACJ,CAAC;KACF,CAAoC,CAAC;AACxC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisjs/decorators",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -15,7 +15,7 @@
     "typescript": "^5.9.3"
   },
   "dependencies": {
-    "@praxisjs/core": "1.5.0",
+    "@praxisjs/core": "1.6.0",
     "@praxisjs/shared": "0.2.0"
   },
   "scripts": {

package/src/properties/resource.ts

@@ -8,20 +8,35 @@ import { createFieldDecorator, type FieldBinding } from "../create-field-decorat
 
 export type { ResourceInstance, ResourceOptions };
 
+type FieldDecoratorReturn = (_value: undefined, context: ClassFieldDecoratorContext) => void;
+
 /**
- * Binds an async resource to the field. The field holds a Resource<T> object
- * with reactive data, pending, error, and status signals, plus refetch/cancel/mutate methods.
+ * Binds an async resource to the field.
  *
- * class MyComponent extends StatefulComponent {
+ * No component dependency — plain arrow:
  *   @Resource(() => api.getUsers())
  *   users!: ResourceInstance<User[]>;
- *   // access: this.users.data(), this.users.pending(), this.users.refetch()
- * }
+ *
+ * Reads reactive component fields — receive the instance as `self`:
+ *   @Resource((self: MyComponent) => api.getPage(self.page))
+ *   items!: ResourceInstance<Item[]>;
  */
-export function Resource<T>(fetcher: () => Promise<T>, options: ResourceOptions<T> = {}) {
+export function Resource<T>(fetcher: () => Promise<T>, options?: ResourceOptions<T>): FieldDecoratorReturn;
+// eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-unnecessary-type-parameters
+export function Resource<T, C extends object = any>(fetcher: (self: C) => Promise<T>, options?: ResourceOptions<T>): FieldDecoratorReturn;
+export function Resource<T>(
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  fetcher: (() => Promise<T>) | ((self: any) => Promise<T>),
+  options: ResourceOptions<T> = {},
+): FieldDecoratorReturn {
   return createFieldDecorator({
-    bind(_instance, _name, _initialValue): FieldBinding {
-      const r = resource(fetcher, options);
+    bind(instance, _name, _initialValue): FieldBinding {
+      const bound =
+        fetcher.length > 0
+          // eslint-disable-next-line @typescript-eslint/no-explicit-any
+          ? () => (fetcher as (self: any) => Promise<T>)(instance)
+          : (fetcher as () => Promise<T>);
+      const r = resource(bound, options);
       return {
         descriptor: {
           get(): ResourceInstance<T> { return r; },
@@ -30,5 +45,5 @@ export function Resource<T>(fetcher: () => Promise<T>, options: ResourceOptions<
         },
       };
     },
-  });
+  }) as unknown as FieldDecoratorReturn;
 }