@scalar/mock-server 0.7.2 → 0.8.0

package/dist/utils/build-seed-context.d.ts

@@ -0,0 +1,35 @@
+import { faker } from '@faker-js/faker';
+import { createStoreWrapper } from './store-wrapper.js';
+/**
+ * Seed helper function type.
+ */
+type SeedHelper = {
+    /**
+     * Create n items using a factory function.
+     */
+    count: (n: number, factory: () => any) => any[];
+    /**
+     * Create items from an array of objects.
+     */
+    (items: any[]): any[];
+    /**
+     * Create a single item using a factory function (shorthand for count(1, factory)).
+     */
+    (factory: () => any): any;
+};
+/**
+ * Context object provided to x-seed code.
+ */
+export type SeedContext = {
+    store: ReturnType<typeof createStoreWrapper>['wrappedStore'];
+    faker: typeof faker;
+    seed: SeedHelper;
+    schema: string;
+};
+/**
+ * Build the seed context with a seed helper function.
+ * The seed helper automatically uses the schema key as the collection name.
+ */
+export declare function buildSeedContext(schemaKey: string): SeedContext;
+export {};
+//# sourceMappingURL=build-seed-context.d.ts.map

package/dist/utils/build-seed-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-seed-context.d.ts","sourceRoot":"","sources":["../../src/utils/build-seed-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AAGvC,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAEpD;;GAEG;AACH,KAAK,UAAU,GAAG;IAChB;;OAEG;IACH,KAAK,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,KAAK,GAAG,EAAE,CAAA;IAC/C;;OAEG;IACH,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,GAAG,EAAE,CAAA;IACrB;;OAEG;IACH,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG,GAAG,CAAA;CAC1B,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,cAAc,CAAC,CAAA;IAC5D,KAAK,EAAE,OAAO,KAAK,CAAA;IACnB,IAAI,EAAE,UAAU,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,CAgE/D"}

package/dist/utils/build-seed-context.js

@@ -0,0 +1,53 @@
+import { faker } from "@faker-js/faker";
+import { store } from "../libs/store.js";
+import { createStoreWrapper } from "./store-wrapper.js";
+function buildSeedContext(schemaKey) {
+  const { wrappedStore } = createStoreWrapper(store);
+  const seedHelper = (arg1, arg2) => {
+    if (typeof arg1 === "number" && typeof arg2 === "function") {
+      const count = arg1;
+      const factory = arg2;
+      const items = [];
+      for (let i = 0; i < count; i++) {
+        const item = factory();
+        const created = wrappedStore.create(schemaKey, item);
+        items.push(created);
+      }
+      return items;
+    }
+    if (Array.isArray(arg1)) {
+      const items = [];
+      for (const item of arg1) {
+        const created = wrappedStore.create(schemaKey, item);
+        items.push(created);
+      }
+      return items;
+    }
+    if (typeof arg1 === "function") {
+      const factory = arg1;
+      const item = factory();
+      const created = wrappedStore.create(schemaKey, item);
+      return created;
+    }
+    throw new Error("Invalid seed() usage. Use seed.count(n, factory), seed(array), or seed(factory)");
+  };
+  seedHelper.count = (n, factory) => {
+    const items = [];
+    for (let i = 0; i < n; i++) {
+      const item = factory();
+      const created = wrappedStore.create(schemaKey, item);
+      items.push(created);
+    }
+    return items;
+  };
+  return {
+    store: wrappedStore,
+    faker,
+    seed: seedHelper,
+    schema: schemaKey
+  };
+}
+export {
+  buildSeedContext
+};
+//# sourceMappingURL=build-seed-context.js.map

package/dist/utils/build-seed-context.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/utils/build-seed-context.ts"],
+  "sourcesContent": ["import { faker } from '@faker-js/faker'\n\nimport { store } from '../libs/store'\nimport { createStoreWrapper } from './store-wrapper'\n\n/**\n * Seed helper function type.\n */\ntype SeedHelper = {\n  /**\n   * Create n items using a factory function.\n   */\n  count: (n: number, factory: () => any) => any[]\n  /**\n   * Create items from an array of objects.\n   */\n  (items: any[]): any[]\n  /**\n   * Create a single item using a factory function (shorthand for count(1, factory)).\n   */\n  (factory: () => any): any\n}\n\n/**\n * Context object provided to x-seed code.\n */\nexport type SeedContext = {\n  store: ReturnType<typeof createStoreWrapper>['wrappedStore']\n  faker: typeof faker\n  seed: SeedHelper\n  schema: string\n}\n\n/**\n * Build the seed context with a seed helper function.\n * The seed helper automatically uses the schema key as the collection name.\n */\nexport function buildSeedContext(schemaKey: string): SeedContext {\n  const { wrappedStore } = createStoreWrapper(store)\n\n  /**\n   * Seed helper function that provides a Laravel-inspired API.\n   */\n  const seedHelper = ((arg1: number | any[] | (() => any), arg2?: () => any) => {\n    // Case 1: seed.count(n, factory)\n    if (typeof arg1 === 'number' && typeof arg2 === 'function') {\n      const count = arg1\n      const factory = arg2\n      const items: any[] = []\n\n      for (let i = 0; i < count; i++) {\n        const item = factory()\n        const created = wrappedStore.create(schemaKey, item)\n        items.push(created)\n      }\n\n      return items\n    }\n\n    // Case 2: seed(array)\n    if (Array.isArray(arg1)) {\n      const items: any[] = []\n\n      for (const item of arg1) {\n        const created = wrappedStore.create(schemaKey, item)\n        items.push(created)\n      }\n\n      return items\n    }\n\n    // Case 3: seed(factory) - single item\n    if (typeof arg1 === 'function') {\n      const factory = arg1\n      const item = factory()\n      const created = wrappedStore.create(schemaKey, item)\n      return created\n    }\n\n    throw new Error('Invalid seed() usage. Use seed.count(n, factory), seed(array), or seed(factory)')\n  }) as SeedHelper\n\n  // Add count method to the function\n  seedHelper.count = (n: number, factory: () => any) => {\n    const items: any[] = []\n\n    for (let i = 0; i < n; i++) {\n      const item = factory()\n      const created = wrappedStore.create(schemaKey, item)\n      items.push(created)\n    }\n\n    return items\n  }\n\n  return {\n    store: wrappedStore,\n    faker,\n    seed: seedHelper,\n    schema: schemaKey,\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,aAAa;AAEtB,SAAS,aAAa;AACtB,SAAS,0BAA0B;AAkC5B,SAAS,iBAAiB,WAAgC;AAC/D,QAAM,EAAE,aAAa,IAAI,mBAAmB,KAAK;AAKjD,QAAM,aAAc,CAAC,MAAoC,SAAqB;AAE5E,QAAI,OAAO,SAAS,YAAY,OAAO,SAAS,YAAY;AAC1D,YAAM,QAAQ;AACd,YAAM,UAAU;AAChB,YAAM,QAAe,CAAC;AAEtB,eAAS,IAAI,GAAG,IAAI,OAAO,KAAK;AAC9B,cAAM,OAAO,QAAQ;AACrB,cAAM,UAAU,aAAa,OAAO,WAAW,IAAI;AACnD,cAAM,KAAK,OAAO;AAAA,MACpB;AAEA,aAAO;AAAA,IACT;AAGA,QAAI,MAAM,QAAQ,IAAI,GAAG;AACvB,YAAM,QAAe,CAAC;AAEtB,iBAAW,QAAQ,MAAM;AACvB,cAAM,UAAU,aAAa,OAAO,WAAW,IAAI;AACnD,cAAM,KAAK,OAAO;AAAA,MACpB;AAEA,aAAO;AAAA,IACT;AAGA,QAAI,OAAO,SAAS,YAAY;AAC9B,YAAM,UAAU;AAChB,YAAM,OAAO,QAAQ;AACrB,YAAM,UAAU,aAAa,OAAO,WAAW,IAAI;AACnD,aAAO;AAAA,IACT;AAEA,UAAM,IAAI,MAAM,iFAAiF;AAAA,EACnG;AAGA,aAAW,QAAQ,CAAC,GAAW,YAAuB;AACpD,UAAM,QAAe,CAAC;AAEtB,aAAS,IAAI,GAAG,IAAI,GAAG,KAAK;AAC1B,YAAM,OAAO,QAAQ;AACrB,YAAM,UAAU,aAAa,OAAO,WAAW,IAAI;AACnD,YAAM,KAAK,OAAO;AAAA,IACpB;AAEA,WAAO;AAAA,EACT;AAEA,SAAO;AAAA,IACL,OAAO;AAAA,IACP;AAAA,IACA,MAAM;AAAA,IACN,QAAQ;AAAA,EACV;AACF;",
+  "names": []
+}

