tspace-spear 1.2.5 → 1.2.6

package/dist/cli/index.js

@@ -0,0 +1,138 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const app_1 = require("./app");
+const controller_1 = require("./controller");
+const [, , action, type, target] = process.argv;
+switch (`${action}:${type}`) {
+    case "create:app":
+        createApp(target);
+        break;
+    case "create:controller":
+        createController(target);
+        break;
+    default:
+        console.log(`
+Usage:
+
+tspace-spear create app ./src
+tspace-spear create controller cats
+`);
+}
+function createApp(targetPath) {
+    if (!targetPath) {
+        console.log("Missing target path");
+        process.exit(1);
+    }
+    const root = path_1.default.resolve(process.cwd(), targetPath);
+    fs_1.default.mkdirSync(root, {
+        recursive: true
+    });
+    fs_1.default.mkdirSync(path_1.default.join(root, "controllers"), {
+        recursive: true
+    });
+    fs_1.default.writeFileSync(path_1.default.join(root, "index.ts"), app_1.app);
+    fs_1.default.writeFileSync(path_1.default.join(root, "controllers", "cat.controller.ts"), controller_1.CatController);
+    console.log(`App created at: ${root}`);
+}
+function createController(name) {
+    if (!name) {
+        console.log("Missing controller name");
+        process.exit(1);
+    }
+    const fileName = `${name}.controller.ts`;
+    const target = path_1.default.resolve(process.cwd(), "controllers", fileName);
+    fs_1.default.mkdirSync(path_1.default.dirname(target), {
+        recursive: true
+    });
+    const className = capitalize(name) + "Controller";
+    fs_1.default.writeFileSync(target, `
+import {
+  type T,
+  Controller,
+  Get,
+  Post,
+  Put,
+  Delete
+} from "tspace-spear";
+
+@Controller("/${name}")
+export default class ${className} {
+
+  @Get("/")
+  async index() {
+
+    return {};
+  }
+
+  @Get("/:id")
+  async show({
+    params
+  }: T.Context<{
+    params: {
+      id: number;
+    };
+  }>) {
+
+    return {
+      id: params.id
+    };
+  }
+
+  @Post("/")
+  async create({
+    body
+  }: T.Context<{
+    body: {};
+  }>) {
+
+    return {
+      body
+    };
+  }
+
+  @Put("/:id")
+  async update({
+    params,
+    body
+  }: T.Context<{
+    params: {
+      id: number;
+    };
+    body: {};
+  }>) {
+
+    return {
+      id: params.id,
+      body
+    };
+  }
+
+  @Delete("/:id")
+  async remove({
+    params
+  }: T.Context<{
+    params: {
+      id: number;
+    };
+  }>) {
+
+    return {
+      id: params.id
+    };
+  }
+
+}
+`);
+    console.log(`Controller created: ${fileName}`);
+}
+function capitalize(value) {
+    return (value.charAt(0).toUpperCase() +
+        value.slice(1));
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";;;;;;AAEA,4CAAoB;AACpB,gDAAwB;AACxB,+BAA4B;AAC5B,6CAA6C;AAE7C,MAAM,CAAC,EAAE,AAAD,EAAG,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;AAEhD,QAAQ,GAAG,MAAM,IAAI,IAAI,EAAE,EAAE,CAAC;IAE5B,KAAK,YAAY;QACf,SAAS,CAAC,MAAM,CAAC,CAAC;QAClB,MAAM;IAER,KAAK,mBAAmB;QACtB,gBAAgB,CAAC,MAAM,CAAC,CAAC;QACzB,MAAM;IAER;QACE,OAAO,CAAC,GAAG,CAAC;;;;;CAKf,CAAC,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,UAAmB;IAEpC,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;QACnC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,IAAI,GAAG,cAAI,CAAC,OAAO,CACvB,OAAO,CAAC,GAAG,EAAE,EACb,UAAU,CACX,CAAC;IAEF,YAAE,CAAC,SAAS,CAAC,IAAI,EAAE;QACjB,SAAS,EAAE,IAAI;KAChB,CAAC,CAAC;IAEH,YAAE,CAAC,SAAS,CACV,cAAI,CAAC,IAAI,CAAC,IAAI,EAAE,aAAa,CAAC,EAC9B;QACE,SAAS,EAAE,IAAI;KAChB,CACF,CAAC;IAEF,YAAE,CAAC,aAAa,CACd,cAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,EAC3B,SAAG,CACJ,CAAC;IAEF,YAAE,CAAC,aAAa,CACd,cAAI,CAAC,IAAI,CACP,IAAI,EACJ,aAAa,EACb,mBAAmB,CACpB,EAAC,0BAAa,CAChB,CAAC;IAEF,OAAO,CAAC,GAAG,CACT,mBAAmB,IAAI,EAAE,CAC1B,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAa;IAErC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;QACvC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,QAAQ,GACZ,GAAG,IAAI,gBAAgB,CAAC;IAE1B,MAAM,MAAM,GAAG,cAAI,CAAC,OAAO,CACzB,OAAO,CAAC,GAAG,EAAE,EACb,aAAa,EACb,QAAQ,CACT,CAAC;IAEF,YAAE,CAAC,SAAS,CACV,cAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EACpB;QACE,SAAS,EAAE,IAAI;KAChB,CACF,CAAC;IAEF,MAAM,SAAS,GACb,UAAU,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC;IAElC,YAAE,CAAC,aAAa,CACd,MAAM,EACV;;;;;;;;;;gBAUgB,IAAI;uBACG,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkE/B,CACE,CAAC;IAEF,OAAO,CAAC,GAAG,CACT,uBAAuB,QAAQ,EAAE,CAClC,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CACjB,KAAa;IAEb,OAAO,CACL,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE;QAC7B,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CACf,CAAC;AACJ,CAAC"}

