assembly-kit 0.0.1

package/dist/transport/http.d.mts

@@ -0,0 +1,14 @@
+//#region src/transport/http.d.ts
+interface RequestOpts {
+  searchParams?: Record<string, string | number | boolean>;
+}
+interface Transport {
+  get<T>(path: string, opts?: RequestOpts): Promise<T>;
+  post<T>(path: string, body?: unknown, opts?: RequestOpts): Promise<T>;
+  put<T>(path: string, body?: unknown, opts?: RequestOpts): Promise<T>;
+  patch<T>(path: string, body?: unknown, opts?: RequestOpts): Promise<T>;
+  delete(path: string, opts?: RequestOpts): Promise<void>;
+}
+//#endregion
+export { Transport };
+//# sourceMappingURL=http.d.mts.map

package/dist/transport/http.mjs

@@ -0,0 +1,142 @@
+import { AssemblyUnauthorizedError } from "../errors/unauthorized.mjs";
+import { AssemblyConnectionError } from "../errors/connection.mjs";
+import { AssemblyForbiddenError } from "../errors/forbidden.mjs";
+import { AssemblyNotFoundError } from "../errors/not-found.mjs";
+import { AssemblyRateLimitError } from "../errors/rate-limit.mjs";
+import { AssemblyServerError } from "../errors/server.mjs";
+import { AssemblyValidationError } from "../errors/validation.mjs";
+import ky, { HTTPError } from "ky";
+import pThrottle from "p-throttle";
+//#region src/transport/http.ts
+const DEFAULT_BASE_URL = "https://api.assembly.com";
+const DEFAULT_REQUESTS_PER_SECOND = 20;
+/**
+* Parses a `Retry-After` header value into seconds.
+* Supports both integer seconds and HTTP-date formats (RFC 7231).
+*/
+const parseRetryAfter = (header) => {
+	if (!header) return void 0;
+	const seconds = Number(header);
+	if (!Number.isNaN(seconds)) return seconds >= 0 ? seconds : void 0;
+	const dateMs = Date.parse(header);
+	if (!Number.isNaN(dateMs)) {
+		const delayMs = dateMs - Date.now();
+		return delayMs > 0 ? Math.ceil(delayMs / 1e3) : 0;
+	}
+};
+const tryParseBody = async (response) => {
+	try {
+		return await response.clone().json();
+	} catch {
+		return;
+	}
+};
+const createErrorForStatus = (status, cause, details, retryAfterHeader) => {
+	switch (status) {
+		case 400:
+		case 422: return new AssemblyValidationError({
+			cause,
+			details
+		});
+		case 401: return new AssemblyUnauthorizedError({
+			cause,
+			details
+		});
+		case 403: return new AssemblyForbiddenError({
+			cause,
+			details
+		});
+		case 404: return new AssemblyNotFoundError({
+			cause,
+			details
+		});
+		case 429: return new AssemblyRateLimitError({
+			cause,
+			details,
+			retryAfter: parseRetryAfter(retryAfterHeader)
+		});
+		default:
+			if (status >= 500) return new AssemblyServerError({
+				cause,
+				details
+			});
+			return new AssemblyConnectionError({
+				cause,
+				details,
+				message: `Unexpected HTTP ${status}`
+			});
+	}
+};
+const mapHttpError = async (error) => {
+	const { response } = error;
+	const details = await tryParseBody(response);
+	return createErrorForStatus(response.status, error, details, response.headers.get("Retry-After"));
+};
+const stripLeadingSlash = (path) => path.startsWith("/") ? path.slice(1) : path;
+const withErrorMapping = async (request) => {
+	try {
+		return await request;
+	} catch (error) {
+		if (error instanceof HTTPError) throw await mapHttpError(error);
+		throw new AssemblyConnectionError({ cause: error });
+	}
+};
+/**
+* Creates an HTTP transport backed by `ky` with rate limiting, retry,
+* auth headers, and structured error mapping. Each call produces a fully
+* independent instance (safe for serverless / multi-tenant).
+*/
+const createTransport = (options) => {
+	const acquireSlot = pThrottle({
+		interval: 1e3,
+		limit: options.requestsPerSecond ?? DEFAULT_REQUESTS_PER_SECOND
+	})(async () => {});
+	const api = ky.create({
+		headers: {
+			"X-API-Key": options.compoundKey,
+			"X-Assembly-SDK-Version": options.sdkVersion
+		},
+		hooks: { beforeRequest: [async () => {
+			await acquireSlot();
+		}] },
+		prefix: options.baseUrl ?? DEFAULT_BASE_URL,
+		retry: {
+			limit: options.retryCount ?? 2,
+			methods: [
+				"get",
+				"post",
+				"put",
+				"patch",
+				"delete"
+			]
+		},
+		...options.fetch ? { fetch: options.fetch } : {}
+	});
+	return {
+		get: (path, opts) => withErrorMapping(api.get(stripLeadingSlash(path), { searchParams: opts?.searchParams }).json()),
+		post: (path, body, opts) => withErrorMapping(api.post(stripLeadingSlash(path), {
+			json: body,
+			searchParams: opts?.searchParams
+		}).json()),
+		put: (path, body, opts) => withErrorMapping(api.put(stripLeadingSlash(path), {
+			json: body,
+			searchParams: opts?.searchParams
+		}).json()),
+		patch: (path, body, opts) => withErrorMapping(api.patch(stripLeadingSlash(path), {
+			json: body,
+			searchParams: opts?.searchParams
+		}).json()),
+		delete: async (path, opts) => {
+			try {
+				await api.delete(stripLeadingSlash(path), { searchParams: opts?.searchParams });
+			} catch (error) {
+				if (error instanceof HTTPError) throw await mapHttpError(error);
+				throw new AssemblyConnectionError({ cause: error });
+			}
+		}
+	};
+};
+//#endregion
+export { createTransport };
+
+//# sourceMappingURL=http.mjs.map