package/dist/utils/execute-handler.d.ts

@@ -0,0 +1,14 @@
+import type { HandlerContext } from './build-handler-context.js';
+/**
+ * Result of executing a handler, including the result and operation tracking.
+ */
+type HandlerExecutionResult = {
+    result: any;
+};
+/**
+ * Execute handler code in a sandboxed environment.
+ * The code has access only to the provided context (store, faker, req, res).
+ */
+export declare function executeHandler(code: string, context: HandlerContext): Promise<HandlerExecutionResult>;
+export {};
+//# sourceMappingURL=execute-handler.d.ts.map

package/dist/utils/execute-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-handler.d.ts","sourceRoot":"","sources":["../../src/utils/execute-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAE7D;;GAEG;AACH,KAAK,sBAAsB,GAAG;IAC5B,MAAM,EAAE,GAAG,CAAA;CACZ,CAAA;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAqB3G"}

package/dist/utils/execute-handler.js

@@ -0,0 +1,20 @@
+async function executeHandler(code, context) {
+  const handlerFunction = new Function(
+    "store",
+    "faker",
+    "req",
+    "res",
+    `
+    ${code}
+  `
+  );
+  const result = handlerFunction(context.store, context.faker, context.req, context.res);
+  if (result instanceof Promise) {
+    return { result: await result };
+  }
+  return { result };
+}
+export {
+  executeHandler
+};
+//# sourceMappingURL=execute-handler.js.map

package/dist/utils/execute-handler.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/utils/execute-handler.ts"],
+  "sourcesContent": ["import type { HandlerContext } from './build-handler-context'\n\n/**\n * Result of executing a handler, including the result and operation tracking.\n */\ntype HandlerExecutionResult = {\n  result: any\n}\n\n/**\n * Execute handler code in a sandboxed environment.\n * The code has access only to the provided context (store, faker, req, res).\n */\nexport async function executeHandler(code: string, context: HandlerContext): Promise<HandlerExecutionResult> {\n  // Create a function that executes the handler code with the context\n  // Using Function constructor to create a sandboxed environment\n  // The code is wrapped in a function body that returns the result\n  const handlerFunction = new Function(\n    'store',\n    'faker',\n    'req',\n    'res',\n    `\n    ${code}\n  `,\n  )\n  const result = handlerFunction(context.store, context.faker, context.req, context.res)\n\n  // If the result is a Promise, await it\n  if (result instanceof Promise) {\n    return { result: await result }\n  }\n\n  return { result }\n}\n"],
+  "mappings": "AAaA,eAAsB,eAAe,MAAc,SAA0D;AAI3G,QAAM,kBAAkB,IAAI;AAAA,IAC1B;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,MACE,IAAI;AAAA;AAAA,EAER;AACA,QAAM,SAAS,gBAAgB,QAAQ,OAAO,QAAQ,OAAO,QAAQ,KAAK,QAAQ,GAAG;AAGrF,MAAI,kBAAkB,SAAS;AAC7B,WAAO,EAAE,QAAQ,MAAM,OAAO;AAAA,EAChC;AAEA,SAAO,EAAE,OAAO;AAClB;",
+  "names": []
+}

package/dist/utils/execute-seed.d.ts

@@ -0,0 +1,14 @@
+import type { SeedContext } from './build-seed-context.js';
+/**
+ * Result of executing a seed handler.
+ */
+type SeedExecutionResult = {
+    result: any;
+};
+/**
+ * Execute seed code in a sandboxed environment.
+ * The code has access only to the provided context (store, faker, seed, schema).
+ */
+export declare function executeSeed(code: string, context: SeedContext): Promise<SeedExecutionResult>;
+export {};
+//# sourceMappingURL=execute-seed.d.ts.map

package/dist/utils/execute-seed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-seed.d.ts","sourceRoot":"","sources":["../../src/utils/execute-seed.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAEvD;;GAEG;AACH,KAAK,mBAAmB,GAAG;IACzB,MAAM,EAAE,GAAG,CAAA;CACZ,CAAA;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA4BlG"}

package/dist/utils/execute-seed.js

@@ -0,0 +1,24 @@
+async function executeSeed(code, context) {
+  const seedFunction = new Function(
+    "store",
+    "faker",
+    "seed",
+    "schema",
+    `
+    ${code}
+  `
+  );
+  try {
+    const result = seedFunction(context.store, context.faker, context.seed, context.schema);
+    if (result instanceof Promise) {
+      return { result: await result };
+    }
+    return { result };
+  } catch (error) {
+    throw error;
+  }
+}
+export {
+  executeSeed
+};
+//# sourceMappingURL=execute-seed.js.map

package/dist/utils/execute-seed.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/utils/execute-seed.ts"],
+  "sourcesContent": ["import type { SeedContext } from './build-seed-context'\n\n/**\n * Result of executing a seed handler.\n */\ntype SeedExecutionResult = {\n  result: any\n}\n\n/**\n * Execute seed code in a sandboxed environment.\n * The code has access only to the provided context (store, faker, seed, schema).\n */\nexport async function executeSeed(code: string, context: SeedContext): Promise<SeedExecutionResult> {\n  // Create a function that executes the seed code with the context\n  // Using Function constructor to create a sandboxed environment\n  // The code is wrapped in a function body that returns the result\n  const seedFunction = new Function(\n    'store',\n    'faker',\n    'seed',\n    'schema',\n    `\n    ${code}\n  `,\n  )\n\n  // Execute the seed function with the context\n  try {\n    const result = seedFunction(context.store, context.faker, context.seed, context.schema)\n\n    // If the result is a Promise, await it\n    if (result instanceof Promise) {\n      return { result: await result }\n    }\n\n    return { result }\n  } catch (error) {\n    // Re-throw to be caught by the caller\n    throw error\n  }\n}\n"],
+  "mappings": "AAaA,eAAsB,YAAY,MAAc,SAAoD;AAIlG,QAAM,eAAe,IAAI;AAAA,IACvB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,MACE,IAAI;AAAA;AAAA,EAER;AAGA,MAAI;AACF,UAAM,SAAS,aAAa,QAAQ,OAAO,QAAQ,OAAO,QAAQ,MAAM,QAAQ,MAAM;AAGtF,QAAI,kBAAkB,SAAS;AAC7B,aAAO,EAAE,QAAQ,MAAM,OAAO;AAAA,IAChC;AAEA,WAAO,EAAE,OAAO;AAAA,EAClB,SAAS,OAAO;AAEd,UAAM;AAAA,EACR;AACF;",
+  "names": []
+}

