@ir-kit/openapi-tools 0.1.0

package/dist/route.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=route.js.map

package/dist/route.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route.js","sourceRoot":"","sources":["../src/route.ts"],"names":[],"mappings":""}

package/dist/router.d.ts

@@ -0,0 +1,22 @@
+import type { ExtractParams } from "./match.js";
+import type { Route } from "./route.js";
+type RouteHandler<R extends Route, TResult = unknown> = (request: Request, params: ExtractParams<R["spec"]>) => TResult | Promise<TResult>;
+export interface Router {
+    /** Register a handler for a route. Handler's `params` is typed from the route's `spec`. */
+    on<R extends Route>(route: R, handler: RouteHandler<R>): Router;
+    /** Match + dispatch. Returns handler's return value, or `undefined` if unmatched. */
+    handle(request: Request): Promise<unknown> | undefined;
+}
+/**
+ * Create a router that dispatches matched requests to typed handlers.
+ *
+ * @example
+ * ```ts
+ * createRouter()
+ *   .on(getPetByIdRoute, (req, { petId }) => fetchPet(petId))
+ *   .handle(request);
+ * ```
+ */
+export declare function createRouter(): Router;
+export {};
+//# sourceMappingURL=router.d.ts.map

package/dist/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,KAAK,YAAY,CAAC,CAAC,SAAS,KAAK,EAAE,OAAO,GAAG,OAAO,IAAI,CACtD,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,KAC7B,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAEhC,MAAM,WAAW,MAAM;IACrB,2FAA2F;IAC3F,EAAE,CAAC,CAAC,SAAS,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC;IAChE,qFAAqF;IACrF,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC;CACxD;AAMD;;;;;;;;;GASG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAwBrC"}

package/dist/router.js

@@ -0,0 +1,40 @@
+import { match } from "./match.js";
+function key(method, spec) {
+    return `${method.toLowerCase()} ${spec}`;
+}
+/**
+ * Create a router that dispatches matched requests to typed handlers.
+ *
+ * @example
+ * ```ts
+ * createRouter()
+ *   .on(getPetByIdRoute, (req, { petId }) => fetchPet(petId))
+ *   .handle(request);
+ * ```
+ */
+export function createRouter() {
+    // Reassign (not push) so the array identity changes and `match()`'s WeakMap cache busts.
+    let routes = [];
+    // biome-ignore lint/suspicious/noExplicitAny: handler stored generically
+    const handlers = new Map();
+    const router = {
+        on(route, handler) {
+            routes = [...routes, route];
+            handlers.set(key(route.method, route.spec), handler);
+            return router;
+        },
+        handle(request) {
+            const m = match(routes, request);
+            if (!m)
+                return undefined;
+            const handler = handlers.get(key(m.method, m.spec));
+            if (!handler)
+                return undefined;
+            return Promise.resolve(
+            // biome-ignore lint/suspicious/noExplicitAny: erasure at boundary
+            handler(request, m.params));
+        },
+    };
+    return router;
+}
+//# sourceMappingURL=router.js.map

package/dist/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAenC,SAAS,GAAG,CAAC,MAAc,EAAE,IAAY;IACvC,OAAO,GAAG,MAAM,CAAC,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC;AAC3C,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,YAAY;IAC1B,yFAAyF;IACzF,IAAI,MAAM,GAAqB,EAAE,CAAC;IAClC,yEAAyE;IACzE,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAoC,CAAC;IAE7D,MAAM,MAAM,GAAW;QACrB,EAAE,CAAC,KAAK,EAAE,OAAO;YACf,MAAM,GAAG,CAAC,GAAG,MAAM,EAAE,KAAK,CAAC,CAAC;YAC5B,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,OAAgB,CAAC,CAAC;YAC9D,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,MAAM,CAAC,OAAO;YACZ,MAAM,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YACjC,IAAI,CAAC,CAAC;gBAAE,OAAO,SAAS,CAAC;YACzB,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;YACpD,IAAI,CAAC,OAAO;gBAAE,OAAO,SAAS,CAAC;YAC/B,OAAO,OAAO,CAAC,OAAO;YACpB,kEAAkE;YAClE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,MAAa,CAAC,CAClC,CAAC;QACJ,CAAC;KACF,CAAC;IACF,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/schema.d.ts

