chore(release): bump version

- @yme/[email protected]

Author: minosss

.editorconfig

@@ -0,0 +1,10 @@
+# http://editorconfig.org
+root = true
+
+[*]
+end_of_line = lf
+charset = utf-8
+insert_final_newline = true
+trim_trailing_whitespace = true
+indent_size = 2
+indent_style = space

.gitignore

@@ -0,0 +1,132 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+lerna-debug.log*
+.pnpm-debug.log*
+
+# Diagnostic reports (https://nodejs.org/api/report.html)
+report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Directory for instrumented libs generated by jscoverage/JSCover
+lib-cov
+
+# Coverage directory used by tools like istanbul
+coverage
+*.lcov
+
+# nyc test coverage
+.nyc_output
+
+# Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
+.grunt
+
+# Bower dependency directory (https://bower.io/)
+bower_components
+
+# node-waf configuration
+.lock-wscript
+
+# Compiled binary addons (https://nodejs.org/api/addons.html)
+build/Release
+
+# Dependency directories
+node_modules/
+jspm_packages/
+
+# Snowpack dependency directory (https://snowpack.dev/)
+web_modules/
+
+# TypeScript cache
+*.tsbuildinfo
+
+# Optional npm cache directory
+.npm
+
+# Optional eslint cache
+.eslintcache
+
+# Optional stylelint cache
+.stylelintcache
+
+# Microbundle cache
+.rpt2_cache/
+.rts2_cache_cjs/
+.rts2_cache_es/
+.rts2_cache_umd/
+
+# Optional REPL history
+.node_repl_history
+
+# Output of 'npm pack'
+*.tgz
+
+# Yarn Integrity file
+.yarn-integrity
+
+# dotenv environment variable files
+.env
+.env.development.local
+.env.test.local
+.env.production.local
+.env.local
+
+# parcel-bundler cache (https://parceljs.org/)
+.cache
+.parcel-cache
+
+# Next.js build output
+.next
+out
+
+# Nuxt.js build / generate output
+.nuxt
+dist
+
+# Gatsby files
+.cache/
+# Comment in the public line in if your project uses Gatsby and not Next.js
+# https://nextjs.org/blog/next-9-1#public-directory-support
+# public
+
+# vuepress build output
+.vuepress/dist
+
+# vuepress v2.x temp and cache directory
+.temp
+.cache
+
+# Docusaurus cache and generated files
+.docusaurus
+
+# Serverless directories
+.serverless/
+
+# FuseBox cache
+.fusebox/
+
+# DynamoDB Local files
+.dynamodb/
+
+# TernJS port file
+.tern-port
+
+# Stores VSCode versions used for testing VSCode extensions
+.vscode-test
+
+# yarn v2
+.yarn/cache
+.yarn/unplugged
+.yarn/build-state.yml
+.yarn/install-state.gz
+.pnp.*
+
+.turbo

api.gif

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) MINO <[email protected]>
+
+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.

license

@@ -0,0 +1,22 @@
+{
+  "private": true,
+  "scripts": {
+    "turbo": "turbo",
+    "build": "turbo run build",
+    "dev": "turbo run dev"
+  },
+  "devDependencies": {
+    "@types/node": "^20.8.2",
+    "@types/react": "^18.2.24",
+    "@types/react-dom": "^18.2.8",
+    "@yme/eslint-config-react": "^0.3.3",
+    "@yme/eslint-config-typescript": "^0.3.3",
+    "@yme/tsconfig": "^2.0.0",
+    "eslint": "^8.50.0",
+    "rimraf": "^5.0.5",
+    "tsup": "^7.2.0",
+    "turbo": "^1.10.14",
+    "bun-types": "^1.0.7",
+    "typescript": "^5.2.2"
+  }
+}

package.json

@@ -0,0 +1,3 @@
+module.exports = {
+  extends: ['@yme/typescript'],
+};

packages/api/.eslintrc.cjs