package/dist/utils/get-operation.d.ts

@@ -1,8 +1,8 @@
-import type { OpenAPI, OpenAPIV2, OpenAPIV3, OpenAPIV3_1 } from '@scalar/openapi-types';
+import type { OpenAPIV3_1 } from '@scalar/openapi-types';
 import { type HttpMethod } from '../types.js';
 /**
  * Takes a dereferenced OpenAPI document and returns all operations.
  * Ignores other attributes, like summary, parameters, etc.
  */
-export declare function getOperations(path?: OpenAPIV2.PathItemObject | OpenAPIV3.PathItemObject | OpenAPIV3_1.PathItemObject): Record<HttpMethod, OpenAPI.Operation>;
+export declare function getOperations(path?: OpenAPIV3_1.PathItemObject): Record<HttpMethod, OpenAPIV3_1.OperationObject>;
 //# sourceMappingURL=get-operation.d.ts.map

package/dist/utils/get-operation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-operation.d.ts","sourceRoot":"","sources":["../../src/utils/get-operation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAEvF,OAAO,EAAE,KAAK,UAAU,EAAe,MAAM,SAAS,CAAA;AAEtD;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,IAAI,CAAC,EAAE,SAAS,CAAC,cAAc,GAAG,SAAS,CAAC,cAAc,GAAG,WAAW,CAAC,cAAc,GACtF,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,SAAS,CAAC,CAUvC"}
+{"version":3,"file":"get-operation.d.ts","sourceRoot":"","sources":["../../src/utils/get-operation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAExD,OAAO,EAAE,KAAK,UAAU,EAAe,MAAM,SAAS,CAAA;AAEtD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC,cAAc,GAAG,MAAM,CAAC,UAAU,EAAE,WAAW,CAAC,eAAe,CAAC,CAUhH"}

package/dist/utils/get-operation.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/utils/get-operation.ts"],
-  "sourcesContent": ["import type { OpenAPI, OpenAPIV2, OpenAPIV3, OpenAPIV3_1 } from '@scalar/openapi-types'\n\nimport { type HttpMethod, httpMethods } from '@/types'\n\n/**\n * Takes a dereferenced OpenAPI document and returns all operations.\n * Ignores other attributes, like summary, parameters, etc.\n */\nexport function getOperations(\n  path?: OpenAPIV2.PathItemObject | OpenAPIV3.PathItemObject | OpenAPIV3_1.PathItemObject,\n): Record<HttpMethod, OpenAPI.Operation> {\n  const operations = {} as Record<HttpMethod, OpenAPI.Operation>\n\n  for (const method of httpMethods) {\n    if (path?.[method]) {\n      operations[method] = path?.[method]\n    }\n  }\n\n  return operations\n}\n"],
-  "mappings": "AAEA,SAA0B,mBAAmB;AAMtC,SAAS,cACd,MACuC;AACvC,QAAM,aAAa,CAAC;AAEpB,aAAW,UAAU,aAAa;AAChC,QAAI,OAAO,MAAM,GAAG;AAClB,iBAAW,MAAM,IAAI,OAAO,MAAM;AAAA,IACpC;AAAA,EACF;AAEA,SAAO;AACT;",
+  "sourcesContent": ["import type { OpenAPIV3_1 } from '@scalar/openapi-types'\n\nimport { type HttpMethod, httpMethods } from '@/types'\n\n/**\n * Takes a dereferenced OpenAPI document and returns all operations.\n * Ignores other attributes, like summary, parameters, etc.\n */\nexport function getOperations(path?: OpenAPIV3_1.PathItemObject): Record<HttpMethod, OpenAPIV3_1.OperationObject> {\n  const operations = {} as Record<HttpMethod, OpenAPIV3_1.OperationObject>\n\n  for (const method of httpMethods) {\n    if (path?.[method]) {\n      operations[method] = path?.[method]\n    }\n  }\n\n  return operations\n}\n"],
+  "mappings": "AAEA,SAA0B,mBAAmB;AAMtC,SAAS,cAAc,MAAoF;AAChH,QAAM,aAAa,CAAC;AAEpB,aAAW,UAAU,aAAa;AAChC,QAAI,OAAO,MAAM,GAAG;AAClB,iBAAW,MAAM,IAAI,OAAO,MAAM;AAAA,IACpC;AAAA,EACF;AAEA,SAAO;AACT;",
   "names": []
 }

package/dist/utils/handle-authentication.d.ts

@@ -1,7 +1,7 @@
-import type { OpenAPI } from '@scalar/openapi-types';
+import type { OpenAPIV3_1 } from '@scalar/openapi-types';
 import type { Context } from 'hono';
 /**
  * Handles authentication for incoming requests based on the OpenAPI document.
  */
-export declare function handleAuthentication(schema?: OpenAPI.Document, operation?: OpenAPI.Operation): (c: Context, next: () => Promise<void>) => Promise<Response | void>;
+export declare function handleAuthentication(schema?: OpenAPIV3_1.Document, operation?: OpenAPIV3_1.OperationObject): (c: Context, next: () => Promise<void>) => Promise<Response | void>;
 //# sourceMappingURL=handle-authentication.d.ts.map

