@liqhtworks/sophon-sdk 0.1.3 → 0.1.5

package/.github/CODEOWNERS

@@ -0,0 +1,6 @@
+# This repository is generated from Liqhtworks/sophon-api at every
+# release. Source-side changes (helpers, OpenAPI spec, generator
+# config) belong in that repo, not here. Filing issues / PRs against
+# this repo is fine — Liqhtworks engineers triage them and route the
+# fix upstream as needed.
+*       @Liqhtworks/engineering

package/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,34 @@
+---
+name: Bug report
+about: Something the SDK does that contradicts the docs or its types.
+title: "[bug] "
+labels: bug
+---
+
+## What happened
+
+<!-- What you tried to do, what the SDK did instead. -->
+
+## Reproducer
+
+```ts
+// Minimum code that reproduces. Strip secrets.
+import { Configuration, JobsApi } from "@liqhtworks/sophon-sdk";
+// …
+```
+
+## Environment
+
+- `@liqhtworks/sophon-sdk` version: `0.1.x`
+- Node / Bun / Deno version: `…`
+- OS: `…`
+- Running in: server-side / browser / edge runtime
+
+## Expected vs. actual
+
+- Expected: `…`
+- Actual: `…` (paste error message + stack trace inside a fenced block)
+
+## Anything else
+
+<!-- Logs, X-Request-Id headers from the response, network captures, etc. -->

package/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: false
+contact_links:
+  - name: SOPHON API documentation
+    url: https://registry.scalar.com/@liqhtworks/apis/sophon-encoding-api/latest
+    about: Reference for every endpoint the SDK wraps.
+  - name: API + spec issues (sophon-api)
+    url: https://github.com/Liqhtworks/sophon-api/issues
+    about: For server-side bugs or OpenAPI questions, file there. SDK bugs stay here.

package/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,20 @@
+---
+name: Feature request
+about: A capability you want from the SDK that isn't shipped.
+title: "[feature] "
+labels: enhancement
+---
+
+## What would you like the SDK to do
+
+<!-- Describe the customer-facing behavior, not the implementation. -->
+
+## What you tried instead
+
+<!-- Working around it today, or which competitor / hand-rolled tool you'd
+otherwise reach for. -->
+
+## Is this an SDK-level fit, or upstream?
+
+- [ ] SDK-level (helper, type, ergonomic)
+- [ ] Spec / API-level (would also need a sophon-api change)

package/CHANGELOG.md

