@sonatel-os/openapi-runtime 0.1.0

package/dist/src/auth.d.ts

@@ -0,0 +1,33 @@
+export function setAuth(name: any, providers: any): void;
+export function applyAuth(entry: any, operationId: any, req: any): Promise<void>;
+export function apiKey({ in: placement, name, getValue }: {
+    in: any;
+    name: any;
+    getValue: any;
+}): {
+    apply(_entry: any, _schemeName: any, _scopes: any, req: any): Promise<void>;
+};
+export function basic({ username, password, getCredentials }: {
+    username: any;
+    password: any;
+    getCredentials: any;
+}): {
+    apply(_entry: any, _schemeName: any, _scopes: any, req: any): Promise<void>;
+};
+export function bearer({ token, getToken }: {
+    token: any;
+    getToken: any;
+}): {
+    apply(_entry: any, _schemeName: any, _scopes: any, req: any): Promise<void>;
+};
+export function clientCredentials({ tokenUrl, clientId, clientSecret, scope, audience, extraParams }: {
+    tokenUrl: any;
+    clientId: any;
+    clientSecret: any;
+    scope: any;
+    audience: any;
+    extraParams: any;
+}): {
+    apply(_entry: any, _schemeName: any, reqScopes: any, req: any): Promise<void>;
+};
+export function providersFromConfig(_name: any, _spec: any, cfg: any): {};

package/dist/src/client.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @param {{ name: string, spec: string|object }} opts
+ * @returns {Promise<import('./registry.js').SpecEntry>}
+ */
+export function buildClient({ name, spec }: {
+    name: string;
+    spec: string | object;
+}): Promise<import("./registry.js").SpecEntry>;
+/**
+ * Execute with merged headers, auth, and simple interceptors.
+ * @param {import('./registry.js').SpecEntry} entry
+ * @param {{ operationId: string, parameters?: object, requestBody?: any, headers?: object, qs?: object }} req
+ */
+export function executeByOperationId(entry: import("./registry.js").SpecEntry, req: {
+    operationId: string;
+    parameters?: object;
+    requestBody?: any;
+    headers?: object;
+    qs?: object;
+}): Promise<any>;

package/dist/src/config.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Load auth config from YAML if available.
+ * Path: process.env.OPENAPI_RUNTIME_AUTH_CONFIG || "./openapi.auth.yml"
+ * Returns a plain object or null.
+ */
+export function loadAuthConfig(): any;
+/**
+ * Read an env var safely (supports default via "ENV|default").
+ */
+export function getEnv(keyOrExpr: any): any;

package/dist/src/react/useOpenAPI.d.ts

@@ -0,0 +1,6 @@
+/**
+ * React helper to bind a spec name.
+ * @param {string} name
+ */
+export function useOpenAPI(name: string): any;
+export default useOpenAPI;

package/dist/src/registry.d.ts

@@ -0,0 +1,28 @@
+export function getRegistry(): Map<any, any>;
+export function ensureEntry(name: any): any;
+export function indexOperations(spec: any): {
+    opsById: Map<string, object>;
+    operations: OperationInfo[];
+};
+export type OperationInfo = {
+    operationId: string;
+    method: string;
+    path: string;
+    summary?: string | undefined;
+    tags?: string[] | undefined;
+};
+export type SpecEntry = {
+    name: string;
+    client: any;
+    spec: object;
+    opsById: Map<string, object>;
+    operations: OperationInfo[];
+    defaults: {
+        headers?: Record<string, string>;
+    };
+    interceptors: {
+        request?: Function;
+        response?: Function;
+        error?: Function;
+    };
+};

package/dist/src/sampler.d.ts

@@ -0,0 +1,2 @@
+export function responseSampleFor(entry: any, api: any, status: any): unknown;
+export function requestSampleFor(entry: any, api: any): unknown;

package/dist/src/validate.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Build a validator for a given operation's response.
+ * @param {import('./registry.js').SpecEntry} entry
+ * @param {{ api: string, status: string, contentType: string, data: any }} opts
+ */
+export function validateResponseFor(entry: import("./registry.js").SpecEntry, { api, status, contentType, data }: {
+    api: string;
+    status: string;
+    contentType: string;
+    data: any;
+}): {
+    valid: boolean;
+    errors?: undefined;
+} | {
+    valid: boolean;
+    errors: import("ajv").ErrorObject<string, Record<string, any>, unknown>[];
+};

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "@sonatel-os/openapi-runtime",
+  "version": "0.1.0",
+  "description": "The dynamic, zero-codegen OpenAPI SDK. Load specs at runtime, mock responses, validate payloads, and execute requests without generating a single file.",
+  "license": "MIT",
+  "author": "Sonatel Open Source <opensource@sonatel.com>",
+  "homepage": "https://github.com/sonatel-os/openapi-runtime#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sonatel-os/openapi-runtime.git"
+  },
+  "bugs": {
+    "url": "https://github.com/sonatel-os/openapi-runtime/issues"
+  },
+  "keywords": [
+    "openapi",
+    "swagger",
+    "runtime",
+    "client",
+    "sdk",
+    "fetch",
+    "mock",
+    "validation",
+    "sonatel",
+    "zero-codegen",
+    "dynamic-client"
+  ],
+  "type": "module",
+  "main": "dist/index.cjs",
+  "module": "dist/index.esm.js",
+  "types": "dist/index.d.ts",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "require": "./dist/index.cjs",
+      "import": "./dist/index.esm.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "dev": "node --watch src/index.js",
+    "build": "rm -rf dist && vite build && npx tsc --emitDeclarationOnly --declaration --declarationDir dist",
+    "lint": "eslint .",
+    "test": "node --test",
+    "prepublishOnly": "npm run build"
+  },
+  "peerDependencies": {
+    "react": ">=18"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "typescript": "^5.5.4",
+    "vite": "^5.4.3"
+  },
+  "dependencies": {
+    "ajv": "^8.17.1",
+    "ajv-formats": "^3.0.1",
+    "cross-fetch": "^4.0.0",
+    "js-yaml": "^4.1.0",
+    "openapi-sampler": "^1.5.1",
+    "swagger-client": "^3.26.1"
+  }
+}