@m1kapp/kit 0.0.1

package/dist/server.d.mts

@@ -0,0 +1,71 @@
+declare class HttpError extends Error {
+    readonly status: number;
+    readonly body: unknown;
+    constructor(status: number, body: unknown);
+}
+/** 200 OK with JSON body */
+declare function ok<T>(data: T, status?: number): Response;
+/** 201 Created with JSON body */
+declare function created<T>(data: T): Response;
+/** 204 No Content */
+declare function noContent(): Response;
+/** 400 Bad Request — throw inside handler() */
+declare function badRequest(message?: string, errors?: unknown): never;
+/** 401 Unauthorized — throw inside handler() */
+declare function unauthorized(message?: string): never;
+/** 403 Forbidden — throw inside handler() */
+declare function forbidden(message?: string): never;
+/** 404 Not Found — throw inside handler() */
+declare function notFound(message?: string): never;
+/** 409 Conflict — throw inside handler() */
+declare function conflict(message?: string): never;
+/** 500 Internal Server Error — throw inside handler() */
+declare function serverError(message?: string): never;
+
+type NextRequest = Request;
+type RouteContext = {
+    params?: Record<string, string | string[]>;
+};
+/**
+ * Wraps a Next.js route handler with automatic error handling.
+ *
+ * - HttpError (thrown by unauthorized/notFound/etc.) → proper HTTP response
+ * - Any other thrown error → 500
+ * - No try/catch needed in your route
+ *
+ * @example
+ * export const GET = handler(async (req) => {
+ *   const user = await currentUser();
+ *   if (!user) unauthorized();          // throws → 401
+ *
+ *   const site = await db.sites.find(id);
+ *   if (!site) notFound("사이트 없음"); // throws → 404
+ *
+ *   return ok(site);
+ * });
+ */
+declare function handler(fn: (req: NextRequest, ctx?: RouteContext) => Promise<Response>): (req: NextRequest, ctx?: RouteContext) => Promise<Response>;
+
+type SafeOk<T> = {
+    ok: true;
+    data: T;
+    error: null;
+};
+type SafeErr = {
+    ok: false;
+    data: null;
+    error: Error;
+};
+type SafeResult<T> = SafeOk<T> | SafeErr;
+/**
+ * Runs an async function and returns a result object instead of throwing.
+ * Useful when you want to handle a specific error differently without a try/catch.
+ *
+ * @example
+ * const { ok: success, data, error } = await safely(() => db.users.find(id));
+ * if (!success) return serverError("DB 조회 실패");
+ * return ok(data);
+ */
+declare function safely<T>(fn: () => Promise<T>): Promise<SafeResult<T>>;
+
+export { HttpError, badRequest, conflict, created, forbidden, handler, noContent, notFound, ok, safely, serverError, unauthorized };

package/dist/server.d.ts

@@ -0,0 +1,71 @@
+declare class HttpError extends Error {
+    readonly status: number;
+    readonly body: unknown;
+    constructor(status: number, body: unknown);
+}
+/** 200 OK with JSON body */
+declare function ok<T>(data: T, status?: number): Response;
+/** 201 Created with JSON body */
+declare function created<T>(data: T): Response;
+/** 204 No Content */
+declare function noContent(): Response;
+/** 400 Bad Request — throw inside handler() */
+declare function badRequest(message?: string, errors?: unknown): never;
+/** 401 Unauthorized — throw inside handler() */
+declare function unauthorized(message?: string): never;
+/** 403 Forbidden — throw inside handler() */
+declare function forbidden(message?: string): never;
+/** 404 Not Found — throw inside handler() */
+declare function notFound(message?: string): never;
+/** 409 Conflict — throw inside handler() */
+declare function conflict(message?: string): never;
+/** 500 Internal Server Error — throw inside handler() */
+declare function serverError(message?: string): never;
+
+type NextRequest = Request;
+type RouteContext = {
+    params?: Record<string, string | string[]>;
+};
+/**
+ * Wraps a Next.js route handler with automatic error handling.
+ *
+ * - HttpError (thrown by unauthorized/notFound/etc.) → proper HTTP response
+ * - Any other thrown error → 500
+ * - No try/catch needed in your route
+ *
+ * @example
+ * export const GET = handler(async (req) => {
+ *   const user = await currentUser();
+ *   if (!user) unauthorized();          // throws → 401
+ *
+ *   const site = await db.sites.find(id);
+ *   if (!site) notFound("사이트 없음"); // throws → 404
+ *
+ *   return ok(site);
+ * });
+ */
+declare function handler(fn: (req: NextRequest, ctx?: RouteContext) => Promise<Response>): (req: NextRequest, ctx?: RouteContext) => Promise<Response>;
+
+type SafeOk<T> = {
+    ok: true;
+    data: T;
+    error: null;
+};
+type SafeErr = {
+    ok: false;
+    data: null;
+    error: Error;
+};
+type SafeResult<T> = SafeOk<T> | SafeErr;
+/**
+ * Runs an async function and returns a result object instead of throwing.
+ * Useful when you want to handle a specific error differently without a try/catch.
+ *
+ * @example
+ * const { ok: success, data, error } = await safely(() => db.users.find(id));
+ * if (!success) return serverError("DB 조회 실패");
+ * return ok(data);
+ */
+declare function safely<T>(fn: () => Promise<T>): Promise<SafeResult<T>>;
+
+export { HttpError, badRequest, conflict, created, forbidden, handler, noContent, notFound, ok, safely, serverError, unauthorized };