package/dist/lib/core/client/index.d.ts

@@ -0,0 +1,82 @@
+import type { AnyRoutes, RoutesWithMethod, RequestBody, RequestQuery, RequestParams, RequestFiles, ResponseType } from "../compiler/types";
+type RequestInput<TRoutes extends AnyRoutes, TPath extends keyof TRoutes, TMethod extends keyof TRoutes[TPath]> = RequestParams<TRoutes, TPath, TMethod> extends never ? {
+    params?: never;
+    query?: RequestQuery<TRoutes, TPath, TMethod>;
+    body?: RequestBody<TRoutes, TPath, TMethod>;
+    files?: RequestFiles<TRoutes, TPath, TMethod>;
+} : {
+    params: RequestParams<TRoutes, TPath, TMethod>;
+    query?: RequestQuery<TRoutes, TPath, TMethod>;
+    body?: RequestBody<TRoutes, TPath, TMethod>;
+    files?: RequestFiles<TRoutes, TPath, TMethod>;
+};
+/**
+ * Type-safe HTTP client built on top of the native Fetch API.
+ *
+ * `ApiClient` provides end-to-end type safety for your API routes,
+ * including:
+ *
+ * - `params` typing
+ * - `query` typing
+ * - `body` typing
+ * - typed file uploads
+ * - fully inferred response types
+ *
+ * Route types are inferred from your server route definitions,
+ * giving you autocomplete and compile-time validation across
+ * the entire request lifecycle.
+ *
+ * @template TRoutes Application route definitions.
+ *
+ * @example
+ * ```ts
+ * import app from '../server/app';
+ *
+ * const client = new ApiClient<typeof app.contract>()
+ *
+ * const res = await client.get("/cats", {
+ *   query: {
+ *     id: "1",
+ *   },
+ * })
+ *
+ * // fully typed response
+ * console.log(res.cats)
+ * ```
+ */
+declare class ApiClient<TRoutes extends AnyRoutes> {
+    private baseURL;
+    constructor(baseURL: string);
+    protected request<TPath extends keyof TRoutes, TMethod extends keyof TRoutes[TPath]>(method: TMethod, path: TPath, input?: RequestInput<TRoutes, TPath, TMethod>): Promise<{
+        ok: boolean;
+        status: number;
+        data: ResponseType<TRoutes, TPath, TMethod>;
+    }>;
+    get<TPath extends RoutesWithMethod<TRoutes, "GET">>(path: TPath, input?: RequestInput<TRoutes, TPath, "GET">): Promise<{
+        ok: boolean;
+        status: number;
+        data: ResponseType<TRoutes, TPath, "GET">;
+    }>;
+    post<TPath extends RoutesWithMethod<TRoutes, "POST">>(path: TPath, input: RequestInput<TRoutes, TPath, "POST">): Promise<{
+        ok: boolean;
+        status: number;
+        data: ResponseType<TRoutes, TPath, "POST">;
+    }>;
+    put<TPath extends RoutesWithMethod<TRoutes, "PUT">>(path: TPath, input: RequestInput<TRoutes, TPath, "PUT">): Promise<{
+        ok: boolean;
+        status: number;
+        data: ResponseType<TRoutes, TPath, "PUT">;
+    }>;
+    patch<TPath extends RoutesWithMethod<TRoutes, "PATCH">>(path: TPath, input: RequestInput<TRoutes, TPath, "PATCH">): Promise<{
+        ok: boolean;
+        status: number;
+        data: ResponseType<TRoutes, TPath, "PATCH">;
+    }>;
+    delete<TPath extends RoutesWithMethod<TRoutes, "DELETE">>(path: TPath, input?: RequestInput<TRoutes, TPath, "DELETE">): Promise<{
+        ok: boolean;
+        status: number;
+        data: ResponseType<TRoutes, TPath, "DELETE">;
+    }>;
+}
+export { ApiClient };
+export default ApiClient;