@@ -0,0 +1,7 @@
+import type { IR } from "@hey-api/shared";
+export type EnumLiteral = string | number | boolean;
+export declare function getEnumLiterals(schema: IR.SchemaObject): EnumLiteral[];
+export declare function isEnumSchema(schema: IR.SchemaObject): boolean;
+/** anyOf / oneOf / allOf — items present, concrete type absent. */
+export declare function isUnionSchema(schema: IR.SchemaObject): boolean;
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,iBAAiB,CAAC;AAE1C,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAEpD,wBAAgB,eAAe,CAAC,MAAM,EAAE,EAAE,CAAC,YAAY,GAAG,WAAW,EAAE,CAStE;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,EAAE,CAAC,YAAY,GAAG,OAAO,CAE7D;AAED,mEAAmE;AACnE,wBAAgB,aAAa,CAAC,MAAM,EAAE,EAAE,CAAC,YAAY,GAAG,OAAO,CAE9D"}

package/dist/schema.js

@@ -0,0 +1,15 @@
+export function getEnumLiterals(schema) {
+    return (schema.items ?? [])
+        .map((i) => i.const)
+        .filter((v) => typeof v === "string" ||
+        typeof v === "number" ||
+        typeof v === "boolean");
+}
+export function isEnumSchema(schema) {
+    return schema.type === "enum";
+}
+/** anyOf / oneOf / allOf — items present, concrete type absent. */
+export function isUnionSchema(schema) {
+    return Boolean(schema.items && schema.items.length > 0 && !schema.type);
+}
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,eAAe,CAAC,MAAuB;IACrD,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;SACxB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;SACnB,MAAM,CACL,CAAC,CAAC,EAAoB,EAAE,CACtB,OAAO,CAAC,KAAK,QAAQ;QACrB,OAAO,CAAC,KAAK,QAAQ;QACrB,OAAO,CAAC,KAAK,SAAS,CACzB,CAAC;AACN,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAuB;IAClD,OAAO,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC;AAChC,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,aAAa,CAAC,MAAuB;IACnD,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAC1E,CAAC"}

package/package.json

@@ -0,0 +1,104 @@
+{
+  "name": "@ir-kit/openapi-tools",
+  "version": "0.1.0",
+  "description": "OpenAPI utilities — request matching, spec diffing, parsing. Tree-shakable, pure functions, works on frontend or backend",
+  "keywords": [
+    "openapi",
+    "matcher",
+    "url-pattern",
+    "diff",
+    "parser",
+    "spec",
+    "tooling",
+    "typescript"
+  ],
+  "homepage": "https://github.com/ir-kit/ir-kit/tree/main/packages/openapi/tools",
+  "bugs": {
+    "url": "https://github.com/ir-kit/ir-kit/issues"
+  },
+  "license": "MIT",
+  "author": {
+    "name": "Ahmed Rowaihi",
+    "email": "ahmedrowaihi@gmail.com"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ir-kit/ir-kit.git",
+    "directory": "packages/openapi/tools"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./match": {
+      "types": "./dist/match.d.ts",
+      "import": "./dist/match.js"
+    },
+    "./router": {
+      "types": "./dist/router.d.ts",
+      "import": "./dist/router.js"
+    },
+    "./parse": {
+      "types": "./dist/parse.d.ts",
+      "import": "./dist/parse.js"
+    },
+    "./diff": {
+      "types": "./dist/diff.d.ts",
+      "import": "./dist/diff.js"
+    },
+    "./ir": {
+      "types": "./dist/ir.d.ts",
+      "import": "./dist/ir.js"
+    },
+    "./route": {
+      "types": "./dist/route.d.ts",
+      "import": "./dist/route.js"
+    },
+    "./merge": {
+      "types": "./dist/merge.d.ts",
+      "import": "./dist/merge.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE.md"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "peerDependencies": {
+    "@hey-api/codegen-core": ">=0.7.0",
+    "@hey-api/shared": ">=0.3.0",
+    "@hey-api/spec-types": ">=0.2.0"
+  },
+  "dependencies": {
+    "@hey-api/json-schema-ref-parser": "^1.4.1",
+    "urlpattern-polyfill": "^10.1.0",
+    "@ir-kit/openapi-core": "0.1.0"
+  },
+  "devDependencies": {
+    "@hey-api/codegen-core": "^0.8.1",
+    "@hey-api/shared": "^0.4.2",
+    "@hey-api/spec-types": "^0.2.0",
+    "@types/node": "^22",
+    "vitest": "^4.0.0",
+    "@ir-kit/tsconfig": "0.0.0"
+  },
+  "engines": {
+    "node": ">=20.19.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "tsc -p tsconfig.build.json --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests"
+  }
+}