package/dist/server.js

@@ -0,0 +1 @@
+"use strict";var u=Object.defineProperty;var y=Object.getOwnPropertyDescriptor;var T=Object.getOwnPropertyNames;var m=Object.prototype.hasOwnProperty;var E=(e,r)=>{for(var o in r)u(e,o,{get:r[o],enumerable:!0})},b=(e,r,o,n)=>{if(r&&typeof r=="object"||typeof r=="function")for(let s of T(r))!m.call(e,s)&&s!==o&&u(e,s,{get:()=>r[s],enumerable:!(n=y(r,s))||n.enumerable});return e};var k=e=>b(u({},"__esModule",{value:!0}),e);var v={};E(v,{HttpError:()=>t,badRequest:()=>c,conflict:()=>x,created:()=>i,forbidden:()=>f,handler:()=>w,noContent:()=>p,notFound:()=>l,ok:()=>a,safely:()=>h,serverError:()=>R,unauthorized:()=>d});module.exports=k(v);var t=class extends Error{constructor(o,n){super(`HTTP ${o}`);this.status=o;this.body=n;this.name="HttpError"}};function a(e,r=200){return Response.json(e,{status:r})}function i(e){return Response.json(e,{status:201})}function p(){return new Response(null,{status:204})}function c(e="Bad Request",r){throw new t(400,{error:e,...r?{errors:r}:{}})}function d(e="Unauthorized"){throw new t(401,{error:e})}function f(e="Forbidden"){throw new t(403,{error:e})}function l(e="Not Found"){throw new t(404,{error:e})}function x(e="Conflict"){throw new t(409,{error:e})}function R(e="Internal Server Error"){throw new t(500,{error:e})}function w(e){return async(r,o)=>{try{return await e(r,o)}catch(n){return n instanceof t?Response.json(n.body,{status:n.status}):(console.error("[handler] Unhandled error:",n),Response.json({error:"Internal Server Error"},{status:500}))}}}async function h(e){try{return{ok:!0,data:await e(),error:null}}catch(r){return{ok:!1,data:null,error:r instanceof Error?r:new Error(String(r))}}}0&&(module.exports={HttpError,badRequest,conflict,created,forbidden,handler,noContent,notFound,ok,safely,serverError,unauthorized});

package/dist/server.mjs

@@ -0,0 +1 @@
+var t=class extends Error{constructor(n,o){super(`HTTP ${n}`);this.status=n;this.body=o;this.name="HttpError"}};function s(e,r=200){return Response.json(e,{status:r})}function u(e){return Response.json(e,{status:201})}function a(){return new Response(null,{status:204})}function i(e="Bad Request",r){throw new t(400,{error:e,...r?{errors:r}:{}})}function p(e="Unauthorized"){throw new t(401,{error:e})}function c(e="Forbidden"){throw new t(403,{error:e})}function d(e="Not Found"){throw new t(404,{error:e})}function f(e="Conflict"){throw new t(409,{error:e})}function l(e="Internal Server Error"){throw new t(500,{error:e})}function x(e){return async(r,n)=>{try{return await e(r,n)}catch(o){return o instanceof t?Response.json(o.body,{status:o.status}):(console.error("[handler] Unhandled error:",o),Response.json({error:"Internal Server Error"},{status:500}))}}}async function R(e){try{return{ok:!0,data:await e(),error:null}}catch(r){return{ok:!1,data:null,error:r instanceof Error?r:new Error(String(r))}}}export{t as HttpError,i as badRequest,f as conflict,u as created,c as forbidden,x as handler,a as noContent,d as notFound,s as ok,R as safely,l as serverError,p as unauthorized};

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@m1kapp/kit",
+  "version": "0.0.1",
+  "description": "UI, SEO, and PWA utilities for side projects",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.mjs",
+      "require": "./dist/server.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "rm -rf dist && mkdir -p .tmp && npx @tailwindcss/cli -i src/ui/styles.css -o .tmp/styles.css --minify && node scripts/embed-css.mjs && tsup",
+    "dev": "tsup --watch",
+    "lint": "tsc --noEmit",
+    "demo": "npm run build && cd demo && npm run dev",
+    "demo:dev": "cd demo && npm run dev"
+  },
+  "peerDependencies": {
+    "@vercel/og": ">=0.6",
+    "react": ">=18",
+    "react-dom": ">=18"
+  },
+  "peerDependenciesMeta": {
+    "@vercel/og": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@tailwindcss/cli": "^4.2.2",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "next": "^16.2.4",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "tailwindcss": "^4.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0"
+  },
+  "keywords": [
+    "react",
+    "ui",
+    "seo",
+    "pwa",
+    "mobile",
+    "side-project",
+    "m1k"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/m1kapp/kit.git"
+  },
+  "homepage": "https://m1k.app"
+}