package/dist/lib/core/client/index.js

@@ -0,0 +1,142 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApiClient = void 0;
+let fetchFn = null;
+async function getFetch() {
+    if (fetchFn)
+        return fetchFn;
+    if (globalThis.fetch) {
+        fetchFn = globalThis.fetch;
+        return fetchFn;
+    }
+    const mod = await Promise.resolve().then(() => __importStar(require("node-fetch")));
+    fetchFn = mod.default;
+    return fetchFn;
+}
+/**
+ * Type-safe HTTP client built on top of the native Fetch API.
+ *
+ * `ApiClient` provides end-to-end type safety for your API routes,
+ * including:
+ *
+ * - `params` typing
+ * - `query` typing
+ * - `body` typing
+ * - typed file uploads
+ * - fully inferred response types
+ *
+ * Route types are inferred from your server route definitions,
+ * giving you autocomplete and compile-time validation across
+ * the entire request lifecycle.
+ *
+ * @template TRoutes Application route definitions.
+ *
+ * @example
+ * ```ts
+ * import app from '../server/app';
+ *
+ * const client = new ApiClient<typeof app.contract>()
+ *
+ * const res = await client.get("/cats", {
+ *   query: {
+ *     id: "1",
+ *   },
+ * })
+ *
+ * // fully typed response
+ * console.log(res.cats)
+ * ```
+ */
+class ApiClient {
+    baseURL;
+    constructor(baseURL) {
+        this.baseURL = baseURL;
+    }
+    async request(method, path, input) {
+        let url = this.baseURL + path;
+        if (input?.params) {
+            for (const key in input.params) {
+                url = url.replace(`:${key}`, encodeURIComponent(input.params[key]));
+            }
+        }
+        if (input?.query) {
+            const queryString = new URLSearchParams(input.query).toString();
+            if (queryString) {
+                url += `?${queryString}`;
+            }
+        }
+        fetchFn = await getFetch();
+        if (!fetchFn) {
+            throw new Error("Fetch is not available. Use Node 18+ or polyfill.");
+        }
+        const res = await fetchFn(url, {
+            method: method,
+            headers: {
+                "Content-Type": "application/json",
+            },
+            body: input?.body
+                ? JSON.stringify(input.body)
+                : undefined,
+        });
+        const contentType = res.headers.get("content-type");
+        const isJson = contentType?.includes("application/json");
+        const data = isJson
+            ? await res.json()
+            : await res.text();
+        // if (!res.ok) {
+        //   throw new Error(
+        //     data?.message ||
+        //       data?.error ||
+        //       (typeof data === "string"
+        //         ? data
+        //         : `HTTP ${res.status}`),
+        //   );
+        // }
+        return {
+            ok: res.ok,
+            status: res.status,
+            data,
+        };
+    }
+    async get(path, input) {
+        return this.request("GET", path, input);
+    }
+    async post(path, input) {
+        return this.request("POST", path, input);
+    }
+    async put(path, input) {
+        return this.request("PUT", path, input);
+    }
+    async patch(path, input) {
+        return this.request("PATCH", path, input);
+    }
+    async delete(path, input) {
+        return this.request("DELETE", path, input);
+    }
+}
+exports.ApiClient = ApiClient;
+exports.default = ApiClient;
+//# sourceMappingURL=index.js.map

package/dist/lib/core/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/core/client/index.ts"],"names":[],"mappings":"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"}

package/dist/lib/core/compiler/generator.d.ts

@@ -0,0 +1,18 @@
+type Route = {
+    method: string;
+    path: string;
+    response: string;
+    body: string;
+    params: string;
+    query: string;
+    files: string;
+};
+type Options = {
+    controllers: {
+        folder: string;
+        name: RegExp;
+    };
+    output?: string;
+};
+export declare function generateRoutes(options: Options): Promise<Route[] | undefined>;
+export {};