ashby-ts 0.1.0

package/dist/generated/api.js

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

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { Ashby, AshbyError } from "./client.js";
+export type { AshbyOptions, AshbyErrorDetail } from "./client.js";
+export type { AshbyClient, ItemOf, ListCall, Namespace, RequestOf, ResultsOf, RpcPath, SuccessOf, SyncResult, } from "./types.js";
+export type { paths, components, operations } from "./generated/api.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAChD,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAClE,YAAY,EACV,WAAW,EACX,MAAM,EACN,QAAQ,EACR,SAAS,EACT,SAAS,EACT,SAAS,EACT,OAAO,EACP,SAAS,EACT,UAAU,GACX,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1 @@
+export { Ashby, AshbyError } from "./client.js";

package/dist/types.d.ts

@@ -0,0 +1,79 @@
+import type { paths } from "./generated/api.js";
+/** Every RPC endpoint path, e.g. "/application.list". */
+export type RpcPath = keyof paths;
+type PostOf<P extends RpcPath> = paths[P] extends {
+    post: infer O;
+} ? O : never;
+type RawBody<P extends RpcPath> = PostOf<P> extends {
+    requestBody: {
+        content: {
+            "application/json": infer B;
+        };
+    };
+} ? B : PostOf<P> extends {
+    requestBody?: {
+        content: {
+            "application/json": infer B;
+        };
+    };
+} ? B | undefined : undefined;
+/** The JSON request body for an endpoint. */
+export type RequestOf<P extends RpcPath> = NonNullable<RawBody<P>>;
+type ResponseOf<P extends RpcPath> = PostOf<P> extends {
+    responses: {
+        200: {
+            content: {
+                "application/json": infer R;
+            };
+        };
+    };
+} ? R : never;
+/** The success variant of an endpoint's response envelope. */
+export type SuccessOf<P extends RpcPath> = Extract<ResponseOf<P>, {
+    success: true;
+}>;
+/** The `results` payload of a success response. */
+export type ResultsOf<P extends RpcPath> = SuccessOf<P> extends {
+    results: infer R;
+} ? R : never;
+/** A single element of a list endpoint's `results` array. */
+export type ItemOf<P extends RpcPath> = ResultsOf<P> extends readonly (infer I)[] ? I : never;
+type IsPaginated<P extends RpcPath> = "cursor" extends keyof RequestOf<P> ? true : false;
+type HasSyncToken<P extends RpcPath> = "syncToken" extends keyof RequestOf<P> ? true : false;
+/**
+ * A lazy call to a paginated endpoint. Awaiting it fetches one page;
+ * iterating it with `for await` follows `nextCursor` until the data runs out.
+ */
+export interface ListCall<P extends RpcPath> extends Promise<SuccessOf<P>>, AsyncIterable<ItemOf<P>> {
+    /** Fetch a single page (same as awaiting the call directly). */
+    page(): Promise<SuccessOf<P>>;
+    /** Collect every item across all pages into one array. */
+    all(): Promise<ItemOf<P>[]>;
+}
+type EmptyOk<P extends RpcPath> = undefined extends RawBody<P> ? true : Record<string, never> extends RequestOf<P> ? true : false;
+type Fn<P extends RpcPath, R> = EmptyOk<P> extends true ? (body?: RequestOf<P>) => R : (body: RequestOf<P>) => R;
+type MethodFor<P extends RpcPath> = IsPaginated<P> extends true ? Fn<P, ListCall<P>> : Fn<P, Promise<SuccessOf<P>>>;
+/** The result of a full incremental sync: every changed item plus the token for next time. */
+export interface SyncResult<P extends RpcPath> {
+    results: ItemOf<P>[];
+    /** Pass this back as `syncToken` on the next sync to fetch only what changed since. */
+    syncToken: string | undefined;
+}
+type SyncFor<P extends RpcPath> = (body?: Omit<RequestOf<P>, "cursor">) => Promise<SyncResult<P>>;
+type NsOf<P extends string> = P extends `/${infer N}.${string}` ? N : never;
+/** Every endpoint namespace, e.g. "application" | "candidate" | ... */
+export type Namespace = NsOf<RpcPath>;
+type SyncMethod<N extends string> = `/${N}.list` extends RpcPath ? HasSyncToken<`/${N}.list` & RpcPath> extends true ? {
+    sync: SyncFor<`/${N}.list` & RpcPath>;
+} : unknown : unknown;
+/**
+ * The full typed client surface: one namespace per Ashby resource,
+ * one method per endpoint, mapped directly from the OpenAPI spec.
+ */
+export type AshbyClient = {
+    [N in Namespace]: {
+        [P in RpcPath as P extends `/${N}.${infer V}` ? V : never]: MethodFor<P>;
+    } & SyncMethod<N>;
+};
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

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

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "ashby-ts",
+  "version": "0.1.0",
+  "description": "Typed TypeScript client for the Ashby API, generated from Ashby's OpenAPI spec. Every endpoint, fully typed, with async-iterator pagination and incremental sync.",
+  "license": "MIT",
+  "author": "Ryan Waits <ryan.waits@gmail.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ryanwaits/ashby-ts.git"
+  },
+  "homepage": "https://github.com/ryanwaits/ashby-ts#readme",
+  "bugs": "https://github.com/ryanwaits/ashby-ts/issues",
+  "keywords": [
+    "ashby",
+    "ashbyhq",
+    "ats",
+    "recruiting",
+    "api-client",
+    "typescript",
+    "openapi"
+  ],
+  "type": "module",
+  "packageManager": "bun@1.3.10",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "generate": "bun run scripts/generate.ts",
+    "docs": "bun run scripts/docs.ts",
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "test": "bun test",
+    "prepublishOnly": "bun run typecheck && bun test && bun run build"
+  },
+  "devDependencies": {
+    "@openpkg-ts/sdk": "0.37.1",
+    "@types/bun": "^1.3.14",
+    "@types/node": "^24.0.0",
+    "openapi-typescript": "^7.13.0",
+    "typescript": "^5.9.3"
+  }
+}