oz-node-sdk 0.1.0

package/README.md

@@ -0,0 +1,48 @@
+# oz-node-sdk
+
+Generated Node.js SDK for the oz API.
+
+## Install
+
+```bash
+bun add @oz/oz-node-sdk
+```
+
+or
+
+```bash
+npm install @oz/oz-node-sdk
+```
+
+## Build
+
+From this directory run:
+
+```bash
+OPENAPI_SPEC_PATH=../../target/openapi/openapi.json bun run build
+```
+
+The script reads the generated OpenAPI artifact and writes SDK artifacts to `dist/`.
+
+## Publish
+
+```bash
+bun run clean
+OPENAPI_SPEC_PATH=../../target/openapi/openapi.json bun run build
+bun publish --access public
+```
+
+`prepublishOnly` is configured to regenerate `dist` automatically before publish.
+
+## Usage
+
+```js
+import { OzNodeSdkClient } from '@oz/oz-node-sdk';
+
+const client = new OzNodeSdkClient({
+  baseUrl: 'http://localhost:8787',
+  apiKey: 'oz_live_xxx',
+});
+
+const projects = await client.GET_v2_projects();
+```

package/dist/index.d.ts

@@ -0,0 +1,56 @@
+export interface OzNodeSdkOptions {
+  baseUrl?: string;
+  apiKey?: string;
+  headers?: Record<string, string>;
+  fetch?: typeof fetch;
+}
+
+export interface OzNodeRequestOptions {
+  pathParams?: Record<string, string | number>;
+  query?: Record<string, string | number | boolean | Array<string | number | boolean>>;
+  body?: unknown;
+  headers?: Record<string, string>;
+  signal?: AbortSignal;
+}
+
+export type OzNodeSdkEndpoint = {
+  method: string;
+  path: string;
+  operationId: string;
+  summary?: string;
+  tags?: string[];
+};
+
+export const openapiEndpoints: OzNodeSdkEndpoint[];
+
+export class OzNodeSdkClient {
+  constructor(options?: OzNodeSdkOptions);
+  setApiKey(apiKey: string | null): void;
+  GET_api_csrf(options?: OzNodeRequestOptions): Promise<unknown>;
+  GET_api_keys(options?: OzNodeRequestOptions): Promise<unknown>;
+  POST_api_keys(options?: OzNodeRequestOptions): Promise<unknown>;
+  DELETE_api_keys_id(options?: OzNodeRequestOptions): Promise<unknown>;
+  GET_api_me(options?: OzNodeRequestOptions): Promise<unknown>;
+  GET_api_projects(options?: OzNodeRequestOptions): Promise<unknown>;
+  POST_api_projects(options?: OzNodeRequestOptions): Promise<unknown>;
+  DELETE_api_projects_slug_members(options?: OzNodeRequestOptions): Promise<unknown>;
+  GET_api_projects_slug_members(options?: OzNodeRequestOptions): Promise<unknown>;
+  POST_api_projects_slug_members(options?: OzNodeRequestOptions): Promise<unknown>;
+  POST_api_secrets_delete(options?: OzNodeRequestOptions): Promise<unknown>;
+  POST_api_secrets_list(options?: OzNodeRequestOptions): Promise<unknown>;
+  POST_api_secrets_read(options?: OzNodeRequestOptions): Promise<unknown>;
+  PUT_api_secrets_write(options?: OzNodeRequestOptions): Promise<unknown>;
+  GET_auth_github(options?: OzNodeRequestOptions): Promise<unknown>;
+  GET_auth_github_callback(options?: OzNodeRequestOptions): Promise<unknown>;
+  POST_auth_logout(options?: OzNodeRequestOptions): Promise<unknown>;
+  GET_v1_projects(options?: OzNodeRequestOptions): Promise<unknown>;
+  GET_v1_projects_slug_secrets(options?: OzNodeRequestOptions): Promise<unknown>;
+  DELETE_v1_projects_slug_secrets_key(options?: OzNodeRequestOptions): Promise<unknown>;
+  GET_v1_projects_slug_secrets_key(options?: OzNodeRequestOptions): Promise<unknown>;
+  PUT_v1_projects_slug_secrets_key(options?: OzNodeRequestOptions): Promise<unknown>;
+  GET_v2_projects(options?: OzNodeRequestOptions): Promise<unknown>;
+  POST_v2_secrets_delete(options?: OzNodeRequestOptions): Promise<unknown>;
+  POST_v2_secrets_list(options?: OzNodeRequestOptions): Promise<unknown>;
+  POST_v2_secrets_read(options?: OzNodeRequestOptions): Promise<unknown>;
+  PUT_v2_secrets_write(options?: OzNodeRequestOptions): Promise<unknown>;
+}