@@ -0,0 +1,51 @@
+# Changelog
+
+All notable changes to `@liqhtworks/sophon-sdk` are recorded here. The
+package follows [SemVer](https://semver.org/) — see `README.md` for the
+versioning policy applied during the v0.x pre-1.0 phase.
+
+## [0.1.4] — 2026-05-08
+
+- `JobSource.upload(uploadId)` constructor — typed alternative to the
+  fragile `{ type: "upload", upload_id: "..." }` literal.
+- Generated exports tightened so all helpers and discriminated-union
+  constructors are reachable at the top level.
+- Build-test coverage extended over the new surface.
+
+## [0.1.3] — 2026-05-08
+
+- `UploadsApiLike` helper interface narrowed to only the fields the
+  helpers actually read. The previous declaration typed `expires_at`
+  as `string`, but the generated `UploadsApi` returns `Date`, so the
+  helper compiled in isolation but not against the real client. Fixed.
+
+## [0.1.2] — 2026-04-23
+
+- Per-route idempotency keys in `uploadFile`. Earlier releases reused
+  one key for both `createUpload` and `completeUpload`; SOPHON scopes
+  idempotency keys per route and rejected the second call with HTTP 409.
+  Now derives `${idem}/create` and `${idem}/complete` from the caller's
+  seed so retries still reach the server's idempotent path.
+- Build-test fixtures regenerate as real ffprobe-able media via ffmpeg.
+
+## [0.1.0] — 2026-04-23
+
+Initial public release.
+
+- Generated transport (`Configuration`, `JobsApi`, `UploadsApi`,
+  `WebhooksApi`, `DownloadsApi`, `HealthApi`) from the SOPHON OpenAPI
+  spec.
+- Hand-written helpers spliced on top of the generated client:
+  - `uploadFile` — chunked, concurrent, resumable upload with progress
+    reporting and bounded retry.
+  - `waitForJob` — typed terminal-state polling with backoff and
+    timeout.
+  - `verifyWebhookSignature` — constant-time HMAC-SHA256 verification
+    with a default replay window. Uses Web Crypto so it runs on Node
+    18+ and modern browsers.
+- Provenance signed via npm sigstore on every publish.
+
+[0.1.4]: https://github.com/Liqhtworks/sophon-sdk-typescript/releases/tag/v0.1.4
+[0.1.3]: https://github.com/Liqhtworks/sophon-sdk-typescript/releases/tag/v0.1.3
+[0.1.2]: https://github.com/Liqhtworks/sophon-sdk-typescript/releases/tag/v0.1.2
+[0.1.0]: https://github.com/Liqhtworks/sophon-sdk-typescript/releases/tag/v0.1.0

package/README.md

@@ -1,164 +1,166 @@
-# @liqhtworks/sophon-sdk@0.1.0
+# @liqhtworks/sophon-sdk
 
-A TypeScript SDK client for the api.liqhtworks.xyz API.
+Official TypeScript SDK for the SOPHON Encoding API.
 
-## Usage
+This repository is generated from `Liqhtworks/sophon-api`. The curated
+`README.md` and `examples/` directory are preserved across SDK regeneration.
 
-First, install the SDK from npm.
+## Install
 
 ```bash
-npm install @liqhtworks/sophon-sdk --save
+npm install @liqhtworks/sophon-sdk
 ```
 
-Next, try it out.
+Requires Node 18+ or a runtime with `fetch`, `Blob`, `AbortController`, and Web
+Crypto.
 
+## Get an API key
+
+1. Sign in at <https://liqhtworks.xyz/account/general>.
+2. In **API keys**, create a key for your server-side integration.
+3. Copy the `xt_live_...` token when it is shown. It is only shown once.
+4. Store it as an environment variable:
+
+```bash
+export SOPHON_API_KEY=xt_live_...
+export SOPHON_BASE_URL=https://api.liqhtworks.xyz
+```
+
+Keep API keys on the server. Do not ship them in browser bundles, mobile apps,
+public repos, logs, or analytics events.
+
+## Quick Start
+
+This is the smallest complete server-side flow: upload a local video, create an
+encode job, wait for completion, and download the MP4 output.
 
 ```ts
 import {
   Configuration,
-  DownloadsApi,
-} from '@liqhtworks/sophon-sdk';
-import type { DownloadRequest } from '@liqhtworks/sophon-sdk';
-
-async function example() {
-  console.log("🚀 Testing @liqhtworks/sophon-sdk SDK...");
-  const api = new DownloadsApi();
-
-  const body = {
-    // string | HMAC-signed download token encoding the object key and expiry.
-    token: token_example,
-  } satisfies DownloadRequest;
-
-  try {
-    const data = await api.download(body);
-    console.log(data);
-  } catch (error) {
-    console.error(error);
-  }
+  JobProfile,
+  JobSource,
+  JobStatus,
+  JobsApi,
+  UploadsApi,
+  uploadFile,
+  waitForJob,
+} from "@liqhtworks/sophon-sdk";
+import { Blob } from "node:buffer";
+import { randomUUID } from "node:crypto";
+import { readFile, writeFile } from "node:fs/promises";
+import { basename } from "node:path";
+
+const inputPath = process.argv[2] ?? "./source.mov";
+const apiKey = process.env.SOPHON_API_KEY;
+if (!apiKey) throw new Error("SOPHON_API_KEY is required");
+
+const basePath = process.env.SOPHON_BASE_URL ?? "https://api.liqhtworks.xyz";
+const config = new Configuration({
+  basePath,
+  accessToken: apiKey,
+});
+
+const uploads = new UploadsApi(config);
+const jobs = new JobsApi(config);
+
+const bytes = await readFile(inputPath);
+const mimeType = inputPath.endsWith(".mov") ? "video/quicktime" : "video/mp4";
+const source = new Blob([bytes], { type: mimeType });
+
+const upload = await uploadFile({
+  api: uploads,
+  source,
+  fileName: basename(inputPath),
+  mimeType,
+  concurrency: 4,
+  onProgress: (p) => console.log(`${p.partsDone}/${p.partsTotal} parts`),
+});
+
+const job = await jobs.createJob({
+  idempotencyKey: randomUUID(),
+  createJobRequest: {
+    source: JobSource.upload(upload.uploadId),
+    profile: JobProfile.SOPHON_ESPRESSO,
+  },
+});
+
+const final = await waitForJob({
+  api: jobs,
+  jobId: job.id,
+  timeoutMs: 30 * 60 * 1000,
+});
+if (final.status !== JobStatus.COMPLETED) {
+  throw new Error(`job ended in ${final.status}`);
 }
 
-// Run the test
-example().catch(console.error);
+const redirect = await fetch(`${basePath}/v1/jobs/${final.id}/output`, {
+  headers: { authorization: `Bearer ${apiKey}` },
+  redirect: "manual",
+});
+const location = redirect.headers.get("location");
+if (!location) throw new Error("missing output redirect");
+
+const download = await fetch(new URL(location, basePath));
+await writeFile("sophon-output.mp4", Buffer.from(await download.arrayBuffer()));
+
+console.log(`wrote sophon-output.mp4 from ${final.id}`);
 ```
 
+For a runnable copy of this flow, see
+[`examples/encode-file.mjs`](./examples/encode-file.mjs).
 
-## Documentation
-
-### API Endpoints
-
-All URIs are relative to *https://api.liqhtworks.xyz*
-
-| Class | Method | HTTP request | Description
-| ----- | ------ | ------------ | -------------
-*DownloadsApi* | [**download**](docs/DownloadsApi.md#download) | **GET** /v1/downloads/{token} | Download an output file via signed token
-*HealthApi* | [**healthz**](docs/HealthApi.md#healthz) | **GET** /healthz | Liveness probe
-*HealthApi* | [**readyz**](docs/HealthApi.md#readyz) | **GET** /readyz | Readiness probe
-*JobsApi* | [**cancelJob**](docs/JobsApi.md#canceljob) | **DELETE** /v1/jobs/{id} | Cancel a job
-*JobsApi* | [**createJob**](docs/JobsApi.md#createjoboperation) | **POST** /v1/jobs | Submit an encoding job
-*JobsApi* | [**getJob**](docs/JobsApi.md#getjob) | **GET** /v1/jobs/{id} | Get a single job by ID
-*JobsApi* | [**getJobOutput**](docs/JobsApi.md#getjoboutput) | **GET** /v1/jobs/{id}/output | Get the encoded output file
-*JobsApi* | [**listJobs**](docs/JobsApi.md#listjobs) | **GET** /v1/jobs | List jobs with cursor pagination
-*UploadsApi* | [**cancelUpload**](docs/UploadsApi.md#cancelupload) | **DELETE** /v1/uploads/{id} | Cancel an upload session
-*UploadsApi* | [**completeUpload**](docs/UploadsApi.md#completeupload) | **POST** /v1/uploads/{id}/complete | Finalize a chunked upload
-*UploadsApi* | [**createUpload**](docs/UploadsApi.md#createuploadoperation) | **POST** /v1/uploads | Initialize a chunked upload session
-*UploadsApi* | [**getUpload**](docs/UploadsApi.md#getupload) | **GET** /v1/uploads/{id} | Get upload session status
-*UploadsApi* | [**uploadPart**](docs/UploadsApi.md#uploadpart) | **PUT** /v1/uploads/{id}/parts/{part_number} | Upload a single chunk
-*WebhooksApi* | [**createWebhook**](docs/WebhooksApi.md#createwebhookoperation) | **POST** /v1/webhooks | Register a webhook endpoint
-*WebhooksApi* | [**deleteWebhook**](docs/WebhooksApi.md#deletewebhook) | **DELETE** /v1/webhooks/{id} | Soft-delete a webhook endpoint
-*WebhooksApi* | [**listWebhooks**](docs/WebhooksApi.md#listwebhooks) | **GET** /v1/webhooks | List active webhook endpoints
-
-
-### Models
-
-- [CompleteUploadResponse](docs/CompleteUploadResponse.md)
-- [CreateJobOutputOptions](docs/CreateJobOutputOptions.md)
-- [CreateJobRequest](docs/CreateJobRequest.md)
-- [CreateUploadRequest](docs/CreateUploadRequest.md)
-- [CreateUploadResponse](docs/CreateUploadResponse.md)
-- [CreateWebhookRequest](docs/CreateWebhookRequest.md)
-- [ErrorBody](docs/ErrorBody.md)
-- [ErrorEnvelope](docs/ErrorEnvelope.md)
-- [JobOutputInfo](docs/JobOutputInfo.md)
-- [JobProfile](docs/JobProfile.md)
-- [JobProgress](docs/JobProgress.md)
-- [JobResponse](docs/JobResponse.md)
-- [JobSourceInfo](docs/JobSourceInfo.md)
-- [JobSourceType](docs/JobSourceType.md)
-- [JobStatus](docs/JobStatus.md)
-- [ListJobsResponse](docs/ListJobsResponse.md)
-- [OutputContainer](docs/OutputContainer.md)
-- [ReadyResponse](docs/ReadyResponse.md)
-- [UploadJobSource](docs/UploadJobSource.md)
-- [UploadPartResponse](docs/UploadPartResponse.md)
-- [UploadStatusResponse](docs/UploadStatusResponse.md)
-- [WebhookDeliveryPayload](docs/WebhookDeliveryPayload.md)
-- [WebhookListItem](docs/WebhookListItem.md)
-- [WebhookListResponse](docs/WebhookListResponse.md)
-- [WebhookResponse](docs/WebhookResponse.md)
-
-### Authorization
-
-
-Authentication schemes defined for the API:
-<a id="bearerApiKey"></a>
-#### bearerApiKey
-
-
-- **Type**: HTTP Bearer Token authentication
-<a id="sessionCookie"></a>
-#### sessionCookie
-
-
-- **Type**: API key
-- **API key parameter name**: `sophon_api_session`
-- **Location**: 
-
-## About
-
-This TypeScript SDK client supports the [Fetch API](https://fetch.spec.whatwg.org/)
-and is automatically generated by the
-[OpenAPI Generator](https://openapi-generator.tech) project:
-
-- API version: `1.0.0`
-- Package version: `0.1.0`
-- Generator version: `7.21.0`
-- Build package: `org.openapitools.codegen.languages.TypeScriptFetchClientCodegen`
-
-The generated npm module supports the following:
-
-- Environments
-  * Node.js
-  * Webpack
-  * Browserify
-- Language levels
-  * ES5 - you must have a Promises/A+ library installed
-  * ES6
-- Module systems
-  * CommonJS
-  * ES6 module system
-
-For more information, please visit [https://liqhtworks.xyz](https://liqhtworks.xyz)
+For upload-only integration work, see
+[`examples/upload-node-path.mjs`](./examples/upload-node-path.mjs).
 
-## Development
+### Profile choice
 
-### Building
+Use `sophon-auto` for production unless you need deterministic encoder
+settings. The quickstart uses `sophon-espresso` because it is the fastest
+smoke-test profile and always produces a new encoded output.
 
-To build the TypeScript source code, you need to have Node.js and npm installed.
-After cloning the repository, navigate to the project directory and run:
+## Webhooks
+
+Use `verifyWebhookSignature` with the raw request body before JSON parsing.
+
+See [`examples/webhook-server`](./examples/webhook-server) for an Express
+handler that preserves the raw body, verifies `X-Turbo-Signature-256`, and only
+then parses JSON.
+
+## Helpers
+
+| Helper | Purpose |
+|---|---|
+| `uploadFile` | Chunked upload orchestration with bounded concurrency, retries, resume, and progress callbacks. |
+| `waitForJob` | Poll until terminal status with timeout and typed errors. |
+| `verifyWebhookSignature` | Constant-time HMAC verification plus replay-window enforcement. |
+
+## API Docs
+
+Generated endpoint/model docs live under [`docs/`](./docs).
+
+## Development
 
 ```bash
 npm install
 npm run build
 ```
 
-### Publishing
+## Versioning
 
-Once you've built the package, you can publish it to npm:
+`@liqhtworks/sophon-sdk` follows [SemVer](https://semver.org/), with one
+pre-1.0 caveat: while we are at `v0.x`, **minor bumps may include
+breaking changes**. Pin a tilde range until 1.0:
 
 ```bash
-npm publish
+npm install @liqhtworks/sophon-sdk@~0.1
 ```
 
+Patch releases (`0.1.x`) are always backward-compatible — they ship bug
+fixes, helper-layer improvements, and additive types. Once we cut
+`v1.0.0`, regular SemVer applies and breaking changes only land on
+major bumps. See [`CHANGELOG.md`](./CHANGELOG.md) for the per-release
+log.
+
 ## License
 
-[Proprietary]()
+Proprietary. See [`LICENSE`](./LICENSE).

package/dist/esm/helpers/index.d.ts

@@ -1,3 +1,4 @@
 export * from "./uploads";
 export * from "./jobs";
+export * from "./sources";
 export * from "./webhooks";

package/dist/esm/helpers/index.js

@@ -1,3 +1,4 @@
 export * from "./uploads";
 export * from "./jobs";
+export * from "./sources";
 export * from "./webhooks";

package/dist/esm/helpers/sources.d.ts

@@ -0,0 +1,8 @@
+export interface UploadJobSourceLike {
+    type: any;
+    upload_id: string;
+}
+export declare function uploadJobSource(uploadId: string): UploadJobSourceLike;
+export declare const JobSource: Readonly<{
+    upload: typeof uploadJobSource;
+}>;

package/dist/esm/helpers/sources.js

@@ -0,0 +1,6 @@
+export function uploadJobSource(uploadId) {
+    return { type: "upload", upload_id: uploadId };
+}
+export const JobSource = Object.freeze({
+    upload: uploadJobSource,
+});

package/dist/helpers/index.d.ts

@@ -1,3 +1,4 @@
 export * from "./uploads";
 export * from "./jobs";
+export * from "./sources";
 export * from "./webhooks";

package/dist/helpers/index.js

@@ -16,4 +16,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./uploads"), exports);
 __exportStar(require("./jobs"), exports);
+__exportStar(require("./sources"), exports);
 __exportStar(require("./webhooks"), exports);

package/dist/helpers/sources.d.ts

@@ -0,0 +1,8 @@
+export interface UploadJobSourceLike {
+    type: any;
+    upload_id: string;
+}
+export declare function uploadJobSource(uploadId: string): UploadJobSourceLike;
+export declare const JobSource: Readonly<{
+    upload: typeof uploadJobSource;
+}>;

package/dist/helpers/sources.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JobSource = void 0;
+exports.uploadJobSource = uploadJobSource;
+function uploadJobSource(uploadId) {
+    return { type: "upload", upload_id: uploadId };
+}
+exports.JobSource = Object.freeze({
+    upload: uploadJobSource,
+});

package/examples/encode-file.mjs

@@ -0,0 +1,70 @@
+import {
+  Configuration,
+  JobProfile,
+  JobSource,
+  JobStatus,
+  JobsApi,
+  UploadsApi,
+  uploadFile,
+  waitForJob,
+} from "@liqhtworks/sophon-sdk";
+import { Blob } from "node:buffer";
+import { randomUUID } from "node:crypto";
+import { readFile, writeFile } from "node:fs/promises";
+import { basename } from "node:path";
+
+const inputPath = process.argv[2];
+if (!inputPath) {
+  throw new Error("usage: node examples/encode-file.mjs /path/to/video.mov");
+}
+
+const apiKey = process.env.SOPHON_API_KEY;
+if (!apiKey) throw new Error("SOPHON_API_KEY is required");
+
+const basePath = process.env.SOPHON_BASE_URL ?? "https://api.liqhtworks.xyz";
+const config = new Configuration({ basePath, accessToken: apiKey });
+const uploads = new UploadsApi(config);
+const jobs = new JobsApi(config);
+
+const bytes = await readFile(inputPath);
+const mimeType = inputPath.endsWith(".mov") ? "video/quicktime" : "video/mp4";
+const upload = await uploadFile({
+  api: uploads,
+  source: new Blob([bytes], { type: mimeType }),
+  fileName: basename(inputPath),
+  mimeType,
+  concurrency: 4,
+  onProgress: (p) => console.log(`upload ${p.partsDone}/${p.partsTotal}`),
+});
+
+const job = await jobs.createJob({
+  idempotencyKey: randomUUID(),
+  createJobRequest: {
+    source: JobSource.upload(upload.uploadId),
+    profile: JobProfile.SOPHON_ESPRESSO,
+  },
+});
+console.log(`created ${job.id}`);
+
+const final = await waitForJob({
+  api: jobs,
+  jobId: job.id,
+  timeoutMs: 30 * 60 * 1000,
+  onProgress: (j) => console.log(`job ${j.id}: ${j.status}`),
+});
+if (final.status !== JobStatus.COMPLETED) {
+  throw new Error(`job ended in ${final.status}`);
+}
+
+const redirect = await fetch(`${basePath}/v1/jobs/${final.id}/output`, {
+  headers: { authorization: `Bearer ${apiKey}` },
+  redirect: "manual",
+});
+const location = redirect.headers.get("location");
+if (!location) throw new Error("missing output redirect");
+
+const download = await fetch(new URL(location, basePath));
+if (!download.ok) throw new Error(`download failed: ${download.status}`);
+
+await writeFile("sophon-output.mp4", Buffer.from(await download.arrayBuffer()));
+console.log("wrote sophon-output.mp4");

package/examples/upload-node-path.mjs

@@ -0,0 +1,32 @@
+import {
+  Configuration,
+  UploadsApi,
+  uploadFile,
+} from "@liqhtworks/sophon-sdk";
+import { Blob } from "node:buffer";
+import { basename } from "node:path";
+import { readFile } from "node:fs/promises";
+
+const path = process.argv[2];
+if (!path) {
+  throw new Error("usage: node examples/upload-node-path.mjs /path/to/video.mov");
+}
+
+const config = new Configuration({
+  basePath: process.env.SOPHON_BASE_URL ?? "https://api.liqhtworks.xyz",
+  accessToken: process.env.SOPHON_API_KEY,
+});
+
+const bytes = await readFile(path);
+const source = new Blob([bytes], { type: "video/quicktime" });
+const uploads = new UploadsApi(config);
+
+const upload = await uploadFile({
+  api: uploads,
+  source,
+  fileName: basename(path),
+  mimeType: "video/quicktime",
+  concurrency: 4,
+});
+
+console.log(upload.uploadId);

package/examples/webhook-server/package.json

@@ -0,0 +1,13 @@
+{
+  "name": "sophon-webhook-server-example",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "node src/server.mjs",
+    "check": "node --check src/server.mjs"
+  },
+  "dependencies": {
+    "@liqhtworks/sophon-sdk": "latest",
+    "express": "^4.19.2"
+  }
+}

package/examples/webhook-server/src/server.mjs

@@ -0,0 +1,51 @@
+import express from "express";
+import {
+  WebhookSignatureError,
+  verifyWebhookSignature,
+} from "@liqhtworks/sophon-sdk";
+
+const secret = process.env.SOPHON_WEBHOOK_SECRET;
+if (!secret) {
+  throw new Error("SOPHON_WEBHOOK_SECRET is required");
+}
+
+const app = express();
+
+app.post(
+  "/webhooks/sophon",
+  express.raw({ type: "application/json", limit: "2mb" }),
+  async (req, res) => {
+    if (!Buffer.isBuffer(req.body)) {
+      res.status(400).send("raw body required");
+      return;
+    }
+
+    try {
+      await verifyWebhookSignature({
+        rawBody: req.body,
+        signatureHeader: req.get("X-Turbo-Signature-256"),
+        timestampHeader: req.get("X-Turbo-Timestamp"),
+        secret,
+      });
+    } catch (err) {
+      if (err instanceof WebhookSignatureError) {
+        console.warn("rejected SOPHON webhook", { reason: err.reason });
+      }
+      res.status(401).send("invalid signature");
+      return;
+    }
+
+    const event = JSON.parse(req.body.toString("utf8"));
+    console.log("accepted SOPHON webhook", {
+      type: event.type,
+      id: event.id,
+    });
+
+    res.sendStatus(204);
+  },
+);
+
+const port = Number(process.env.PORT ?? 3000);
+app.listen(port, () => {
+  console.log(`listening on :${port}`);
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@liqhtworks/sophon-sdk",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "OpenAPI client for @liqhtworks/sophon-sdk",
   "author": "OpenAPI-Generator",
   "repository": {

package/src/helpers/index.ts

@@ -1,3 +1,4 @@
 export * from "./uploads";
 export * from "./jobs";
+export * from "./sources";
 export * from "./webhooks";

package/src/helpers/sources.ts

@@ -0,0 +1,14 @@
+export interface UploadJobSourceLike {
+  // `any` keeps the helper assignable to the generated string enum type while
+  // still centralizing the only valid runtime discriminator value.
+  type: any;
+  upload_id: string;
+}
+
+export function uploadJobSource(uploadId: string): UploadJobSourceLike {
+  return { type: "upload", upload_id: uploadId };
+}
+
+export const JobSource = Object.freeze({
+  upload: uploadJobSource,
+});