@databallr/sdk 0.0.0-stage → 0.1.0

package/dist/generated/schema.js

@@ -0,0 +1 @@
+export {};

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+import type { components } from "./generated/schema.ts";
+export { Databallr, PRODUCTION_API_KEY_PREFIX, PRODUCTION_BASE_URL, type DataballrOptions, } from "./client.ts";
+export { DataballrConnectionError, DataballrError, DataballrTimeoutError } from "./errors.ts";
+export { SPEC_HASH } from "./generated/methods.ts";
+export type { components, operations as Operations, paths } from "./generated/schema.ts";
+export type { CallOptions, GetPath, Methods, Operation, PostPath, RequestOptions, ResponseBody, } from "./types.ts";
+/** A response model by its OpenAPI component name, e.g. `Schema<"StandingsResponse">`. */
+export type Schema<Name extends keyof components["schemas"]> = components["schemas"][Name];

package/dist/index.js

@@ -0,0 +1,3 @@
+export { Databallr, PRODUCTION_API_KEY_PREFIX, PRODUCTION_BASE_URL, } from "./client.js";
+export { DataballrConnectionError, DataballrError, DataballrTimeoutError } from "./errors.js";
+export { SPEC_HASH } from "./generated/methods.js";

package/dist/types.d.ts

@@ -0,0 +1,83 @@
+import type { paths } from "./generated/schema.ts";
+export type Method = "get" | "post";
+/** Every path that has an operation for `M` a personal API key can call. */
+type PathsWith<M extends Method> = {
+    [P in keyof paths]: [NonNullable<paths[P][M]>] extends [never] ? never : P;
+}[keyof paths];
+export type GetPath = PathsWith<"get">;
+export type PostPath = PathsWith<"post">;
+export type Operation<P extends keyof paths, M extends Method> = NonNullable<paths[P][M]>;
+type Parameters_<O> = O extends {
+    parameters: infer Params;
+} ? Params : never;
+/**
+ * openapi-typescript writes an unused parameter group as `name?: never` and a
+ * used one as `name: {...}` (required) or `name?: {...}`; `Pick` keeps that.
+ */
+type ParameterOption<O, Name extends "path" | "query"> = Parameters_<O> extends {
+    [K in Name]?: never;
+} ? {} : Pick<Parameters_<O>, Name & keyof Parameters_<O>>;
+type BodyOption<O> = O extends {
+    requestBody: {
+        content: {
+            "application/json": infer Body;
+        };
+    };
+} ? {
+    body: Body;
+} : O extends {
+    requestBody?: {
+        content: {
+            "application/json": infer Body;
+        };
+    };
+} ? {
+    body?: Body;
+} : {};
+export interface CallOptions {
+    /** Aborts the request, including any retry it is waiting on. */
+    signal?: AbortSignal;
+    /** Extra headers. `Authorization` is always the client's key. */
+    headers?: Record<string, string>;
+    /** Overrides the client's `timeoutMs` for this call. */
+    timeoutMs?: number;
+    /** Overrides the client's `maxRetries` for this call. */
+    maxRetries?: number;
+}
+export type RequestOptions<O> = ParameterOption<O, "path"> & ParameterOption<O, "query"> & BodyOption<O> & CallOptions;
+/** The options argument is optional when nothing in it is required. */
+export type RequestArgs<O> = {} extends RequestOptions<O> ? [options?: RequestOptions<O>] : [options: RequestOptions<O>];
+type SuccessContent<O> = O extends {
+    responses: {
+        200: {
+            content: infer Content;
+        };
+    };
+} ? Content : never;
+/** JSON bodies are parsed, `text/plain` is a string, anything else an ArrayBuffer. */
+export type ResponseBody<O> = SuccessContent<O> extends {
+    "application/json": infer Json;
+} ? Json : SuccessContent<O> extends {
+    "text/plain": unknown;
+} ? string : ArrayBuffer;
+/** `dbr.get` and `dbr.post`: a path for `M` and that operation's options. */
+export type Call<M extends Method> = <P extends PathsWith<M>>(path: P, ...args: RequestArgs<Operation<P, M>>) => Promise<ResponseBody<Operation<P, M>>>;
+/** A generated method's parameters: path and query parameters in one object. */
+type MethodParams<O> = (Parameters_<O> extends {
+    path: infer Path;
+} ? Path : {}) & (Parameters_<O> extends {
+    query: infer Query;
+} ? Query : Parameters_<O> extends {
+    query?: infer Query;
+} ? [Query] extends [undefined] ? {} : NonNullable<Query> : {});
+type GetMethod<P extends GetPath> = (...args: {} extends MethodParams<Operation<P, "get">> ? [params?: MethodParams<Operation<P, "get">>, options?: CallOptions] : [params: MethodParams<Operation<P, "get">>, options?: CallOptions]) => Promise<ResponseBody<Operation<P, "get">>>;
+type PostMethod<P extends PostPath> = (...args: BodyOption<Operation<P, "post">> extends {
+    body: infer Body;
+} ? [body: Body, options?: CallOptions] : BodyOption<Operation<P, "post">> extends {
+    body?: infer Body;
+} ? [body?: Body, options?: CallOptions] : [body?: undefined, options?: CallOptions]) => Promise<ResponseBody<Operation<P, "post">>>;
+/** Turns the generated method table (paths, or `POST <path>`) into callable methods. */
+export type Methods<Table> = {
+    readonly [K in keyof Table]: Table[K] extends `POST ${infer P extends PostPath}` ? PostMethod<P> : Table[K] extends GetPath ? GetMethod<Table[K]> : Methods<Table[K]>;
+};
+export {};

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,48 @@
 {
   "name": "@databallr/sdk",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "TypeScript client for the databallr API (NBA and WNBA stats, SixRings)",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/databallr/databallr.git",
+    "directory": "packages/sdk"
+  },
+  "homepage": "https://api.databallr.com/docs",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "devDependencies": {
+    "@arethetypeswrong/cli": "0.18.5",
+    "openapi-typescript": "7.13.0",
+    "publint": "0.3.25",
+    "typescript": "5.9.3",
+    "vite": "8.2.2",
+    "vitest": "4.1.10",
+    "@databallr/api-schemas": "0.1.0"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public",
+    "tag": "next"
+  },
+  "scripts": {
+    "generate": "node scripts/generate.mjs",
+    "generate:check": "node scripts/generate.mjs --check",
+    "check:public-surface": "node scripts/check-public-surface.mjs",
+    "build": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\" && tsc -p tsconfig.build.json && tsc -p tsconfig.types.json",
+    "check:package": "publint && attw --pack . --profile esm-only && node scripts/check-size.mjs",
+    "test": "pnpm generate:check && pnpm check:public-surface && vitest run && pnpm build && pnpm check:package",
+    "typecheck": "tsc --noEmit"
+  }
 }