package/dist/transport/http.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.mjs","names":[],"sources":["../../src/transport/http.ts"],"sourcesContent":["import ky, { HTTPError } from \"ky\";\nimport pThrottle from \"p-throttle\";\nimport type { AssemblyError } from \"src/errors/base\";\nimport { AssemblyConnectionError } from \"src/errors/connection\";\nimport { AssemblyForbiddenError } from \"src/errors/forbidden\";\nimport { AssemblyNotFoundError } from \"src/errors/not-found\";\nimport { AssemblyRateLimitError } from \"src/errors/rate-limit\";\nimport { AssemblyServerError } from \"src/errors/server\";\nimport { AssemblyUnauthorizedError } from \"src/errors/unauthorized\";\nimport { AssemblyValidationError } from \"src/errors/validation\";\n\nconst DEFAULT_BASE_URL: string = \"https://api.assembly.com\";\nconst DEFAULT_REQUESTS_PER_SECOND: number = 20;\n\n// ---------------------------------------------------------------------------\n// Public types\n// ---------------------------------------------------------------------------\n\nexport interface TransportOptions {\n  /** Pre-built compound key value for the `X-API-Key` header. */\n  compoundKey: string;\n  /** SDK version string for the `X-Assembly-SDK-Version` header. */\n  sdkVersion: string;\n  /** Base URL for all API requests. Defaults to the Assembly API. */\n  baseUrl?: string;\n  /** Maximum number of retry attempts for retryable errors (ky default: 2). */\n  retryCount?: number;\n  /** Maximum requests per second for the sliding-window rate limiter. */\n  requestsPerSecond?: number;\n  /** Injectable fetch function for testing. Defaults to global `fetch`. */\n  fetch?: typeof globalThis.fetch;\n}\n\nexport interface RequestOpts {\n  searchParams?: Record<string, string | number | boolean>;\n}\n\nexport interface Transport {\n  get<T>(path: string, opts?: RequestOpts): Promise<T>;\n  post<T>(path: string, body?: unknown, opts?: RequestOpts): Promise<T>;\n  put<T>(path: string, body?: unknown, opts?: RequestOpts): Promise<T>;\n  patch<T>(path: string, body?: unknown, opts?: RequestOpts): Promise<T>;\n  delete(path: string, opts?: RequestOpts): Promise<void>;\n}\n\n// ---------------------------------------------------------------------------\n// Retry-After parsing\n// ---------------------------------------------------------------------------\n\n/**\n * Parses a `Retry-After` header value into seconds.\n * Supports both integer seconds and HTTP-date formats (RFC 7231).\n */\nexport const parseRetryAfter = (header: string | null): number | undefined => {\n  if (!header) return undefined;\n\n  const seconds = Number(header);\n  if (!Number.isNaN(seconds)) return seconds >= 0 ? seconds : undefined;\n\n  const dateMs = Date.parse(header);\n  if (!Number.isNaN(dateMs)) {\n    const delayMs = dateMs - Date.now();\n    return delayMs > 0 ? Math.ceil(delayMs / 1000) : 0;\n  }\n\n  return undefined;\n};\n\n// ---------------------------------------------------------------------------\n// Error mapping\n// ---------------------------------------------------------------------------\n\nconst tryParseBody = async (response: Response): Promise<unknown> => {\n  try {\n    return await response.clone().json();\n  } catch {\n    return undefined;\n  }\n};\n\nconst createErrorForStatus = (\n  status: number,\n  cause: HTTPError,\n  details: unknown,\n  retryAfterHeader: string | null,\n): AssemblyError => {\n  switch (status) {\n    case 400:\n    case 422:\n      return new AssemblyValidationError({ cause, details });\n    case 401:\n      return new AssemblyUnauthorizedError({ cause, details });\n    case 403:\n      return new AssemblyForbiddenError({ cause, details });\n    case 404:\n      return new AssemblyNotFoundError({ cause, details });\n    case 429:\n      return new AssemblyRateLimitError({\n        cause,\n        details,\n        retryAfter: parseRetryAfter(retryAfterHeader),\n      });\n    default:\n      if (status >= 500) {\n        return new AssemblyServerError({ cause, details });\n      }\n      return new AssemblyConnectionError({\n        cause,\n        details,\n        message: `Unexpected HTTP ${status}`,\n      });\n  }\n};\n\nconst mapHttpError = async (error: HTTPError): Promise<AssemblyError> => {\n  const { response } = error;\n  const details = await tryParseBody(response);\n  return createErrorForStatus(response.status, error, details, response.headers.get(\"Retry-After\"));\n};\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\nconst stripLeadingSlash = (path: string): string => (path.startsWith(\"/\") ? path.slice(1) : path);\n\nconst withErrorMapping = async <T>(request: Promise<T>): Promise<T> => {\n  try {\n    return await request;\n  } catch (error) {\n    if (error instanceof HTTPError) {\n      throw await mapHttpError(error);\n    }\n    throw new AssemblyConnectionError({ cause: error });\n  }\n};\n\n// ---------------------------------------------------------------------------\n// Transport factory\n// ---------------------------------------------------------------------------\n\n/**\n * Creates an HTTP transport backed by `ky` with rate limiting, retry,\n * auth headers, and structured error mapping. Each call produces a fully\n * independent instance (safe for serverless / multi-tenant).\n */\nexport const createTransport = (options: TransportOptions): Transport => {\n  const acquireSlot = pThrottle({\n    interval: 1000,\n    limit: options.requestsPerSecond ?? DEFAULT_REQUESTS_PER_SECOND,\n  })(async (): Promise<void> => {});\n\n  const api = ky.create({\n    headers: {\n      \"X-API-Key\": options.compoundKey,\n      \"X-Assembly-SDK-Version\": options.sdkVersion,\n    },\n    hooks: {\n      beforeRequest: [\n        async (): Promise<void> => {\n          await acquireSlot();\n        },\n      ],\n    },\n    prefix: options.baseUrl ?? DEFAULT_BASE_URL,\n    retry: {\n      limit: options.retryCount ?? 2,\n      methods: [\"get\", \"post\", \"put\", \"patch\", \"delete\"],\n    },\n    ...(options.fetch ? { fetch: options.fetch } : {}),\n  });\n\n  return {\n    get: <T>(path: string, opts?: RequestOpts): Promise<T> =>\n      withErrorMapping(\n        api\n          .get(stripLeadingSlash(path), {\n            searchParams: opts?.searchParams,\n          })\n          .json<T>(),\n      ),\n\n    post: <T>(path: string, body?: unknown, opts?: RequestOpts): Promise<T> =>\n      withErrorMapping(\n        api\n          .post(stripLeadingSlash(path), {\n            json: body,\n            searchParams: opts?.searchParams,\n          })\n          .json<T>(),\n      ),\n\n    put: <T>(path: string, body?: unknown, opts?: RequestOpts): Promise<T> =>\n      withErrorMapping(\n        api\n          .put(stripLeadingSlash(path), {\n            json: body,\n            searchParams: opts?.searchParams,\n          })\n          .json<T>(),\n      ),\n\n    patch: <T>(path: string, body?: unknown, opts?: RequestOpts): Promise<T> =>\n      withErrorMapping(\n        api\n          .patch(stripLeadingSlash(path), {\n            json: body,\n            searchParams: opts?.searchParams,\n          })\n          .json<T>(),\n      ),\n\n    delete: async (path: string, opts?: RequestOpts): Promise<void> => {\n      try {\n        await api.delete(stripLeadingSlash(path), {\n          searchParams: opts?.searchParams,\n        });\n      } catch (error) {\n        if (error instanceof HTTPError) {\n          throw await mapHttpError(error);\n        }\n        throw new AssemblyConnectionError({ cause: error });\n      }\n    },\n  };\n};\n"],"mappings":"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"}

