@codize/sdk 0.0.0

package/dist/index.d.mts

@@ -0,0 +1,191 @@
+import * as v from "valibot";
+
+//#region src/client.d.ts
+/**
+ * Internal `fetch`-compatible function signature used by the client.
+ */
+type FetchFn = (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
+/**
+ * Options for creating a {@link CodizeClient} instance.
+ */
+type CodizeClientOptions = {
+  /**
+   * API key issued by Codize.
+   */
+  apiKey: string;
+  /**
+   * Custom `fetch` implementation.
+   *
+   * Useful for tests, custom environments, or transport-level instrumentation.
+   */
+  fetchFn?: FetchFn;
+};
+/**
+ * Request payload for `sandbox.execute`.
+ */
+type SandboxExecuteRequest = {
+  /**
+   * Language name used for execution.
+   */
+  language: "go" | "javascript" | "python" | "ruby" | "rust" | "typescript" | (string & {});
+  /**
+   * Source files to execute, with their content.
+   */
+  files: {
+    /**
+     * File name
+     */
+    name: string;
+    /**
+     * Full text content of the file.
+     */
+    content: string;
+  }[];
+};
+/**
+ * Response returned by `sandbox.execute`.
+ */
+type SandboxExecuteResponse = {
+  /**
+   * Raw HTTP response headers.
+   */
+  headers: Headers;
+  data: {
+    /**
+     * Compile-stage output, if the selected language has a compile step.
+     */
+    compile: SandboxStageResult | null;
+    /**
+     * Run-stage output.
+     */
+    run: SandboxStageResult;
+  };
+};
+/**
+ * Output for a single sandbox stage (compile or run).
+ */
+type SandboxStageResult = {
+  /**
+   * Standard output.
+   */
+  stdout: string;
+  /**
+   * Standard error.
+   */
+  stderr: string;
+  /**
+   * Combined output of stdout and stderr
+   */
+  output: string;
+  /**
+   * Process exit code.
+   */
+  exitCode: number | null;
+};
+/**
+ * API client for Codize.
+ */
+declare class CodizeClient {
+  private readonly _apiKey;
+  private readonly _fetchFn;
+  private readonly _baseUrl;
+  /**
+   * Namespace for sandbox APIs.
+   */
+  readonly sandbox: {
+    /**
+     * Executes code in the Codize sandbox.
+     *
+     * @param request Execution request containing language and files.
+     * @returns Stage results and raw response headers.
+     */
+    execute: (request: SandboxExecuteRequest) => Promise<SandboxExecuteResponse>;
+  };
+  /**
+   * Creates a new client.
+   *
+   * @param options Client configuration.
+   */
+  constructor(options: CodizeClientOptions);
+  /**
+   * Sends an execution request to the sandbox endpoint.
+   *
+   * @param request Execution request payload.
+   * @returns Parsed sandbox execution response.
+   */
+  private _sandboxExecute;
+  /**
+   * Converts a failed HTTP response into a rich error object.
+   *
+   * @param response Failed API response.
+   * @returns Structured {@link CodizeApiError} when possible, otherwise `Error`.
+   */
+  private _apiError;
+}
+//#endregion
+//#region src/error.d.ts
+/**
+ * Schema for a single detailed validation error item returned by the API.
+ */
+declare const apiErrorDetailsSchema: v.ObjectSchema<{
+  readonly message: v.StringSchema<undefined>;
+  readonly path: v.ArraySchema<v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, undefined>;
+}, undefined>;
+/**
+ * Detailed validation error information returned by the API.
+ */
+type ApiErrorDetails = v.InferOutput<typeof apiErrorDetailsSchema>;
+/**
+ * API error code.
+ */
+type ApiErrorCode = "UNAUTHORIZED" | "INTERNAL_ERROR" | "RATE_LIMITED" | "NOT_FOUND" | "VALIDATION_ERROR" | (string & {});
+/**
+ * API error response.
+ */
+type ApiErrorResponse = {
+  error: {
+    /**
+     * Machine-readable error code.
+     */
+    code: ApiErrorCode;
+    /**
+     * Human-readable error message.
+     */
+    message: string;
+    /**
+     * Optional field-level validation errors.
+     */
+    errors?: ApiErrorDetails[];
+  };
+};
+/**
+ * Error thrown for non-2xx API responses with a structured error body.
+ */
+declare class CodizeApiError extends Error {
+  /**
+   * Machine-readable API error code.
+   */
+  readonly code: ApiErrorResponse["error"]["code"];
+  /**
+   * Optional field-level validation errors.
+   */
+  readonly errors?: ApiErrorResponse["error"]["errors"];
+  /**
+   * HTTP status code of the response.
+   */
+  readonly status: number;
+  /**
+   * Raw response headers.
+   */
+  readonly headers: Headers;
+  /**
+   * Creates a rich API error object.
+   *
+   * @param status HTTP status code.
+   * @param headers Raw response headers.
+   * @param response Parsed API error payload.
+   */
+  constructor(status: number, headers: Headers, response: ApiErrorResponse);
+}
+//#endregion
+export { type ApiErrorCode, type ApiErrorDetails, type ApiErrorResponse, CodizeApiError, CodizeClient, type CodizeClientOptions, type SandboxExecuteRequest, type SandboxExecuteResponse, type SandboxStageResult };

package/dist/index.mjs

@@ -0,0 +1,126 @@
+import * as v from "valibot";
+
+//#region src/error.ts
+/**
+* Schema for a single detailed validation error item returned by the API.
+*/
+const apiErrorDetailsSchema = v.object({
+	message: v.string(),
+	path: v.array(v.union([v.string(), v.number()]))
+});
+/**
+* Schema for the top-level API error response payload.
+*/
+const apiErrorResponseSchema = v.object({ error: v.object({
+	code: v.string(),
+	message: v.string(),
+	errors: v.optional(v.array(apiErrorDetailsSchema))
+}) });
+/**
+* Error thrown for non-2xx API responses with a structured error body.
+*/
+var CodizeApiError = class extends Error {
+	/**
+	* Machine-readable API error code.
+	*/
+	code;
+	/**
+	* Optional field-level validation errors.
+	*/
+	errors;
+	/**
+	* HTTP status code of the response.
+	*/
+	status;
+	/**
+	* Raw response headers.
+	*/
+	headers;
+	/**
+	* Creates a rich API error object.
+	*
+	* @param status HTTP status code.
+	* @param headers Raw response headers.
+	* @param response Parsed API error payload.
+	*/
+	constructor(status, headers, response) {
+		super(response.error.message);
+		this.name = "CodizeApiError";
+		this.code = response.error.code;
+		this.message = response.error.message;
+		this.errors = response.error.errors;
+		this.status = status;
+		this.headers = headers;
+	}
+};
+
+//#endregion
+//#region src/client.ts
+/**
+* API client for Codize.
+*/
+var CodizeClient = class {
+	_apiKey;
+	_fetchFn;
+	_baseUrl = "https://codize.dev";
+	/**
+	* Namespace for sandbox APIs.
+	*/
+	sandbox;
+	/**
+	* Creates a new client.
+	*
+	* @param options Client configuration.
+	*/
+	constructor(options) {
+		this._apiKey = options.apiKey;
+		this._fetchFn = options.fetchFn ?? fetch.bind(globalThis);
+		this.sandbox = { execute: this._sandboxExecute.bind(this) };
+	}
+	/**
+	* Sends an execution request to the sandbox endpoint.
+	*
+	* @param request Execution request payload.
+	* @returns Parsed sandbox execution response.
+	*/
+	async _sandboxExecute(request) {
+		const response = await this._fetchFn(new URL("/api/v1/sandbox/execute", this._baseUrl), {
+			method: "POST",
+			headers: {
+				"Content-Type": "application/json",
+				Authorization: `Bearer ${this._apiKey}`
+			},
+			body: JSON.stringify(request)
+		});
+		if (!response.ok) throw await this._apiError(response);
+		const data = await response.json();
+		return {
+			headers: response.headers,
+			data: {
+				compile: data.compile,
+				run: data.run
+			}
+		};
+	}
+	/**
+	* Converts a failed HTTP response into a rich error object.
+	*
+	* @param response Failed API response.
+	* @returns Structured {@link CodizeApiError} when possible, otherwise `Error`.
+	*/
+	async _apiError(response) {
+		const errorData = await response.text();
+		let parsedJson;
+		try {
+			parsedJson = JSON.parse(errorData);
+		} catch {
+			return /* @__PURE__ */ new Error(`Unexpected API error: ${response.status} ${response.statusText} - ${errorData}`);
+		}
+		const parsedError = v.safeParse(apiErrorResponseSchema, parsedJson);
+		if (parsedError.success) return new CodizeApiError(response.status, response.headers, parsedError.output);
+		else return /* @__PURE__ */ new Error(`Unexpected API error: ${response.status} ${response.statusText} - ${errorData}`);
+	}
+};
+
+//#endregion
+export { CodizeApiError, CodizeClient };

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@codize/sdk",
+  "version": "0.0.0",
+  "description": "Official TypeScript SDK for the Codize API",
+  "homepage": "https://github.com/codize-dev/sdk",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/codize-dev/sdk.git",
+    "directory": "typescript"
+  },
+  "license": "MIT",
+  "author": "koki-develop <kou.pg.0131@gmail.com>",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "default": "./dist/index.mjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsdown",
+    "prepublishOnly": "bun run build"
+  },
+  "devDependencies": {
+    "@types/bun": "1.3.9",
+    "tsdown": "0.21.0-beta.2",
+    "typescript": "5.9.3"
+  },
+  "dependencies": {
+    "valibot": "1.2.0"
+  }
+}