@spry-cli/decorators 0.0.1

package/README.md

@@ -0,0 +1,99 @@
+# @spry-cli/decorators
+
+TypeScript decorators for defining [Spry](https://github.com/MerseniBilel/spry) repository contracts. Annotate an abstract class with HTTP verbs and parameter bindings, then let the Spry CLI generate your entire data layer, use cases, and state management.
+
+## Install
+
+```bash
+npm install @spry-cli/decorators
+```
+
+## Usage
+
+```ts
+import {
+  BaseURL,
+  GET,
+  POST,
+  PATCH,
+  DELETE,
+  Param,
+  Query,
+  Body,
+  Cache,
+  Paginated,
+} from '@spry-cli/decorators'
+
+@BaseURL('/api/v1')
+export abstract class ProfileRepository {
+  @GET('/profile/:userId')
+  @Cache(60)
+  abstract getProfile(@Param('userId') userId: string): Promise<UserProfile>
+
+  @GET('/profiles')
+  @Paginated()
+  abstract getProfiles(@Query('page') page: number): Promise<PaginatedResult<UserProfile>>
+
+  @POST('/profile')
+  abstract createProfile(@Body() input: CreateProfileInput): Promise<UserProfile>
+
+  @PATCH('/profile/:userId')
+  abstract updateProfile(
+    @Param('userId') userId: string,
+    @Body() input: UpdateProfileInput
+  ): Promise<UserProfile>
+
+  @DELETE('/profile/:userId')
+  abstract deleteProfile(@Param('userId') userId: string): Promise<void>
+}
+```
+
+Then run:
+
+```bash
+spry build profile
+```
+
+Spry reads these decorators statically via the TypeScript AST — no runtime reflection or `reflect-metadata` required.
+
+## API Reference
+
+### Class Decorator
+
+| Decorator | Description |
+|-----------|-------------|
+| `@BaseURL(url)` | Base path prepended to all method paths |
+
+### Method Decorators (HTTP Verbs)
+
+| Decorator | Description |
+|-----------|-------------|
+| `@GET(path)` | HTTP GET request |
+| `@POST(path)` | HTTP POST request |
+| `@PATCH(path)` | HTTP PATCH request |
+| `@PUT(path)` | HTTP PUT request |
+| `@DELETE(path)` | HTTP DELETE request |
+
+### Method Decorators (Extras)
+
+| Decorator | Description |
+|-----------|-------------|
+| `@Cache(seconds)` | Sets `staleTime` in generated React Query hooks |
+| `@Paginated()` | Generates `useInfiniteQuery` instead of `useQuery` |
+
+### Parameter Decorators
+
+| Decorator | Description |
+|-----------|-------------|
+| `@Param(name)` | Path parameter (e.g., `:userId`) |
+| `@Query(name)` | Query string parameter (e.g., `?page=1`) |
+| `@Body()` | Request body |
+| `@Header(name)` | Request header |
+
+## How It Works
+
+These decorators are intentionally no-op at runtime — they simply return the original descriptor/target unchanged. The Spry CLI uses [ts-morph](https://ts-morph.com/) to read decorator metadata directly from the AST at build time, so there is zero runtime overhead.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+export declare function GET(_path: string): MethodDecorator;
+export declare function POST(_path: string): MethodDecorator;
+export declare function PATCH(_path: string): MethodDecorator;
+export declare function PUT(_path: string): MethodDecorator;
+export declare function DELETE(_path: string): MethodDecorator;
+export declare function Param(_name: string): ParameterDecorator;
+export declare function Query(_name: string): ParameterDecorator;
+export declare function Body(): ParameterDecorator;
+export declare function Header(_name: string): ParameterDecorator;
+export declare function BaseURL(_url: string): ClassDecorator;
+export declare function Cache(_seconds: number): MethodDecorator;
+export declare function Paginated(): MethodDecorator;
+//# 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":"AACA,wBAAgB,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,CAElD;AAED,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,CAEnD;AAED,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,CAEpD;AAED,wBAAgB,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,CAElD;AAED,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,CAErD;AAGD,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,CAEvD;AAED,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,CAEvD;AAED,wBAAgB,IAAI,IAAI,kBAAkB,CAEzC;AAED,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,CAExD;AAGD,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAEpD;AAGD,wBAAgB,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,CAEvD;AAED,wBAAgB,SAAS,IAAI,eAAe,CAE3C"}

package/dist/index.js

@@ -0,0 +1,41 @@
+// Method decorators — HTTP verb + path
+export function GET(_path) {
+    return (_target, _propertyKey, descriptor) => descriptor;
+}
+export function POST(_path) {
+    return (_target, _propertyKey, descriptor) => descriptor;
+}
+export function PATCH(_path) {
+    return (_target, _propertyKey, descriptor) => descriptor;
+}
+export function PUT(_path) {
+    return (_target, _propertyKey, descriptor) => descriptor;
+}
+export function DELETE(_path) {
+    return (_target, _propertyKey, descriptor) => descriptor;
+}
+// Parameter decorators
+export function Param(_name) {
+    return () => { };
+}
+export function Query(_name) {
+    return () => { };
+}
+export function Body() {
+    return () => { };
+}
+export function Header(_name) {
+    return () => { };
+}
+// Class decorator
+export function BaseURL(_url) {
+    return (target) => target;
+}
+// Extra method decorators
+export function Cache(_seconds) {
+    return (_target, _propertyKey, descriptor) => descriptor;
+}
+export function Paginated() {
+    return (_target, _propertyKey, descriptor) => descriptor;
+}
+//# 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,uCAAuC;AACvC,MAAM,UAAU,GAAG,CAAC,KAAa;IAC/B,OAAO,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,EAAE,CAAC,UAAU,CAAA;AAC1D,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,KAAa;IAChC,OAAO,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,EAAE,CAAC,UAAU,CAAA;AAC1D,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,KAAa;IACjC,OAAO,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,EAAE,CAAC,UAAU,CAAA;AAC1D,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,KAAa;IAC/B,OAAO,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,EAAE,CAAC,UAAU,CAAA;AAC1D,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,KAAa;IAClC,OAAO,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,EAAE,CAAC,UAAU,CAAA;AAC1D,CAAC;AAED,uBAAuB;AACvB,MAAM,UAAU,KAAK,CAAC,KAAa;IACjC,OAAO,GAAG,EAAE,GAAE,CAAC,CAAA;AACjB,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,KAAa;IACjC,OAAO,GAAG,EAAE,GAAE,CAAC,CAAA;AACjB,CAAC;AAED,MAAM,UAAU,IAAI;IAClB,OAAO,GAAG,EAAE,GAAE,CAAC,CAAA;AACjB,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,KAAa;IAClC,OAAO,GAAG,EAAE,GAAE,CAAC,CAAA;AACjB,CAAC;AAED,kBAAkB;AAClB,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAA;AAC3B,CAAC;AAED,0BAA0B;AAC1B,MAAM,UAAU,KAAK,CAAC,QAAgB;IACpC,OAAO,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,EAAE,CAAC,UAAU,CAAA;AAC1D,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,OAAO,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,EAAE,CAAC,UAAU,CAAA;AAC1D,CAAC"}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@spry-cli/decorators",
+  "version": "0.0.1",
+  "description": "TypeScript decorators for defining Spry repository contracts",
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/MerseniBilel/spry.git",
+    "directory": "packages/decorators"
+  },
+  "keywords": [
+    "spry",
+    "decorators",
+    "react-native",
+    "expo",
+    "clean-architecture",
+    "typescript",
+    "code-generation"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "lint": "eslint src/"
+  },
+  "devDependencies": {
+    "eslint": "10.2.0",
+    "typescript": "5.8.3"
+  }
+}