package/dist/transport/parse-response.mjs

@@ -0,0 +1,17 @@
+import { AssemblyResponseParseError } from "../errors/response-parse.mjs";
+//#region src/transport/parse-response.ts
+/**
+* Optionally validates `data` against a Zod schema.
+* When `validate` is false, returns `data` as-is (cast to `T`).
+* When `validate` is true and parsing fails, throws `AssemblyResponseParseError`.
+*/
+const parseResponse = ({ schema, data, validate }) => {
+	if (!validate) return data;
+	const result = schema.safeParse(data);
+	if (!result.success) throw new AssemblyResponseParseError({ cause: result.error });
+	return result.data;
+};
+//#endregion
+export { parseResponse };
+
+//# sourceMappingURL=parse-response.mjs.map

package/dist/transport/parse-response.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-response.mjs","names":[],"sources":["../../src/transport/parse-response.ts"],"sourcesContent":["import { AssemblyResponseParseError } from \"src/errors/response-parse\";\nimport type { z } from \"zod\";\n\n/**\n * Optionally validates `data` against a Zod schema.\n * When `validate` is false, returns `data` as-is (cast to `T`).\n * When `validate` is true and parsing fails, throws `AssemblyResponseParseError`.\n */\nexport const parseResponse = <T>({\n  schema,\n  data,\n  validate,\n}: {\n  schema: z.ZodType<T>;\n  data: unknown;\n  validate: boolean;\n}): T => {\n  if (!validate) return data as T;\n\n  const result = schema.safeParse(data);\n  if (!result.success) {\n    throw new AssemblyResponseParseError({ cause: result.error });\n  }\n  return result.data;\n};\n"],"mappings":";;;;;;;AAQA,MAAa,iBAAoB,EAC/B,QACA,MACA,eAKO;AACP,KAAI,CAAC,SAAU,QAAO;CAEtB,MAAM,SAAS,OAAO,UAAU,KAAK;AACrC,KAAI,CAAC,OAAO,QACV,OAAM,IAAI,2BAA2B,EAAE,OAAO,OAAO,OAAO,CAAC;AAE/D,QAAO,OAAO"}