package/dist/index.js

@@ -0,0 +1,420 @@
+"use strict";
+
+export const openapiEndpoints = [
+  {
+    "method": "GET",
+    "path": "/api/csrf",
+    "operationId": "GET_api_csrf",
+    "summary": "",
+    "tags": []
+  },
+  {
+    "method": "GET",
+    "path": "/api/keys",
+    "operationId": "GET_api_keys",
+    "summary": "",
+    "tags": []
+  },
+  {
+    "method": "POST",
+    "path": "/api/keys",
+    "operationId": "POST_api_keys",
+    "summary": "",
+    "tags": []
+  },
+  {
+    "method": "DELETE",
+    "path": "/api/keys/{id}",
+    "operationId": "DELETE_api_keys_id",
+    "summary": "",
+    "tags": []
+  },
+  {
+    "method": "GET",
+    "path": "/api/me",
+    "operationId": "GET_api_me",
+    "summary": "",
+    "tags": []
+  },
+  {
+    "method": "GET",
+    "path": "/api/projects",
+    "operationId": "GET_api_projects",
+    "summary": "",
+    "tags": []
+  },
+  {
+    "method": "POST",
+    "path": "/api/projects",
+    "operationId": "POST_api_projects",
+    "summary": "",
+    "tags": []
+  },
+  {
+    "method": "DELETE",
+    "path": "/api/projects/{slug}/members",
+    "operationId": "DELETE_api_projects_slug_members",
+    "summary": "",
+    "tags": []
+  },
+  {
+    "method": "GET",
+    "path": "/api/projects/{slug}/members",
+    "operationId": "GET_api_projects_slug_members",
+    "summary": "",
+    "tags": []
+  },
+  {
+    "method": "POST",
+    "path": "/api/projects/{slug}/members",
+    "operationId": "POST_api_projects_slug_members",
+    "summary": "",
+    "tags": []
+  },
+  {
+    "method": "POST",
+    "path": "/api/secrets/delete",
+    "operationId": "POST_api_secrets_delete",
+    "summary": "",
+    "tags": []
+  },
+  {
+    "method": "POST",
+    "path": "/api/secrets/list",
+    "operationId": "POST_api_secrets_list",
+    "summary": "",
+    "tags": []
+  },
+  {
+    "method": "POST",
+    "path": "/api/secrets/read",
+    "operationId": "POST_api_secrets_read",
+    "summary": "",
+    "tags": []
+  },
+  {
+    "method": "PUT",
+    "path": "/api/secrets/write",
+    "operationId": "PUT_api_secrets_write",
+    "summary": "",
+    "tags": []
+  },
+  {
+    "method": "GET",
+    "path": "/auth/github",
+    "operationId": "GET_auth_github",
+    "summary": "",
+    "tags": []
+  },
+  {
+    "method": "GET",
+    "path": "/auth/github/callback",
+    "operationId": "GET_auth_github_callback",
+    "summary": "",
+    "tags": []
+  },
+  {
+    "method": "POST",
+    "path": "/auth/logout",
+    "operationId": "POST_auth_logout",
+    "summary": "",
+    "tags": []
+  },
+  {
+    "method": "GET",
+    "path": "/v1/projects",
+    "operationId": "GET_v1_projects",
+    "summary": "",
+    "tags": []
+  },
+  {
+    "method": "GET",
+    "path": "/v1/projects/{slug}/secrets",
+    "operationId": "GET_v1_projects_slug_secrets",
+    "summary": "",
+    "tags": []
+  },
+  {
+    "method": "DELETE",
+    "path": "/v1/projects/{slug}/secrets/{key}",
+    "operationId": "DELETE_v1_projects_slug_secrets_key",
+    "summary": "",
+    "tags": []
+  },
+  {
+    "method": "GET",
+    "path": "/v1/projects/{slug}/secrets/{key}",
+    "operationId": "GET_v1_projects_slug_secrets_key",
+    "summary": "",
+    "tags": []
+  },
+  {
+    "method": "PUT",
+    "path": "/v1/projects/{slug}/secrets/{key}",
+    "operationId": "PUT_v1_projects_slug_secrets_key",
+    "summary": "",
+    "tags": []
+  },
+  {
+    "method": "GET",
+    "path": "/v2/projects",
+    "operationId": "GET_v2_projects",
+    "summary": "",
+    "tags": []
+  },
+  {
+    "method": "POST",
+    "path": "/v2/secrets/delete",
+    "operationId": "POST_v2_secrets_delete",
+    "summary": "",
+    "tags": []
+  },
+  {
+    "method": "POST",
+    "path": "/v2/secrets/list",
+    "operationId": "POST_v2_secrets_list",
+    "summary": "",
+    "tags": []
+  },
+  {
+    "method": "POST",
+    "path": "/v2/secrets/read",
+    "operationId": "POST_v2_secrets_read",
+    "summary": "",
+    "tags": []
+  },
+  {
+    "method": "PUT",
+    "path": "/v2/secrets/write",
+    "operationId": "PUT_v2_secrets_write",
+    "summary": "",
+    "tags": []
+  }
+];
+
+const query = (searchParams = {}, search = new URLSearchParams()) => {
+  for (const [key, value] of Object.entries(searchParams)) {
+    if (value === undefined) {
+      continue;
+    }
+
+    if (Array.isArray(value)) {
+      for (const item of value) {
+        search.append(key, String(item));
+      }
+
+      continue;
+    }
+
+    search.append(key, String(value));
+  }
+
+  return search;
+};
+
+export class OzNodeSdkClient {
+  #baseUrl;
+  #apiKey;
+  #fetch;
+  #defaultHeaders;
+
+  constructor({
+    baseUrl = '',
+    apiKey,
+    fetch: fetchImpl,
+    headers = {},
+  } = {}) {
+    if (typeof fetchImpl !== 'undefined' && typeof fetchImpl !== 'function') {
+      throw new TypeError('fetch option must be a function');
+    }
+
+    const resolvedFetch = fetchImpl ?? globalThis.fetch;
+    if (typeof resolvedFetch !== 'function') {
+      throw new Error('No fetch implementation available in this environment');
+    }
+
+    this.#baseUrl = baseUrl.replace(//$/, '');
+    this.#apiKey = apiKey ?? null;
+    this.#fetch = resolvedFetch;
+    this.#defaultHeaders = { ...headers };
+  }
+
+  setApiKey(apiKey) {
+    this.#apiKey = apiKey;
+  }
+
+  #url(routePath, pathParams = {}, queryParams = {}) {
+    const path = routePath.replace(/{([^}/]+)}/g, (_match, key) => {
+        if (!(key in pathParams)) {
+        throw new Error('Missing path parameter: ' + key);
+      }
+
+      return encodeURIComponent(String(pathParams[key]));
+    });
+
+    const url = new URL(this.#baseUrl + path);
+    if (queryParams && Object.keys(queryParams).length > 0) {
+      query(url.searchParams, queryParams);
+    }
+
+    return url;
+  }
+
+  async #request(method, routePath, options = {}) {
+    const {
+      pathParams = {},
+      query: queryParams = {},
+      body,
+      headers = {},
+      signal,
+    } = options ?? {};
+
+    const url = this.#url(routePath, pathParams, queryParams);
+    const requestHeaders = {
+      ...this.#defaultHeaders,
+      ...headers,
+      Accept: 'application/json',
+    };
+
+    if (this.#apiKey) {
+      requestHeaders.Authorization = 'Bearer ' + this.#apiKey;
+    }
+
+    const init = {
+      method,
+      headers: requestHeaders,
+      signal,
+    };
+
+    if (body !== undefined && !['GET', 'HEAD'].includes(method)) {
+      requestHeaders['Content-Type'] = requestHeaders['Content-Type'] ?? 'application/json';
+      init.body = typeof body === 'string' ? body : JSON.stringify(body);
+    }
+
+    const response = await this.#fetch(url.href, init);
+    if (!response.ok) {
+      const responseText = await response.text();
+      throw new Error('API request failed (' + response.status + '): ' + (responseText || 'no response body'));
+    }
+
+    if (response.status === 204) {
+      return null;
+    }
+
+    const responseType = response.headers.get('content-type') || '';
+    if (responseType.includes('application/json')) {
+      return response.json();
+    }
+
+    return response.text();
+  }
+
+  async GET_api_csrf(options = {}) {
+    return this.#request("GET", "/api/csrf", options);
+  }
+
+  async GET_api_keys(options = {}) {
+    return this.#request("GET", "/api/keys", options);
+  }
+
+  async POST_api_keys(options = {}) {
+    return this.#request("POST", "/api/keys", options);
+  }
+
+  async DELETE_api_keys_id(options = {}) {
+    return this.#request("DELETE", "/api/keys/{id}", options);
+  }
+
+  async GET_api_me(options = {}) {
+    return this.#request("GET", "/api/me", options);
+  }
+
+  async GET_api_projects(options = {}) {
+    return this.#request("GET", "/api/projects", options);
+  }
+
+  async POST_api_projects(options = {}) {
+    return this.#request("POST", "/api/projects", options);
+  }
+
+  async DELETE_api_projects_slug_members(options = {}) {
+    return this.#request("DELETE", "/api/projects/{slug}/members", options);
+  }
+
+  async GET_api_projects_slug_members(options = {}) {
+    return this.#request("GET", "/api/projects/{slug}/members", options);
+  }
+
+  async POST_api_projects_slug_members(options = {}) {
+    return this.#request("POST", "/api/projects/{slug}/members", options);
+  }
+
+  async POST_api_secrets_delete(options = {}) {
+    return this.#request("POST", "/api/secrets/delete", options);
+  }
+
+  async POST_api_secrets_list(options = {}) {
+    return this.#request("POST", "/api/secrets/list", options);
+  }
+
+  async POST_api_secrets_read(options = {}) {
+    return this.#request("POST", "/api/secrets/read", options);
+  }
+
+  async PUT_api_secrets_write(options = {}) {
+    return this.#request("PUT", "/api/secrets/write", options);
+  }
+
+  async GET_auth_github(options = {}) {
+    return this.#request("GET", "/auth/github", options);
+  }
+
+  async GET_auth_github_callback(options = {}) {
+    return this.#request("GET", "/auth/github/callback", options);
+  }
+
+  async POST_auth_logout(options = {}) {
+    return this.#request("POST", "/auth/logout", options);
+  }
+
+  async GET_v1_projects(options = {}) {
+    return this.#request("GET", "/v1/projects", options);
+  }
+
+  async GET_v1_projects_slug_secrets(options = {}) {
+    return this.#request("GET", "/v1/projects/{slug}/secrets", options);
+  }
+
+  async DELETE_v1_projects_slug_secrets_key(options = {}) {
+    return this.#request("DELETE", "/v1/projects/{slug}/secrets/{key}", options);
+  }
+
+  async GET_v1_projects_slug_secrets_key(options = {}) {
+    return this.#request("GET", "/v1/projects/{slug}/secrets/{key}", options);
+  }
+
+  async PUT_v1_projects_slug_secrets_key(options = {}) {
+    return this.#request("PUT", "/v1/projects/{slug}/secrets/{key}", options);
+  }
+
+  async GET_v2_projects(options = {}) {
+    return this.#request("GET", "/v2/projects", options);
+  }
+
+  async POST_v2_secrets_delete(options = {}) {
+    return this.#request("POST", "/v2/secrets/delete", options);
+  }
+
+  async POST_v2_secrets_list(options = {}) {
+    return this.#request("POST", "/v2/secrets/list", options);
+  }
+
+  async POST_v2_secrets_read(options = {}) {
+    return this.#request("POST", "/v2/secrets/read", options);
+  }
+
+  async PUT_v2_secrets_write(options = {}) {
+    return this.#request("PUT", "/v2/secrets/write", options);
+  }
+
+}