feat: initial SDK implementation — full TypeScript SDK for CloudLayer.io API

- 10 conversion methods: urlToPdf, urlToImage, htmlToPdf, htmlToImage,
  templateToPdf, templateToImage, docxToPdf, docxToHtml, pdfToDocx, mergePdfs
- 12 data management methods: jobs, assets, storage, account, status, templates
- 2 utility methods: downloadJobResult, waitForJob (5s default, 2s min)
- 42 TypeScript interfaces matching legacy v1/v2 API
- 7 error classes with status code mapping and request context
- HTTP transport with native fetch, retry logic, multipart support
- Client-side input validation (URL, timeout, quality, batch, async+storage)
- 113 unit tests with 90% coverage (vitest + mocked fetch)
- Dual ESM/CJS output via tsup with TypeScript declarations
- GitHub Actions CI (Node 18/20/22) and npm publish workflows
- Zero runtime dependencies (Node 18.13+ native fetch)

Package: @cloudlayerio/sdk v0.1.0

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: elucidsoft

.github/workflows/ci.yml

@@ -0,0 +1,47 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        node-version: [18, 20, 22]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Lint
+        run: npm run lint
+
+      - name: Format check
+        run: npm run format:check
+
+      - name: Type check
+        run: npm run typecheck
+
+      - name: Test with coverage
+        run: npm run test:coverage
+
+      - name: Build
+        run: npm run build
+
+      - name: Verify package
+        run: |
+          npm pack --dry-run
+          SIZE=$(npm pack --dry-run 2>&1 | grep "unpacked size" | grep -oP '[\d.]+\s*[kKmM]B' | head -1)
+          echo "Package unpacked size: $SIZE"

.github/workflows/publish.yml

@@ -0,0 +1,34 @@
+name: Publish to npm
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+
+    permissions:
+      contents: read
+      id-token: write
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          registry-url: https://registry.npmjs.org
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build
+        run: npm run build
+
+      - name: Publish
+        run: npm publish --provenance --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

.gitignore

@@ -0,0 +1,7 @@
+node_modules/
+dist/
+coverage/
+.env
+.env.*
+*.tgz
+.DS_Store

CHANGELOG.md

@@ -0,0 +1,14 @@
+# Changelog
+
+## 0.1.0 (Unreleased)
+
+### Added
+- Initial SDK release
+- Full TypeScript type system matching CloudLayer.io v1/v2 API
+- 10 conversion methods: `urlToPdf`, `urlToImage`, `htmlToPdf`, `htmlToImage`, `templateToPdf`, `templateToImage`, `docxToPdf`, `docxToHtml`, `pdfToDocx`, `mergePdfs`
+- Data management: `listJobs`, `getJob`, `listAssets`, `getAsset`, `listStorage`, `getStorage`, `addStorage`, `deleteStorage`, `getAccount`, `getStatus`, `listTemplates`, `getTemplate`
+- Utility methods: `downloadJobResult`, `waitForJob`
+- 7 error classes: `CloudLayerError`, `CloudLayerConfigError`, `CloudLayerApiError`, `CloudLayerAuthError`, `CloudLayerRateLimitError`, `CloudLayerTimeoutError`, `CloudLayerNetworkError`, `CloudLayerValidationError`
+- Automatic retries with exponential backoff for data endpoints
+- Client-side input validation
+- Dual ESM/CJS output with TypeScript declarations

CONTRIBUTING.md

@@ -0,0 +1,54 @@
+# Contributing to @cloudlayerio/sdk
+
+## Development Setup
+
+```bash
+git clone https://github.com/cloudlayerio/cloudlayerio-js.git
+cd cloudlayerio-js
+npm install
+```
+
+## Scripts
+
+| Command | Description |
+|---------|-------------|
+| `npm run build` | Build ESM + CJS + types |
+| `npm run dev` | Build in watch mode |
+| `npm test` | Run tests |
+| `npm run test:watch` | Run tests in watch mode |
+| `npm run test:coverage` | Run tests with coverage |
+| `npm run lint` | Lint with Biome |
+| `npm run lint:fix` | Auto-fix lint issues |
+| `npm run format` | Format with Biome |
+| `npm run format:check` | Check formatting |
+| `npm run typecheck` | TypeScript type checking |
+
+## Code Style
+
+This project uses [Biome](https://biomejs.dev/) for linting and formatting. Configuration is in `biome.json`.
+
+## Testing
+
+Tests use [Vitest](https://vitest.dev/) with mocked `fetch`. Test files live in `tests/` mirroring the `src/` structure.
+
+```bash
+npm test              # Run all tests
+npm run test:coverage # Run with coverage report
+```
+
+## Pull Request Process
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/my-feature`)
+3. Make your changes
+4. Run all quality checks: `npm run typecheck && npm test && npm run lint && npm run format:check`
+5. Commit and push
+6. Open a pull request
+
+## Release Process
+
+1. Update version in `package.json`
+2. Update `CHANGELOG.md`
+3. Commit: `chore: release vX.Y.Z`
+4. Create a GitHub Release with tag `vX.Y.Z`
+5. CI automatically publishes to npm