package/dist/version.mjs

@@ -0,0 +1,7 @@
+//#region src/version.ts
+/** SDK version string sent with every API request. */
+const SDK_VERSION = "2.0.8";
+//#endregion
+export { SDK_VERSION };
+
+//# sourceMappingURL=version.mjs.map

package/dist/version.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.mjs","names":[],"sources":["../src/version.ts"],"sourcesContent":["/** SDK version string sent with every API request. */\nexport const SDK_VERSION: string = \"2.0.8\";\n"],"mappings":";;AACA,MAAa,cAAsB"}

package/package.json

@@ -0,0 +1,93 @@
+{
+  "name": "assembly-kit",
+  "version": "0.0.1",
+  "description": "TypeScript SDK for the Assembly platform",
+  "homepage": "https://github.com/outsidestudio/assembly-kit#readme",
+  "bugs": {
+    "url": "https://github.com/outsidestudio/assembly-kit/issues"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/outsidestudio/assembly-kit.git"
+  },
+  "files": [
+    "dist",
+    "CLAUDE.md"
+  ],
+  "type": "module",
+  "exports": {
+    ".": "./dist/index.mjs",
+    "./bridge-ui": "./dist/bridge-ui/index.mjs",
+    "./client": "./dist/client/index.mjs",
+    "./errors": "./dist/errors/index.mjs",
+    "./logger": "./dist/logger/index.mjs",
+    "./schemas": "./dist/schemas/index.mjs",
+    "./token": "./dist/token/index.mjs",
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "vp pack",
+    "dev": "vp pack --watch",
+    "test": "vp test",
+    "check": "vp check",
+    "release": "bumpp --commit --push --tag",
+    "prepublishOnly": "vp run build",
+    "prepare": "vp config"
+  },
+  "dependencies": {
+    "ky": "^2.0.2",
+    "p-throttle": "^8.1.0"
+  },
+  "devDependencies": {
+    "@assembly-js/app-bridge": "^1.1.1",
+    "@types/node": "^25.6.0",
+    "@types/react": "^19.2.14",
+    "@typescript/native-preview": "7.0.0-dev.20260505.1",
+    "bumpp": "^11.0.1",
+    "pino": "^10.3.1",
+    "pino-pretty": "^13.1.3",
+    "react": "^19.2.5",
+    "typescript": "^6.0.3",
+    "vite-plus": "^0.1.20",
+    "zod": "^4.4.3"
+  },
+  "peerDependencies": {
+    "@assembly-js/app-bridge": "^1.1.1",
+    "pino": ">=9",
+    "pino-pretty": ">=10",
+    "react": ">=18",
+    "typescript": ">=5",
+    "zod": ">=4"
+  },
+  "peerDependenciesMeta": {
+    "@assembly-js/app-bridge": {
+      "optional": true
+    },
+    "pino": {
+      "optional": true
+    },
+    "pino-pretty": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    },
+    "typescript": {
+      "optional": true
+    },
+    "zod": {
+      "optional": true
+    }
+  },
+  "packageManager": "bun@1.3.12",
+  "pnpm": {
+    "overrides": {
+      "vite": "npm:@voidzero-dev/vite-plus-core@latest",
+      "vitest": "npm:@voidzero-dev/vite-plus-test@latest"
+    }
+  }
+}