@@ -0,0 +1,41 @@
+{
+  "name": "@yme/api",
+  "description": "define type-safe API routes simply",
+  "version": "1.0.0",
+  "type": "module",
+  "sideEffects": false,
+  "author": "mino",
+  "repository": "minosss/api",
+  "license": "MIT",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "clean": "rimraf ./dist",
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test:types": "tsc --noEmit"
+  },
+  "engines": {
+    "node": ">=16"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

packages/api/package.json

@@ -0,0 +1,141 @@
+import type { AnyRouteDef, AnyRoute } from './router';
+import type { AnyParser, IsUnknown } from './types';
+import { getParser, isPlainObject } from './types';
+import { getRouteDef } from './router';
+import { createProxy } from './proxy';
+import { ApiError } from './error';
+
+export interface Register {
+  // api: typeof api
+}
+
+// export interface RoutesRegister {}
+
+export type AnyHttpClient = (config: any) => Promise<any>;
+export type RequestConfig = Register extends { api: { http: AnyHttpClient } }
+  ? Parameters<Register['api']['http']>[0]
+  : never;
+export type HttpClient = Register extends { api: ApiOptions }
+  ? Register['api']['http']
+  : AnyHttpClient;
+
+export interface Routes {
+  readonly [key: string]: AnyRoute | Routes;
+}
+
+type RouteToRequest<R extends AnyRoute> = IsUnknown<R['_def']['_input']> extends true
+  ? (input?: R['_def']['_input'], config?: RequestConfig) => Promise<R['_def']['_output']>
+  : (input: R['_def']['_input'], config?: RequestConfig) => Promise<R['_def']['_output']>;
+
+type ExtractRoutes<T> = T extends AnyRoute
+  ? RouteToRequest<T>
+  : T extends Routes
+    ? { [K in keyof T]: ExtractRoutes<T[K]> }
+    : never;
+
+export interface ApiOptions {
+  http: AnyHttpClient;
+  routes: Routes;
+  validator?(schema: AnyParser, input: unknown): unknown;
+  guard?(config: any, route: AnyRoute): boolean;
+  onSuccess?(output: any): void;
+  onError?(error: any): void;
+  onFinished?(config: any): void;
+}
+
+export type ApiClient<A extends ApiOptions> = ExtractRoutes<A['routes']> & {
+  http: A['http'];
+};
+
+export function createApi<A extends ApiOptions>(options: A): ApiClient<A> {
+  const { routes, http, validator, guard, onError, onFinished, onSuccess } = options;
+
+  return createProxy(async (opts) => {
+    // return http client
+    if (opts.path[0] === 'http') {
+      return http.call(http, opts.args);
+    }
+
+    const [input, config] = opts.args;
+    const parts = [...opts.path];
+
+    // route
+
+    let route: any;
+    for (const part of parts) {
+      route = (route || routes)[part];
+    }
+    const def = getRouteDef(route);
+    if (def == null) {
+      throw ApiError.from('Can not found route def.', ApiError.ERR_BAD_ROUTE, route);
+    }
+
+    const { path, method, schema, transform } = def as AnyRouteDef;
+
+    // input
+
+    let nextInput = validator ? validator(schema, input) : getParser(schema)(input);
+
+    // url
+
+    let url = path;
+    const pathParams = url.match(/:[\dA-Za-z]+/g);
+    if (pathParams) {
+      for (const pathParam of pathParams) {
+        const key = pathParam.slice(1);
+        if (isPlainObject(nextInput)) {
+          const value = nextInput[key];
+          if (typeof value === 'number' || typeof value === 'string') {
+            url = url.replace(pathParam, `${value}`);
+            delete nextInput[key];
+          } else {
+            throw ApiError.from(`Bad params ${key} data.`, ApiError.ERR_BAD_INPUT, route);
+          }
+        } else if (typeof nextInput === 'number' || typeof nextInput === 'string') {
+          url = url.replace(pathParam, `${nextInput}`);
+          nextInput = undefined;
+          break;
+        } else {
+          throw ApiError.from(`Bad params ${key} data.`, ApiError.ERR_BAD_INPUT, route);
+        }
+      }
+    }
+
+    // request config
+
+    const requestConfig: any = {
+      ...config,
+      method,
+      url,
+    };
+
+    if (['post', 'put', 'patch'].includes(method.toLowerCase())) {
+      requestConfig.data = nextInput;
+    } else {
+      requestConfig.params = nextInput;
+    }
+
+    // guard
+    if (guard) {
+      const isPass = guard(requestConfig, route);
+      if (isPass !== true) {
+        throw ApiError.from(`You don't have access to ${requestConfig.method} ${requestConfig.url}`, ApiError.ERR_ACCESS_DENIED, route);
+      }
+    }
+
+    // http request
+
+    try {
+      const response = await http(requestConfig);
+      const nextResponse = getParser(transform)(response);
+      onSuccess?.(nextResponse);
+      return nextResponse;
+    } catch (error) {
+      (error as any).request = requestConfig;
+      onError?.(error);
+      throw ApiError.from(error, ApiError.ERR_HTTP_ERROR);
+    } finally {
+      onFinished?.(requestConfig);
+    }
+  }, []) as any;
+}