package/dist/utils/handle-authentication.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handle-authentication.d.ts","sourceRoot":"","sources":["../../src/utils/handle-authentication.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAA;AACpD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAGnC;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,QAAQ,EAAE,SAAS,CAAC,EAAE,OAAO,CAAC,SAAS,IAC7E,GAAG,OAAO,EAAE,MAAM,MAAM,OAAO,CAAC,IAAI,CAAC,KAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAmH/E"}
+{"version":3,"file":"handle-authentication.d.ts","sourceRoot":"","sources":["../../src/utils/handle-authentication.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAGnC;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC,QAAQ,EAAE,SAAS,CAAC,EAAE,WAAW,CAAC,eAAe,IAC3F,GAAG,OAAO,EAAE,MAAM,MAAM,OAAO,CAAC,IAAI,CAAC,KAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CA6H/E"}

package/dist/utils/handle-authentication.js

@@ -9,16 +9,20 @@ function handleAuthentication(schema, operation) {
         let securitySchemeAuthenticated = true;
         for (const [schemeName] of Object.entries(securityRequirement)) {
           const scheme = schema?.components?.securitySchemes?.[schemeName];
-          if (scheme) {
-            switch (scheme.type) {
+          if (scheme && "$ref" in scheme) {
+            continue;
+          }
+          if (scheme && "type" in scheme) {
+            const securityScheme = scheme;
+            switch (securityScheme.type) {
               case "http":
-                if (scheme.scheme === "basic") {
+                if ("scheme" in securityScheme && securityScheme.scheme === "basic") {
                   authScheme = "Basic";
                   const authHeader = c.req.header("Authorization");
                   if (authHeader?.startsWith("Basic ")) {
                     isAuthenticated = true;
                   }
-                } else if (scheme.scheme === "bearer") {
+                } else if ("scheme" in securityScheme && securityScheme.scheme === "bearer") {
                   authScheme = "Bearer";
                   const authHeader = c.req.header("Authorization");
                   if (authHeader?.startsWith("Bearer ")) {
@@ -27,21 +31,23 @@ function handleAuthentication(schema, operation) {
                 }
                 break;
               case "apiKey":
-                authScheme = `ApiKey ${scheme.name}`;
-                if (scheme.in === "header") {
-                  const apiKey = c.req.header(scheme.name);
-                  if (apiKey) {
-                    isAuthenticated = true;
-                  }
-                } else if (scheme.in === "query") {
-                  const apiKey = c.req.query(scheme.name);
-                  if (apiKey) {
-                    isAuthenticated = true;
-                  }
-                } else if (scheme.in === "cookie") {
-                  const apiKey = getCookie(c, scheme.name);
-                  if (apiKey) {
-                    isAuthenticated = true;
+                if ("name" in securityScheme && "in" in securityScheme && securityScheme.name) {
+                  authScheme = `ApiKey ${securityScheme.name}`;
+                  if (securityScheme.in === "header") {
+                    const apiKey = c.req.header(securityScheme.name);
+                    if (apiKey) {
+                      isAuthenticated = true;
+                    }
+                  } else if (securityScheme.in === "query") {
+                    const apiKey = c.req.query(securityScheme.name);
+                    if (apiKey) {
+                      isAuthenticated = true;
+                    }
+                  } else if (securityScheme.in === "cookie") {
+                    const apiKey = getCookie(c, securityScheme.name);
+                    if (apiKey) {
+                      isAuthenticated = true;
+                    }
                   }
                 }
                 break;
@@ -71,18 +77,19 @@ function handleAuthentication(schema, operation) {
       }
       if (!isAuthenticated) {
         let wwwAuthenticateValue = authScheme;
-        switch (authScheme) {
-          case "Basic":
-            wwwAuthenticateValue += ' realm="Scalar Mock Server", charset="UTF-8"';
-            break;
-          case "Bearer":
-            wwwAuthenticateValue += ' realm="Scalar Mock Server", error="invalid_token", error_description="The access token is invalid or has expired"';
-            break;
-          case "ApiKey":
-            wwwAuthenticateValue += ` realm="Scalar Mock Server", error="invalid_token", error_description="Invalid or missing API key"`;
-            break;
-          default:
-            wwwAuthenticateValue = 'Bearer realm="Scalar Mock Server"';
+        if (authScheme.startsWith("ApiKey")) {
+          wwwAuthenticateValue += ` realm="Scalar Mock Server", error="invalid_token", error_description="Invalid or missing API key"`;
+        } else {
+          switch (authScheme) {
+            case "Basic":
+              wwwAuthenticateValue += ' realm="Scalar Mock Server", charset="UTF-8"';
+              break;
+            case "Bearer":
+              wwwAuthenticateValue += ' realm="Scalar Mock Server", error="invalid_token", error_description="The access token is invalid or has expired"';
+              break;
+            default:
+              wwwAuthenticateValue = 'Bearer realm="Scalar Mock Server"';
+          }
         }
         c.header("WWW-Authenticate", wwwAuthenticateValue);
         return c.json(

package/dist/utils/handle-authentication.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/utils/handle-authentication.ts"],
-  "sourcesContent": ["import type { OpenAPI } from '@scalar/openapi-types'\nimport type { Context } from 'hono'\nimport { getCookie } from 'hono/cookie'\n\n/**\n * Handles authentication for incoming requests based on the OpenAPI document.\n */\nexport function handleAuthentication(schema?: OpenAPI.Document, operation?: OpenAPI.Operation) {\n  return async (c: Context, next: () => Promise<void>): Promise<Response | void> => {\n    const operationSecuritySchemes = operation?.security || schema?.security\n\n    if (operationSecuritySchemes && operationSecuritySchemes.length > 0) {\n      let isAuthenticated = false\n      let authScheme = ''\n\n      for (const securityRequirement of operationSecuritySchemes) {\n        let securitySchemeAuthenticated = true\n\n        for (const [schemeName] of Object.entries(securityRequirement)) {\n          const scheme = schema?.components?.securitySchemes?.[schemeName]\n\n          if (scheme) {\n            switch (scheme.type) {\n              case 'http':\n                if (scheme.scheme === 'basic') {\n                  authScheme = 'Basic'\n                  const authHeader = c.req.header('Authorization')\n\n                  if (authHeader?.startsWith('Basic ')) {\n                    isAuthenticated = true\n                  }\n                } else if (scheme.scheme === 'bearer') {\n                  authScheme = 'Bearer'\n                  const authHeader = c.req.header('Authorization')\n\n                  if (authHeader?.startsWith('Bearer ')) {\n                    isAuthenticated = true\n                  }\n                }\n                break\n              case 'apiKey':\n                authScheme = `ApiKey ${scheme.name}`\n\n                if (scheme.in === 'header') {\n                  const apiKey = c.req.header(scheme.name)\n                  if (apiKey) {\n                    isAuthenticated = true\n                  }\n                } else if (scheme.in === 'query') {\n                  const apiKey = c.req.query(scheme.name)\n\n                  if (apiKey) {\n                    isAuthenticated = true\n                  }\n                } else if (scheme.in === 'cookie') {\n                  const apiKey = getCookie(c, scheme.name)\n\n                  if (apiKey) {\n                    isAuthenticated = true\n                  }\n                }\n                break\n              case 'oauth2':\n                authScheme = 'Bearer'\n                // Handle OAuth 2.0 flows, including password grant\n                if (c.req.header('Authorization')?.startsWith('Bearer ')) {\n                  isAuthenticated = true\n                }\n                break\n              case 'openIdConnect':\n                authScheme = 'Bearer'\n                // Handle OpenID Connect similar to OAuth2\n                if (c.req.header('Authorization')?.startsWith('Bearer ')) {\n                  isAuthenticated = true\n                }\n                break\n            }\n          }\n\n          if (!isAuthenticated) {\n            securitySchemeAuthenticated = false\n            break\n          }\n        }\n\n        if (securitySchemeAuthenticated) {\n          isAuthenticated = true\n          break\n        }\n      }\n\n      if (!isAuthenticated) {\n        let wwwAuthenticateValue = authScheme\n\n        switch (authScheme) {\n          case 'Basic':\n            wwwAuthenticateValue += ' realm=\"Scalar Mock Server\", charset=\"UTF-8\"'\n            break\n          case 'Bearer':\n            wwwAuthenticateValue +=\n              ' realm=\"Scalar Mock Server\", error=\"invalid_token\", error_description=\"The access token is invalid or has expired\"'\n            break\n          case 'ApiKey':\n            wwwAuthenticateValue += ` realm=\"Scalar Mock Server\", error=\"invalid_token\", error_description=\"Invalid or missing API key\"`\n            break\n          default:\n            wwwAuthenticateValue = 'Bearer realm=\"Scalar Mock Server\"'\n        }\n\n        c.header('WWW-Authenticate', wwwAuthenticateValue)\n        return c.json(\n          {\n            error: 'Unauthorized',\n            message: 'Authentication is required to access this resource.',\n          },\n          401,\n        )\n      }\n    }\n\n    // If all checks pass, continue to the next middleware\n    await next()\n  }\n}\n"],
-  "mappings": "AAEA,SAAS,iBAAiB;AAKnB,SAAS,qBAAqB,QAA2B,WAA+B;AAC7F,SAAO,OAAO,GAAY,SAAwD;AAChF,UAAM,2BAA2B,WAAW,YAAY,QAAQ;AAEhE,QAAI,4BAA4B,yBAAyB,SAAS,GAAG;AACnE,UAAI,kBAAkB;AACtB,UAAI,aAAa;AAEjB,iBAAW,uBAAuB,0BAA0B;AAC1D,YAAI,8BAA8B;AAElC,mBAAW,CAAC,UAAU,KAAK,OAAO,QAAQ,mBAAmB,GAAG;AAC9D,gBAAM,SAAS,QAAQ,YAAY,kBAAkB,UAAU;AAE/D,cAAI,QAAQ;AACV,oBAAQ,OAAO,MAAM;AAAA,cACnB,KAAK;AACH,oBAAI,OAAO,WAAW,SAAS;AAC7B,+BAAa;AACb,wBAAM,aAAa,EAAE,IAAI,OAAO,eAAe;AAE/C,sBAAI,YAAY,WAAW,QAAQ,GAAG;AACpC,sCAAkB;AAAA,kBACpB;AAAA,gBACF,WAAW,OAAO,WAAW,UAAU;AACrC,+BAAa;AACb,wBAAM,aAAa,EAAE,IAAI,OAAO,eAAe;AAE/C,sBAAI,YAAY,WAAW,SAAS,GAAG;AACrC,sCAAkB;AAAA,kBACpB;AAAA,gBACF;AACA;AAAA,cACF,KAAK;AACH,6BAAa,UAAU,OAAO,IAAI;AAElC,oBAAI,OAAO,OAAO,UAAU;AAC1B,wBAAM,SAAS,EAAE,IAAI,OAAO,OAAO,IAAI;AACvC,sBAAI,QAAQ;AACV,sCAAkB;AAAA,kBACpB;AAAA,gBACF,WAAW,OAAO,OAAO,SAAS;AAChC,wBAAM,SAAS,EAAE,IAAI,MAAM,OAAO,IAAI;AAEtC,sBAAI,QAAQ;AACV,sCAAkB;AAAA,kBACpB;AAAA,gBACF,WAAW,OAAO,OAAO,UAAU;AACjC,wBAAM,SAAS,UAAU,GAAG,OAAO,IAAI;AAEvC,sBAAI,QAAQ;AACV,sCAAkB;AAAA,kBACpB;AAAA,gBACF;AACA;AAAA,cACF,KAAK;AACH,6BAAa;AAEb,oBAAI,EAAE,IAAI,OAAO,eAAe,GAAG,WAAW,SAAS,GAAG;AACxD,oCAAkB;AAAA,gBACpB;AACA;AAAA,cACF,KAAK;AACH,6BAAa;AAEb,oBAAI,EAAE,IAAI,OAAO,eAAe,GAAG,WAAW,SAAS,GAAG;AACxD,oCAAkB;AAAA,gBACpB;AACA;AAAA,YACJ;AAAA,UACF;AAEA,cAAI,CAAC,iBAAiB;AACpB,0CAA8B;AAC9B;AAAA,UACF;AAAA,QACF;AAEA,YAAI,6BAA6B;AAC/B,4BAAkB;AAClB;AAAA,QACF;AAAA,MACF;AAEA,UAAI,CAAC,iBAAiB;AACpB,YAAI,uBAAuB;AAE3B,gBAAQ,YAAY;AAAA,UAClB,KAAK;AACH,oCAAwB;AACxB;AAAA,UACF,KAAK;AACH,oCACE;AACF;AAAA,UACF,KAAK;AACH,oCAAwB;AACxB;AAAA,UACF;AACE,mCAAuB;AAAA,QAC3B;AAEA,UAAE,OAAO,oBAAoB,oBAAoB;AACjD,eAAO,EAAE;AAAA,UACP;AAAA,YACE,OAAO;AAAA,YACP,SAAS;AAAA,UACX;AAAA,UACA;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAGA,UAAM,KAAK;AAAA,EACb;AACF;",
+  "sourcesContent": ["import type { OpenAPIV3_1 } from '@scalar/openapi-types'\nimport type { Context } from 'hono'\nimport { getCookie } from 'hono/cookie'\n\n/**\n * Handles authentication for incoming requests based on the OpenAPI document.\n */\nexport function handleAuthentication(schema?: OpenAPIV3_1.Document, operation?: OpenAPIV3_1.OperationObject) {\n  return async (c: Context, next: () => Promise<void>): Promise<Response | void> => {\n    const operationSecuritySchemes = operation?.security || schema?.security\n\n    if (operationSecuritySchemes && operationSecuritySchemes.length > 0) {\n      let isAuthenticated = false\n      let authScheme = ''\n\n      for (const securityRequirement of operationSecuritySchemes) {\n        let securitySchemeAuthenticated = true\n\n        for (const [schemeName] of Object.entries(securityRequirement)) {\n          const scheme = schema?.components?.securitySchemes?.[schemeName]\n\n          // Skip if scheme is a reference object (should be dereferenced already, but check to be safe)\n          if (scheme && '$ref' in scheme) {\n            continue\n          }\n\n          if (scheme && 'type' in scheme) {\n            const securityScheme = scheme as OpenAPIV3_1.SecuritySchemeObject\n\n            switch (securityScheme.type) {\n              case 'http':\n                if ('scheme' in securityScheme && securityScheme.scheme === 'basic') {\n                  authScheme = 'Basic'\n                  const authHeader = c.req.header('Authorization')\n\n                  if (authHeader?.startsWith('Basic ')) {\n                    isAuthenticated = true\n                  }\n                } else if ('scheme' in securityScheme && securityScheme.scheme === 'bearer') {\n                  authScheme = 'Bearer'\n                  const authHeader = c.req.header('Authorization')\n\n                  if (authHeader?.startsWith('Bearer ')) {\n                    isAuthenticated = true\n                  }\n                }\n                break\n              case 'apiKey':\n                if ('name' in securityScheme && 'in' in securityScheme && securityScheme.name) {\n                  authScheme = `ApiKey ${securityScheme.name}`\n\n                  if (securityScheme.in === 'header') {\n                    const apiKey = c.req.header(securityScheme.name)\n                    if (apiKey) {\n                      isAuthenticated = true\n                    }\n                  } else if (securityScheme.in === 'query') {\n                    const apiKey = c.req.query(securityScheme.name)\n\n                    if (apiKey) {\n                      isAuthenticated = true\n                    }\n                  } else if (securityScheme.in === 'cookie') {\n                    const apiKey = getCookie(c, securityScheme.name)\n\n                    if (apiKey) {\n                      isAuthenticated = true\n                    }\n                  }\n                }\n                break\n              case 'oauth2':\n                authScheme = 'Bearer'\n                // Handle OAuth 2.0 flows, including password grant\n                if (c.req.header('Authorization')?.startsWith('Bearer ')) {\n                  isAuthenticated = true\n                }\n                break\n              case 'openIdConnect':\n                authScheme = 'Bearer'\n                // Handle OpenID Connect similar to OAuth2\n                if (c.req.header('Authorization')?.startsWith('Bearer ')) {\n                  isAuthenticated = true\n                }\n                break\n            }\n          }\n\n          if (!isAuthenticated) {\n            securitySchemeAuthenticated = false\n            break\n          }\n        }\n\n        if (securitySchemeAuthenticated) {\n          isAuthenticated = true\n          break\n        }\n      }\n\n      if (!isAuthenticated) {\n        let wwwAuthenticateValue = authScheme\n\n        if (authScheme.startsWith('ApiKey')) {\n          wwwAuthenticateValue += ` realm=\"Scalar Mock Server\", error=\"invalid_token\", error_description=\"Invalid or missing API key\"`\n        } else {\n          switch (authScheme) {\n            case 'Basic':\n              wwwAuthenticateValue += ' realm=\"Scalar Mock Server\", charset=\"UTF-8\"'\n              break\n            case 'Bearer':\n              wwwAuthenticateValue +=\n                ' realm=\"Scalar Mock Server\", error=\"invalid_token\", error_description=\"The access token is invalid or has expired\"'\n              break\n            default:\n              wwwAuthenticateValue = 'Bearer realm=\"Scalar Mock Server\"'\n          }\n        }\n\n        c.header('WWW-Authenticate', wwwAuthenticateValue)\n        return c.json(\n          {\n            error: 'Unauthorized',\n            message: 'Authentication is required to access this resource.',\n          },\n          401,\n        )\n      }\n    }\n\n    // If all checks pass, continue to the next middleware\n    await next()\n  }\n}\n"],
+  "mappings": "AAEA,SAAS,iBAAiB;AAKnB,SAAS,qBAAqB,QAA+B,WAAyC;AAC3G,SAAO,OAAO,GAAY,SAAwD;AAChF,UAAM,2BAA2B,WAAW,YAAY,QAAQ;AAEhE,QAAI,4BAA4B,yBAAyB,SAAS,GAAG;AACnE,UAAI,kBAAkB;AACtB,UAAI,aAAa;AAEjB,iBAAW,uBAAuB,0BAA0B;AAC1D,YAAI,8BAA8B;AAElC,mBAAW,CAAC,UAAU,KAAK,OAAO,QAAQ,mBAAmB,GAAG;AAC9D,gBAAM,SAAS,QAAQ,YAAY,kBAAkB,UAAU;AAG/D,cAAI,UAAU,UAAU,QAAQ;AAC9B;AAAA,UACF;AAEA,cAAI,UAAU,UAAU,QAAQ;AAC9B,kBAAM,iBAAiB;AAEvB,oBAAQ,eAAe,MAAM;AAAA,cAC3B,KAAK;AACH,oBAAI,YAAY,kBAAkB,eAAe,WAAW,SAAS;AACnE,+BAAa;AACb,wBAAM,aAAa,EAAE,IAAI,OAAO,eAAe;AAE/C,sBAAI,YAAY,WAAW,QAAQ,GAAG;AACpC,sCAAkB;AAAA,kBACpB;AAAA,gBACF,WAAW,YAAY,kBAAkB,eAAe,WAAW,UAAU;AAC3E,+BAAa;AACb,wBAAM,aAAa,EAAE,IAAI,OAAO,eAAe;AAE/C,sBAAI,YAAY,WAAW,SAAS,GAAG;AACrC,sCAAkB;AAAA,kBACpB;AAAA,gBACF;AACA;AAAA,cACF,KAAK;AACH,oBAAI,UAAU,kBAAkB,QAAQ,kBAAkB,eAAe,MAAM;AAC7E,+BAAa,UAAU,eAAe,IAAI;AAE1C,sBAAI,eAAe,OAAO,UAAU;AAClC,0BAAM,SAAS,EAAE,IAAI,OAAO,eAAe,IAAI;AAC/C,wBAAI,QAAQ;AACV,wCAAkB;AAAA,oBACpB;AAAA,kBACF,WAAW,eAAe,OAAO,SAAS;AACxC,0BAAM,SAAS,EAAE,IAAI,MAAM,eAAe,IAAI;AAE9C,wBAAI,QAAQ;AACV,wCAAkB;AAAA,oBACpB;AAAA,kBACF,WAAW,eAAe,OAAO,UAAU;AACzC,0BAAM,SAAS,UAAU,GAAG,eAAe,IAAI;AAE/C,wBAAI,QAAQ;AACV,wCAAkB;AAAA,oBACpB;AAAA,kBACF;AAAA,gBACF;AACA;AAAA,cACF,KAAK;AACH,6BAAa;AAEb,oBAAI,EAAE,IAAI,OAAO,eAAe,GAAG,WAAW,SAAS,GAAG;AACxD,oCAAkB;AAAA,gBACpB;AACA;AAAA,cACF,KAAK;AACH,6BAAa;AAEb,oBAAI,EAAE,IAAI,OAAO,eAAe,GAAG,WAAW,SAAS,GAAG;AACxD,oCAAkB;AAAA,gBACpB;AACA;AAAA,YACJ;AAAA,UACF;AAEA,cAAI,CAAC,iBAAiB;AACpB,0CAA8B;AAC9B;AAAA,UACF;AAAA,QACF;AAEA,YAAI,6BAA6B;AAC/B,4BAAkB;AAClB;AAAA,QACF;AAAA,MACF;AAEA,UAAI,CAAC,iBAAiB;AACpB,YAAI,uBAAuB;AAE3B,YAAI,WAAW,WAAW,QAAQ,GAAG;AACnC,kCAAwB;AAAA,QAC1B,OAAO;AACL,kBAAQ,YAAY;AAAA,YAClB,KAAK;AACH,sCAAwB;AACxB;AAAA,YACF,KAAK;AACH,sCACE;AACF;AAAA,YACF;AACE,qCAAuB;AAAA,UAC3B;AAAA,QACF;AAEA,UAAE,OAAO,oBAAoB,oBAAoB;AACjD,eAAO,EAAE;AAAA,UACP;AAAA,YACE,OAAO;AAAA,YACP,SAAS;AAAA,UACX;AAAA,UACA;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAGA,UAAM,KAAK;AAAA,EACb;AACF;",
   "names": []
 }

package/dist/utils/process-openapi-document.d.ts

@@ -0,0 +1,11 @@
+import type { OpenAPIV3_1 } from '@scalar/openapi-types';
+/**
+ * Processes an OpenAPI document by bundling external references, upgrading to OpenAPI 3.1,
+ * and dereferencing the document.
+ *
+ * @param document - The OpenAPI document to process. Can be a string (URL/path) or an object.
+ * @returns A promise that resolves to the dereferenced OpenAPI 3.1 document.
+ * @throws Error if the document cannot be processed or is invalid.
+ */
+export declare function processOpenApiDocument(document: string | Record<string, any> | undefined): Promise<OpenAPIV3_1.Document>;
+//# sourceMappingURL=process-openapi-document.d.ts.map

package/dist/utils/process-openapi-document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-openapi-document.d.ts","sourceRoot":"","sources":["../../src/utils/process-openapi-document.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAGxD;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,GACjD,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,CAoE/B"}

package/dist/utils/process-openapi-document.js

@@ -0,0 +1,59 @@
+import { bundle } from "@scalar/json-magic/bundle";
+import { parseJson } from "@scalar/json-magic/bundle/plugins/node";
+import { parseYaml } from "@scalar/json-magic/bundle/plugins/node";
+import { readFiles } from "@scalar/json-magic/bundle/plugins/node";
+import { fetchUrls } from "@scalar/json-magic/bundle/plugins/node";
+import { dereference } from "@scalar/openapi-parser";
+import { upgrade } from "@scalar/openapi-upgrader";
+async function processOpenApiDocument(document) {
+  if (!document || typeof document === "object" && Object.keys(document).length === 0) {
+    return {
+      openapi: "3.1.0",
+      info: {
+        title: "Mock API",
+        version: "1.0.0"
+      },
+      paths: {}
+    };
+  }
+  let bundled;
+  try {
+    bundled = await bundle(document, {
+      plugins: [parseJson(), parseYaml(), readFiles(), fetchUrls()],
+      treeShake: false
+    });
+  } catch (error) {
+    throw new Error(`Failed to bundle OpenAPI document: ${error instanceof Error ? error.message : String(error)}`);
+  }
+  if (!bundled || typeof bundled !== "object") {
+    throw new Error("Bundled document is invalid: expected an object");
+  }
+  let upgraded;
+  try {
+    upgraded = upgrade(bundled, "3.1");
+  } catch (error) {
+    throw new Error(
+      `Failed to upgrade OpenAPI document to 3.1: ${error instanceof Error ? error.message : String(error)}`
+    );
+  }
+  if (!upgraded) {
+    throw new Error("Upgraded document is invalid: upgrade returned null or undefined");
+  }
+  const dereferenceResult = dereference(upgraded);
+  if (dereferenceResult.errors && dereferenceResult.errors.length > 0) {
+    const errorMessages = dereferenceResult.errors.map((err) => err.message).join(", ");
+    throw new Error(`Failed to dereference OpenAPI document: ${errorMessages}`);
+  }
+  const schema = dereferenceResult.schema;
+  if (!schema) {
+    throw new Error("Dereference result does not contain a schema");
+  }
+  if (typeof schema !== "object") {
+    throw new Error("Dereferenced schema is invalid: expected an object");
+  }
+  return schema;
+}
+export {
+  processOpenApiDocument
+};
+//# sourceMappingURL=process-openapi-document.js.map

package/dist/utils/process-openapi-document.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/utils/process-openapi-document.ts"],
+  "sourcesContent": ["import { bundle } from '@scalar/json-magic/bundle'\nimport { parseJson } from '@scalar/json-magic/bundle/plugins/node'\nimport { parseYaml } from '@scalar/json-magic/bundle/plugins/node'\nimport { readFiles } from '@scalar/json-magic/bundle/plugins/node'\nimport { fetchUrls } from '@scalar/json-magic/bundle/plugins/node'\nimport { dereference } from '@scalar/openapi-parser'\nimport type { OpenAPIV3_1 } from '@scalar/openapi-types'\nimport { upgrade } from '@scalar/openapi-upgrader'\n\n/**\n * Processes an OpenAPI document by bundling external references, upgrading to OpenAPI 3.1,\n * and dereferencing the document.\n *\n * @param document - The OpenAPI document to process. Can be a string (URL/path) or an object.\n * @returns A promise that resolves to the dereferenced OpenAPI 3.1 document.\n * @throws Error if the document cannot be processed or is invalid.\n */\nexport async function processOpenApiDocument(\n  document: string | Record<string, any> | undefined,\n): Promise<OpenAPIV3_1.Document> {\n  // Handle empty/undefined input gracefully\n  if (!document || (typeof document === 'object' && Object.keys(document).length === 0)) {\n    // Return a minimal valid OpenAPI 3.1 document\n    return {\n      openapi: '3.1.0',\n      info: {\n        title: 'Mock API',\n        version: '1.0.0',\n      },\n      paths: {},\n    }\n  }\n\n  let bundled: Record<string, any>\n\n  try {\n    // Bundle external references with Node.js plugins\n    // Include parseJson and parseYaml to handle string inputs\n    bundled = await bundle(document, {\n      plugins: [parseJson(), parseYaml(), readFiles(), fetchUrls()],\n      treeShake: false,\n    })\n  } catch (error) {\n    throw new Error(`Failed to bundle OpenAPI document: ${error instanceof Error ? error.message : String(error)}`)\n  }\n\n  if (!bundled || typeof bundled !== 'object') {\n    throw new Error('Bundled document is invalid: expected an object')\n  }\n\n  let upgraded: OpenAPIV3_1.Document\n\n  try {\n    // Upgrade to OpenAPI 3.1\n    upgraded = upgrade(bundled, '3.1')\n  } catch (error) {\n    throw new Error(\n      `Failed to upgrade OpenAPI document to 3.1: ${error instanceof Error ? error.message : String(error)}`,\n    )\n  }\n\n  if (!upgraded) {\n    throw new Error('Upgraded document is invalid: upgrade returned null or undefined')\n  }\n\n  // Dereference the document\n  const dereferenceResult = dereference(upgraded)\n\n  // Check for dereference errors\n  if (dereferenceResult.errors && dereferenceResult.errors.length > 0) {\n    const errorMessages = dereferenceResult.errors.map((err) => err.message).join(', ')\n    throw new Error(`Failed to dereference OpenAPI document: ${errorMessages}`)\n  }\n\n  // Extract the schema from the dereference result\n  const schema = dereferenceResult.schema\n\n  if (!schema) {\n    throw new Error('Dereference result does not contain a schema')\n  }\n\n  // Ensure the schema is a valid OpenAPI 3.1 document\n  if (typeof schema !== 'object') {\n    throw new Error('Dereferenced schema is invalid: expected an object')\n  }\n\n  return schema as OpenAPIV3_1.Document\n}\n"],
+  "mappings": "AAAA,SAAS,cAAc;AACvB,SAAS,iBAAiB;AAC1B,SAAS,iBAAiB;AAC1B,SAAS,iBAAiB;AAC1B,SAAS,iBAAiB;AAC1B,SAAS,mBAAmB;AAE5B,SAAS,eAAe;AAUxB,eAAsB,uBACpB,UAC+B;AAE/B,MAAI,CAAC,YAAa,OAAO,aAAa,YAAY,OAAO,KAAK,QAAQ,EAAE,WAAW,GAAI;AAErF,WAAO;AAAA,MACL,SAAS;AAAA,MACT,MAAM;AAAA,QACJ,OAAO;AAAA,QACP,SAAS;AAAA,MACX;AAAA,MACA,OAAO,CAAC;AAAA,IACV;AAAA,EACF;AAEA,MAAI;AAEJ,MAAI;AAGF,cAAU,MAAM,OAAO,UAAU;AAAA,MAC/B,SAAS,CAAC,UAAU,GAAG,UAAU,GAAG,UAAU,GAAG,UAAU,CAAC;AAAA,MAC5D,WAAW;AAAA,IACb,CAAC;AAAA,EACH,SAAS,OAAO;AACd,UAAM,IAAI,MAAM,sCAAsC,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC,EAAE;AAAA,EAChH;AAEA,MAAI,CAAC,WAAW,OAAO,YAAY,UAAU;AAC3C,UAAM,IAAI,MAAM,iDAAiD;AAAA,EACnE;AAEA,MAAI;AAEJ,MAAI;AAEF,eAAW,QAAQ,SAAS,KAAK;AAAA,EACnC,SAAS,OAAO;AACd,UAAM,IAAI;AAAA,MACR,8CAA8C,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC;AAAA,IACtG;AAAA,EACF;AAEA,MAAI,CAAC,UAAU;AACb,UAAM,IAAI,MAAM,kEAAkE;AAAA,EACpF;AAGA,QAAM,oBAAoB,YAAY,QAAQ;AAG9C,MAAI,kBAAkB,UAAU,kBAAkB,OAAO,SAAS,GAAG;AACnE,UAAM,gBAAgB,kBAAkB,OAAO,IAAI,CAAC,QAAQ,IAAI,OAAO,EAAE,KAAK,IAAI;AAClF,UAAM,IAAI,MAAM,2CAA2C,aAAa,EAAE;AAAA,EAC5E;AAGA,QAAM,SAAS,kBAAkB;AAEjC,MAAI,CAAC,QAAQ;AACX,UAAM,IAAI,MAAM,8CAA8C;AAAA,EAChE;AAGA,MAAI,OAAO,WAAW,UAAU;AAC9B,UAAM,IAAI,MAAM,oDAAoD;AAAA,EACtE;AAEA,SAAO;AACT;",
+  "names": []
+}

package/dist/utils/store-wrapper.d.ts

@@ -0,0 +1,31 @@
+import type { Store } from '../libs/store.js';
+/**
+ * Public interface of the Store class (methods only, no private properties).
+ */
+type StoreInterface = Pick<Store, 'list' | 'get' | 'create' | 'update' | 'delete' | 'clear'>;
+/**
+ * Represents a single store operation with its result.
+ */
+type StoreOperation = {
+    /** The operation method name that was called. */
+    operation: 'get' | 'create' | 'update' | 'delete' | 'list';
+    /** The result of the operation. */
+    result: any;
+};
+/**
+ * Tracks all store operations performed.
+ */
+export type StoreOperationTracking = {
+    /** All operations performed, in order. */
+    operations: StoreOperation[];
+};
+/**
+ * Creates a wrapped store that tracks operations.
+ * Returns both the wrapped store and a tracking object that gets updated as operations are performed.
+ */
+export declare function createStoreWrapper(store: Store): {
+    wrappedStore: StoreInterface;
+    tracking: StoreOperationTracking;
+};
+export {};
+//# sourceMappingURL=store-wrapper.d.ts.map

package/dist/utils/store-wrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-wrapper.d.ts","sourceRoot":"","sources":["../../src/utils/store-wrapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAE1C;;GAEG;AACH,KAAK,cAAc,GAAG,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC,CAAA;AAE5F;;GAEG;AACH,KAAK,cAAc,GAAG;IACpB,iDAAiD;IACjD,SAAS,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAA;IAC1D,mCAAmC;IACnC,MAAM,EAAE,GAAG,CAAA;CACZ,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,0CAA0C;IAC1C,UAAU,EAAE,cAAc,EAAE,CAAA;CAC7B,CAAA;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,GAAG;IAChD,YAAY,EAAE,cAAc,CAAA;IAC5B,QAAQ,EAAE,sBAAsB,CAAA;CACjC,CA2CA"}

package/dist/utils/store-wrapper.js

@@ -0,0 +1,40 @@
+function createStoreWrapper(store) {
+  const tracking = {
+    operations: []
+  };
+  const wrappedStore = {
+    list(collection) {
+      const result = store.list(collection);
+      tracking.operations.push({ operation: "list", result });
+      return result;
+    },
+    get(collection, id) {
+      const result = store.get(collection, id);
+      tracking.operations.push({ operation: "get", result });
+      return result;
+    },
+    create(collection, data) {
+      const result = store.create(collection, data);
+      tracking.operations.push({ operation: "create", result });
+      return result;
+    },
+    update(collection, id, data) {
+      const result = store.update(collection, id, data);
+      tracking.operations.push({ operation: "update", result });
+      return result;
+    },
+    delete(collection, id) {
+      const result = store.delete(collection, id);
+      tracking.operations.push({ operation: "delete", result });
+      return result;
+    },
+    clear(collection) {
+      store.clear(collection);
+    }
+  };
+  return { wrappedStore, tracking };
+}
+export {
+  createStoreWrapper
+};
+//# sourceMappingURL=store-wrapper.js.map

package/dist/utils/store-wrapper.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/utils/store-wrapper.ts"],
+  "sourcesContent": ["import type { Store } from '../libs/store'\n\n/**\n * Public interface of the Store class (methods only, no private properties).\n */\ntype StoreInterface = Pick<Store, 'list' | 'get' | 'create' | 'update' | 'delete' | 'clear'>\n\n/**\n * Represents a single store operation with its result.\n */\ntype StoreOperation = {\n  /** The operation method name that was called. */\n  operation: 'get' | 'create' | 'update' | 'delete' | 'list'\n  /** The result of the operation. */\n  result: any\n}\n\n/**\n * Tracks all store operations performed.\n */\nexport type StoreOperationTracking = {\n  /** All operations performed, in order. */\n  operations: StoreOperation[]\n}\n\n/**\n * Creates a wrapped store that tracks operations.\n * Returns both the wrapped store and a tracking object that gets updated as operations are performed.\n */\nexport function createStoreWrapper(store: Store): {\n  wrappedStore: StoreInterface\n  tracking: StoreOperationTracking\n} {\n  const tracking: StoreOperationTracking = {\n    operations: [],\n  }\n\n  const wrappedStore = {\n    list(collection: string) {\n      const result = store.list(collection)\n      tracking.operations.push({ operation: 'list', result })\n      return result\n    },\n\n    get(collection: string, id: string) {\n      const result = store.get(collection, id)\n      tracking.operations.push({ operation: 'get', result })\n      return result\n    },\n\n    create(collection: string, data: any) {\n      const result = store.create(collection, data)\n      tracking.operations.push({ operation: 'create', result })\n      return result\n    },\n\n    update(collection: string, id: string, data: any) {\n      const result = store.update(collection, id, data)\n      tracking.operations.push({ operation: 'update', result })\n      return result\n    },\n\n    delete(collection: string, id: string) {\n      const result = store.delete(collection, id)\n      tracking.operations.push({ operation: 'delete', result })\n      return result\n    },\n\n    clear(collection?: string) {\n      store.clear(collection)\n      // clear() doesn't set tracking as it's not a typical CRUD operation\n    },\n  }\n\n  return { wrappedStore, tracking }\n}\n"],
+  "mappings": "AA6BO,SAAS,mBAAmB,OAGjC;AACA,QAAM,WAAmC;AAAA,IACvC,YAAY,CAAC;AAAA,EACf;AAEA,QAAM,eAAe;AAAA,IACnB,KAAK,YAAoB;AACvB,YAAM,SAAS,MAAM,KAAK,UAAU;AACpC,eAAS,WAAW,KAAK,EAAE,WAAW,QAAQ,OAAO,CAAC;AACtD,aAAO;AAAA,IACT;AAAA,IAEA,IAAI,YAAoB,IAAY;AAClC,YAAM,SAAS,MAAM,IAAI,YAAY,EAAE;AACvC,eAAS,WAAW,KAAK,EAAE,WAAW,OAAO,OAAO,CAAC;AACrD,aAAO;AAAA,IACT;AAAA,IAEA,OAAO,YAAoB,MAAW;AACpC,YAAM,SAAS,MAAM,OAAO,YAAY,IAAI;AAC5C,eAAS,WAAW,KAAK,EAAE,WAAW,UAAU,OAAO,CAAC;AACxD,aAAO;AAAA,IACT;AAAA,IAEA,OAAO,YAAoB,IAAY,MAAW;AAChD,YAAM,SAAS,MAAM,OAAO,YAAY,IAAI,IAAI;AAChD,eAAS,WAAW,KAAK,EAAE,WAAW,UAAU,OAAO,CAAC;AACxD,aAAO;AAAA,IACT;AAAA,IAEA,OAAO,YAAoB,IAAY;AACrC,YAAM,SAAS,MAAM,OAAO,YAAY,EAAE;AAC1C,eAAS,WAAW,KAAK,EAAE,WAAW,UAAU,OAAO,CAAC;AACxD,aAAO;AAAA,IACT;AAAA,IAEA,MAAM,YAAqB;AACzB,YAAM,MAAM,UAAU;AAAA,IAExB;AAAA,EACF;AAEA,SAAO,EAAE,cAAc,SAAS;AAClC;",
+  "names": []
+}