@crawlora-org/sdk 1.2.0-sdk.11

package/CHANGELOG.md

@@ -0,0 +1,71 @@
+# Changelog
+
+## v1.2.0-sdk.11
+
+- Added operation-id parameter and response maps so dynamic `request` and
+  `operation` calls infer types from literal operation ids.
+- Added type-usage coverage for typed dynamic calls and kept runtime call
+  shapes unchanged.
+- Published the SDK to npmjs while keeping the GitHub Packages mirror active.
+
+## v1.2.0-sdk.10
+
+- Generated OpenAPI schema model interfaces and aliases for endpoint responses
+  and body parameters.
+- Updated typed endpoint declarations to return concrete response aliases while
+  keeping runtime call shapes unchanged.
+
+## v1.2.0-sdk.9
+
+- Added fail-fast enum validation for generated query and form parameters.
+- Wrapped malformed JSON responses in `CrawloraError` with response status,
+  raw response text, and parser cause details.
+
+## v1.2.0-sdk.8
+
+- Regenerated from the SDK spec that excludes deprecated endpoints.
+- Removed the deprecated Google Lens example and generated SDK surface.
+
+## v1.2.0-sdk.7
+
+- Added fail-fast validation for required query, form, and body parameters.
+- Normalized negative retry settings while preserving the public client API.
+
+## v1.2.0-sdk.6
+
+- Added runnable Bing search, YouTube transcript, and Google Lens upload
+  examples.
+- Added npm example scripts and an optional `smoke:live` command that skips
+  cleanly when live credentials or inputs are absent.
+- Published the beta SDK to GitHub Packages as `@crawlora-org/sdk`.
+
+## v1.2.0-sdk.5
+
+- Prepared the SDK for future npm publishing as `@crawlora-org/sdk`.
+- Updated package identity, public import examples, and registry-readiness
+  documentation.
+
+## v1.2.0-sdk.4
+
+- Added release-readiness files, CI, license, fuller README guidance, and npm
+  package metadata.
+- Kept endpoint behavior and generated operation contract unchanged.
+
+## v1.2.0-sdk.3
+
+- Added generated TypeScript endpoint declarations for operation ids, groups,
+  params, enum values, and response aliases.
+
+## v1.2.0-sdk.2
+
+- Improved retries, request options, user agent handling, multipart support,
+  response parsing, and SDK error details.
+
+## v1.2.0-sdk.1
+
+- Cleaned public SDK docs to avoid maintainer-only generation details.
+
+## Initial SDK
+
+- Added the first Git-installable Crawlora JavaScript SDK generated from the
+  public API contract.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Crawlora
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,103 @@
+# Crawlora JavaScript SDK
+
+JavaScript and TypeScript SDK for the public Crawlora API. It works in Node.js
+18+ and modern runtimes with `fetch`.
+
+Website: [crawlora.net](https://crawlora.net)
+
+## Install
+
+```sh
+npm install @crawlora-org/sdk@latest
+```
+
+For reproducible builds, pin the current package version:
+
+```sh
+npm install @crawlora-org/sdk@1.2.0-sdk.11
+```
+
+## Usage
+
+```js
+import { CrawloraClient } from "@crawlora-org/sdk";
+
+const crawlora = new CrawloraClient({ apiKey: process.env.CRAWLORA_API_KEY });
+const result = await crawlora.bing.search({ q: "coffee shops", count: 10 });
+console.log(result);
+```
+
+Generated TypeScript declarations cover operation ids, endpoint groups,
+parameter objects, enum values, request options, and response aliases.
+Dynamic calls infer parameter and response types from literal operation ids:
+
+```ts
+const result = await crawlora.request("bing-search", { q: "coffee shops" });
+result.data?.results?.[0]?.title;
+```
+
+## Configuration
+
+```js
+const crawlora = new CrawloraClient({
+  apiKey: process.env.CRAWLORA_API_KEY,
+  baseUrl: "https://api.crawlora.net/api/v1",
+  retries: 2,
+  retryDelay: 250,
+  headers: { "x-client": "example" }
+});
+```
+
+Per-request options support headers, timeout, abort signals, and response mode:
+
+```js
+const text = await crawlora.youtube.transcript(
+  { id: "VIDEO_ID", format: "text" },
+  { responseType: "text", timeout: 10000 }
+);
+```
+
+Failed API calls throw `CrawloraError` with `status`, optional API `code`,
+parsed `body`, and the original `response` when available.
+
+## Examples
+
+Runnable examples live under `examples/`:
+
+```sh
+CRAWLORA_API_KEY=... npm run example:bing-search
+CRAWLORA_API_KEY=... CRAWLORA_YOUTUBE_VIDEO_ID=... npm run example:youtube-transcript
+```
+
+Each example also accepts `CRAWLORA_BASE_URL` for staging or local API testing.
+The examples exit without making a request when the required live environment
+variables are not set. `npm run smoke:live` runs all live examples in sequence.
+
+## Versioning
+
+This SDK is published to npmjs and mirrored to GitHub Packages. The package
+`latest` dist-tag and the moving Git tag named `latest` track the current
+promoted beta. Explicit package versions and Git beta tags such as
+`1.2.0-sdk.11` / `v1.2.0-sdk.11` remain available for reproducible builds. Pin
+an explicit version in production applications and upgrade intentionally.
+
+GitHub Packages installs require a project `.npmrc` that maps the
+`@crawlora-org` scope to `https://npm.pkg.github.com` and a GitHub token that
+can read packages.
+
+## Package Name
+
+The npm package name is `@crawlora-org/sdk`:
+
+```js
+import { CrawloraClient } from "@crawlora-org/sdk";
+```
+
+The package names `crawlora` and `@crawlora/sdk` are not used by this repository
+because they already exist on npm and point to a different package source.
+
+## Optional Live Smoke Test
+
+Default tests use mock `fetch` implementations. The programs under `examples/`
+can be used as optional live smoke tests when `CRAWLORA_API_KEY` is available.
+Live calls are not part of default CI.

package/examples/bing-search.mjs

@@ -0,0 +1,18 @@
+import { CrawloraClient } from "../src/index.js";
+
+const client = newClient();
+if (client) {
+  const result = await client.bing.search({ q: "coffee shops", count: 5 });
+  console.log(JSON.stringify(result, null, 2));
+}
+
+function newClient() {
+  if (!process.env.CRAWLORA_API_KEY) {
+    console.error("set CRAWLORA_API_KEY to run this live example");
+    return null;
+  }
+  return new CrawloraClient({
+    apiKey: process.env.CRAWLORA_API_KEY,
+    baseUrl: process.env.CRAWLORA_BASE_URL
+  });
+}

package/examples/youtube-transcript.mjs

@@ -0,0 +1,26 @@
+import { CrawloraClient } from "../src/index.js";
+
+const client = newClient();
+if (client) {
+  const videoId = process.argv[2] || process.env.CRAWLORA_YOUTUBE_VIDEO_ID;
+  if (!videoId) {
+    console.error("set CRAWLORA_YOUTUBE_VIDEO_ID or pass a video id to run this live example");
+  } else {
+    const text = await client.youtube.transcript(
+      { id: videoId, format: "text" },
+      { responseType: "text" }
+    );
+    console.log(text);
+  }
+}
+
+function newClient() {
+  if (!process.env.CRAWLORA_API_KEY) {
+    console.error("set CRAWLORA_API_KEY to run this live example");
+    return null;
+  }
+  return new CrawloraClient({
+    apiKey: process.env.CRAWLORA_API_KEY,
+    baseUrl: process.env.CRAWLORA_BASE_URL
+  });
+}