@requence/service 0.7.1

package/CHANGELOG.md

@@ -0,0 +1,10 @@
+# @requence/service
+
+## 0.7.1
+
+### Patch Changes
+
+- 54b16f6: Fix startup race condition where the backchannel queue's QueueBind could fire
+  before assertQueue completed, causing a 404 NOT_FOUND error. Moved the
+  backchannel setup into the primary channel setup function to ensure sequential
+  execution on every (re)connect.

package/README.md

@@ -0,0 +1,330 @@
+# @requence/service
+
+This package connects a TypeScript / Bun service to the Requence operator. It manages message retrieval, processing, and result delivery.
+
+## Installation
+
+```bash
+npm install @requence/service
+```
+
+## Authentication
+
+Every service needs an **access token** to connect. Copy it from the **Services** list view in the Requence UI by clicking **Copy credentials**.
+
+The token is resolved in this order:
+
+1. `accessToken` option passed to `createService()`
+2. `REQUENCE_SERVICE_ACCESS_TOKEN` or `REQUENCE_ACCESS_TOKEN` environment variable
+3. `requence.service.accessToken` or `requence.accessToken` in `package.json`
+
+```bash
+REQUENCE_SERVICE_ACCESS_TOKEN=your-token bun run index.ts
+```
+
+## Usage
+
+```typescript
+import { createService } from '@requence/service'
+
+createService('1.0.0', (ctx) => {
+  return { message: `Hello, ${ctx.input.name}!` }
+})
+```
+
+The second argument to `createService` is the **version** of the service definition you are implementing. When Requence dispatches a message, the handler runs and the return value is sent back as the result.
+
+### Options object
+
+Instead of a bare version string, you can pass an options object:
+
+```typescript
+import { createService } from '@requence/service'
+
+createService(
+  {
+    version: '1.0.0',
+    prefetch: 5, // process up to 5 messages in parallel (default: 1)
+    connectionTimeout: 30_000, // ms to wait before throwing (default: 3000)
+    silent: false, // suppress lifecycle logs
+  },
+  async (ctx) => {
+    return processData(ctx.input)
+  },
+)
+```
+
+### Return value
+
+`createService` returns a `ServiceApi` object immediately (the connection is established in the background):
+
+```typescript
+const service = createService('1.0.0', handler)
+
+// wait for the connection to be ready
+await service.open()
+
+// gracefully close the connection
+await service.close()
+```
+
+## Context API
+
+Every handler receives a `ctx` object.
+
+### Data access
+
+| Property | Description |
+|---|---|
+| `ctx.input` | The input data routed to this service node from the task template |
+| `ctx.configuration` | The static configuration set on the service node in the UI |
+| `ctx.taskId` | The unique ID of the current task execution |
+
+### Logging
+
+`ctx.debug` sends log messages to the Requence UI in real time:
+
+```typescript
+ctx.debug.log('Processing started')
+ctx.debug.info('Step complete', { step: 1 })
+ctx.debug.warn('Something looks off')
+ctx.debug.error('An error occurred', error)
+```
+
+### Flow control
+
+#### `ctx.retry(delay?)`
+
+Instructs Requence to retry this service after an optional delay in milliseconds (minimum 100 ms). No code executes after this call.
+
+```typescript
+createService('1.0.0', async (ctx) => {
+  const db = await getDbConnection()
+
+  if (!db.isConnected) {
+    ctx.retry(2_000) // retry in 2 seconds
+  }
+
+  return db.query('SELECT ...')
+})
+```
+
+> **Note:** It is your responsibility to prevent infinite retry loops.
+
+#### `ctx.abort(reason?)`
+
+Instructs Requence to abort this service immediately. If the service node's **on fail** output is not connected, the entire task fails.
+
+```typescript
+createService('1.0.0', (ctx) => {
+  if (!ctx.input.requiredField) {
+    ctx.abort('Missing required field')
+  }
+
+  return processData(ctx.input)
+})
+```
+
+#### `ctx.skip()`
+
+Puts the message back on the queue without processing it. The next available service instance will receive it instead.
+
+#### `ctx.toOutput(name, value)`
+
+Routes the result to a specific **named output** on the service node. Use this when your service definition has multiple outputs:
+
+```typescript
+createService('1.0.0', (ctx) => {
+  if (ctx.input.type === 'pdf') {
+    return ctx.toOutput('pdf', { url: '...' })
+  }
+
+  return ctx.toOutput('other', { raw: ctx.input })
+})
+```
+
+#### `ctx.defer(reason?)`
+
+Marks the message as **deferred**. The service acknowledges the message but signals that the result will be delivered later via `service.act()`. Returns a **message key** that you must store and pass to `act()`:
+
+```typescript
+createService('1.0.0', (ctx) => {
+  const messageKey = ctx.defer('waiting for external process')
+  externalQueue.push({ messageKey, payload: ctx.input })
+  // handler returns — message is held open until act() is called
+})
+```
+
+#### `ctx.terminated`
+
+A `Promise` that resolves when the task is stopped (cancelled via the UI or API, or terminated by another node). Use it in continuous/generator services to know when to stop producing values.
+
+`ctx.terminated.signal` is a native [`AbortSignal`](https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal) that fires at the same moment — pass it to any abort-aware API:
+
+```typescript
+import { setTimeout } from 'node:timers/promises'
+import { createService } from '@requence/service'
+
+// Poll every 5 seconds, exit immediately when the task is stopped
+createService('1.0.0', async function* (ctx) {
+  while (true) {
+    await setTimeout(5_000, null, { signal: ctx.terminated.signal })
+    yield await pollForUpdates()
+  }
+})
+```
+
+Or race against it directly:
+
+```typescript
+const result = await Promise.race([
+  fetchData(),
+  ctx.terminated,
+])
+```
+
+> The framework automatically catches the `AbortError` thrown by abort-aware APIs when the task is terminated — no `try/catch` needed inside a generator.
+
+## Continuous (Generator) Mode
+
+When a service node is configured in **continuous mode**, the handler can be an async generator. Each `yield` sends an incremental result to Requence; the final `return` (or generator completion) signals the end of processing:
+
+```typescript
+createService('1.0.0', async function* (ctx) {
+  for (const chunk of await fetchChunks(ctx.input)) {
+    yield { chunk }
+  }
+})
+```
+
+The generator is terminated automatically when `ctx.terminated` resolves. Yielded values are still sent before the generator exits.
+
+## Deferred Delivery via `service.act()`
+
+After deferring a message with `ctx.defer()`, use `service.act()` to deliver the result later — even from a different process run:
+
+```typescript
+const service = createService('1.0.0', (ctx) => {
+  const messageKey = ctx.defer()
+  saveMessageKey(ctx.taskId, messageKey)
+})
+
+// ... in a webhook handler or background job:
+await service.act(messageKey, async (api) => {
+  api.send({ result: 'done' })
+  // or: api.sendToOutput('success', { result: 'done' })
+  // or: api.abort('something went wrong')
+})
+```
+
+`act()` also supports returning a value or an iterable directly from the actor function, which behaves the same as calling `api.send()` for each value.
+
+## Dev Overlay
+
+When developing locally alongside a production service, use a **dev token** (your personal access token) to register a dev instance. Requence routes your own tasks to the dev instance instead of the production pool:
+
+```typescript
+import { createService } from '@requence/service'
+
+createService(
+  {
+    version: '1.0.0',
+    devToken: process.env.REQUENCE_DEV_TOKEN,
+  },
+  (ctx) => ctx.input,
+)
+```
+
+The dev token is resolved in the same order as the access token — option, `REQUENCE_SERVICE_DEV_TOKEN` / `REQUENCE_DEV_TOKEN` env var, or `requence.service.devToken` / `requence.devToken` in `package.json`.
+
+## CLI — Generate Types
+
+The package ships with a CLI that generates TypeScript types derived from the schemas you defined in the Requence UI (input, configuration, and outputs):
+
+```bash
+npx requence-service generate-types
+```
+
+This creates a `requence-env.d.ts` file in your project root. TypeScript picks it up automatically — `ctx.input`, `ctx.configuration`, and `ctx.toOutput()` calls become fully typed.
+
+### Options
+
+| Option | Default | Description |
+|---|---|---|
+| `--access-token` | — | Service access token (falls back to env / config file) |
+| `--dev-token` | — | Personal access token for branch-specific types |
+| `--outfile` | `requence-env.d.ts` | Name of the generated type file |
+| `--outdir` | `.` | Directory to write the type file to |
+| `--watch` | `false` | Watch for schema changes and regenerate automatically |
+| `--clear` / `--no-clear` | `true` | Clear the terminal on watch updates |
+
+### Watch mode
+
+```bash
+npx requence-service generate-types --watch
+```
+
+The CLI connects via server-sent events and regenerates types whenever a schema changes in the UI.
+
+## Utility Helpers
+
+### `wrapIterable(iterable)`
+
+Wraps any `Iterable` or `AsyncIterable` so that iteration stops automatically when `ctx.terminated` resolves:
+
+```typescript
+import { wrapIterable } from '@requence/service'
+
+createService('1.0.0', async function* (ctx) {
+  for await (const event of wrapIterable(eventStream)) {
+    yield processEvent(event)
+  }
+})
+```
+
+### `asyncEventEmitter(initial?)`
+
+Creates an async-iterable event emitter that integrates with `ctx.terminated`. Push values from outside (e.g. callbacks or event listeners) and iterate them inside the generator:
+
+```typescript
+import { asyncEventEmitter, createService } from '@requence/service'
+
+createService('1.0.0', async function* (ctx) {
+  const emitter = asyncEventEmitter<string>()
+
+  externalSource.on('data', (value) => emitter.push(value))
+
+  for await (const value of emitter) {
+    yield { value }
+  }
+})
+```
+
+The iterator exits automatically when the task is terminated.
+
+## Full Example
+
+```typescript
+import { createService } from '@requence/service'
+import { db } from './database.js'
+
+createService(
+  {
+    version: '1.2.3',
+    prefetch: 2, // process 2 messages in parallel
+  },
+  async (ctx) => {
+    if (!db.isConnected) {
+      ctx.retry(2_000) // wait 2s for the DB to recover
+    }
+
+    if (!ctx.input.ocrData) {
+      ctx.abort('OCR data is mandatory')
+    }
+
+    const result = await db.getDataBasedOnOcr(ctx.input.ocrData)
+
+    return result
+  },
+)
+```

package/build/chunk-6w7td62p.js

@@ -0,0 +1,56 @@
+// ../helpers/src/utils/obfuscate.ts
+var separator = "";
+var base65Chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+-$";
+var base65CharToIndex = {};
+for (let i = 0;i < base65Chars.length; i++) {
+  base65CharToIndex[base65Chars[i]] = i;
+}
+function obfuscate(...parts) {
+  const str = parts.join(separator);
+  let binaryString = "";
+  for (let i = 0;i < str.length; i++) {
+    const charCode = str.charCodeAt(i);
+    binaryString += charCode.toString(2).padStart(16, "0");
+  }
+  let encodedString = "";
+  const chunkSize = 6;
+  let paddingCount = 0;
+  for (let i = 0;i < binaryString.length; i += chunkSize) {
+    let chunk = binaryString.substring(i, i + chunkSize);
+    if (chunk.length < chunkSize) {
+      paddingCount = chunkSize - chunk.length;
+      chunk = chunk.padEnd(chunkSize, "0");
+    }
+    const decimalValue = parseInt(chunk, 2);
+    encodedString += base65Chars[decimalValue];
+  }
+  return encodedString + paddingCount.toString();
+}
+function deobfuscate(str) {
+  const paddingCount = parseInt(str.slice(-1), 10);
+  str = str.slice(0, -1);
+  let binaryString = "";
+  for (let i = 0;i < str.length; i++) {
+    const decimalValue = base65CharToIndex[str[i]];
+    const binaryChunk = decimalValue.toString(2).padStart(6, "0");
+    binaryString += binaryChunk;
+  }
+  if (paddingCount > 0) {
+    binaryString = binaryString.slice(0, -paddingCount);
+  }
+  let decodedString = "";
+  const charSize = 16;
+  for (let i = 0;i < binaryString.length; i += charSize) {
+    const byte = binaryString.substring(i, i + charSize);
+    if (byte.length === 16) {
+      const charCode = parseInt(byte, 2);
+      decodedString += String.fromCharCode(charCode);
+    }
+  }
+  return decodedString.split(separator);
+}
+
+export { obfuscate, deobfuscate };
+
+//# debugId=E6AE9819DA2983FC64756E2164756E21
+//# sourceMappingURL=chunk-6w7td62p.js.map

package/build/chunk-6w7td62p.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../../helpers/src/utils/obfuscate.ts"],
+  "sourcesContent": [
+    "const separator = '\\u{f6ee}'\n\nconst base65Chars =\n  'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+-$'\n\nconst base65CharToIndex: Record<string, number> = {}\nfor (let i = 0; i < base65Chars.length; i++) {\n  base65CharToIndex[base65Chars[i]] = i\n}\n\nexport function obfuscate(...parts: Array<string>) {\n  const str = parts.join(separator)\n  let binaryString = ''\n\n  for (let i = 0; i < str.length; i++) {\n    const charCode = str.charCodeAt(i)\n    binaryString += charCode.toString(2).padStart(16, '0')\n  }\n\n  let encodedString = ''\n  const chunkSize = 6\n  let paddingCount = 0\n\n  for (let i = 0; i < binaryString.length; i += chunkSize) {\n    let chunk = binaryString.substring(i, i + chunkSize)\n\n    if (chunk.length < chunkSize) {\n      paddingCount = chunkSize - chunk.length\n      chunk = chunk.padEnd(chunkSize, '0')\n    }\n\n    const decimalValue = parseInt(chunk, 2)\n    encodedString += base65Chars[decimalValue]\n  }\n\n  return encodedString + paddingCount.toString()\n}\n\nexport function randomString(length: number) {\n  const randomValues = new Uint8Array(length)\n  crypto.getRandomValues(randomValues)\n\n  let randomString = ''\n  for (let i = 0; i < length; i++) {\n    randomString += base65Chars[randomValues[i] % base65Chars.length]\n  }\n\n  return randomString\n}\n\nexport function deobfuscate(str: string) {\n  const paddingCount = parseInt(str.slice(-1), 10)\n  str = str.slice(0, -1)\n\n  let binaryString = ''\n\n  for (let i = 0; i < str.length; i++) {\n    const decimalValue = base65CharToIndex[str[i]]\n    const binaryChunk = decimalValue.toString(2).padStart(6, '0')\n    binaryString += binaryChunk\n  }\n\n  if (paddingCount > 0) {\n    binaryString = binaryString.slice(0, -paddingCount)\n  }\n\n  let decodedString = ''\n  const charSize = 16\n\n  for (let i = 0; i < binaryString.length; i += charSize) {\n    const byte = binaryString.substring(i, i + charSize)\n    if (byte.length === 16) {\n      const charCode = parseInt(byte, 2)\n      decodedString += String.fromCharCode(charCode)\n    }\n  }\n\n  return decodedString.split(separator)\n}\n"
+  ],
+  "mappings": ";AAAA,IAAM,YAAY;AAElB,IAAM,cACJ;AAEF,IAAM,oBAA4C,CAAC;AACnD,SAAS,IAAI,EAAG,IAAI,YAAY,QAAQ,KAAK;AAAA,EAC3C,kBAAkB,YAAY,MAAM;AACtC;AAEO,SAAS,SAAS,IAAI,OAAsB;AAAA,EACjD,MAAM,MAAM,MAAM,KAAK,SAAS;AAAA,EAChC,IAAI,eAAe;AAAA,EAEnB,SAAS,IAAI,EAAG,IAAI,IAAI,QAAQ,KAAK;AAAA,IACnC,MAAM,WAAW,IAAI,WAAW,CAAC;AAAA,IACjC,gBAAgB,SAAS,SAAS,CAAC,EAAE,SAAS,IAAI,GAAG;AAAA,EACvD;AAAA,EAEA,IAAI,gBAAgB;AAAA,EACpB,MAAM,YAAY;AAAA,EAClB,IAAI,eAAe;AAAA,EAEnB,SAAS,IAAI,EAAG,IAAI,aAAa,QAAQ,KAAK,WAAW;AAAA,IACvD,IAAI,QAAQ,aAAa,UAAU,GAAG,IAAI,SAAS;AAAA,IAEnD,IAAI,MAAM,SAAS,WAAW;AAAA,MAC5B,eAAe,YAAY,MAAM;AAAA,MACjC,QAAQ,MAAM,OAAO,WAAW,GAAG;AAAA,IACrC;AAAA,IAEA,MAAM,eAAe,SAAS,OAAO,CAAC;AAAA,IACtC,iBAAiB,YAAY;AAAA,EAC/B;AAAA,EAEA,OAAO,gBAAgB,aAAa,SAAS;AAAA;AAexC,SAAS,WAAW,CAAC,KAAa;AAAA,EACvC,MAAM,eAAe,SAAS,IAAI,MAAM,EAAE,GAAG,EAAE;AAAA,EAC/C,MAAM,IAAI,MAAM,GAAG,EAAE;AAAA,EAErB,IAAI,eAAe;AAAA,EAEnB,SAAS,IAAI,EAAG,IAAI,IAAI,QAAQ,KAAK;AAAA,IACnC,MAAM,eAAe,kBAAkB,IAAI;AAAA,IAC3C,MAAM,cAAc,aAAa,SAAS,CAAC,EAAE,SAAS,GAAG,GAAG;AAAA,IAC5D,gBAAgB;AAAA,EAClB;AAAA,EAEA,IAAI,eAAe,GAAG;AAAA,IACpB,eAAe,aAAa,MAAM,IAAI,YAAY;AAAA,EACpD;AAAA,EAEA,IAAI,gBAAgB;AAAA,EACpB,MAAM,WAAW;AAAA,EAEjB,SAAS,IAAI,EAAG,IAAI,aAAa,QAAQ,KAAK,UAAU;AAAA,IACtD,MAAM,OAAO,aAAa,UAAU,GAAG,IAAI,QAAQ;AAAA,IACnD,IAAI,KAAK,WAAW,IAAI;AAAA,MACtB,MAAM,WAAW,SAAS,MAAM,CAAC;AAAA,MACjC,iBAAiB,OAAO,aAAa,QAAQ;AAAA,IAC/C;AAAA,EACF;AAAA,EAEA,OAAO,cAAc,MAAM,SAAS;AAAA;",
+  "debugId": "E6AE9819DA2983FC64756E2164756E21",
+  "names": []
+}

package/build/cli.js

@@ -0,0 +1,166 @@
+#!/usr/bin/env node
+import {
+  deobfuscate
+} from "./chunk-6w7td62p.js";
+
+// src/cli.ts
+import fs from "node:fs";
+import path from "node:path";
+import chalk from "chalk";
+import { createEventSource } from "eventsource-client";
+import yargs from "yargs";
+import { hideBin } from "yargs/helpers";
+import { z } from "zod/v4";
+if (typeof process.loadEnvFile === "function") {
+  try {
+    process.loadEnvFile();
+  } catch {}
+}
+var y = yargs(hideBin(process.argv));
+var colors = {
+  red: chalk.hex("#ef4444"),
+  green: chalk.hex("#22c55e"),
+  yellow: chalk.hex("#eab308"),
+  orange: chalk.hex("#f97316"),
+  zinc: chalk.hex("#71717a")
+};
+function errorExit(title, text) {
+  console.error(colors.red.bold(title + `
+`));
+  if (text) {
+    console.error(colors.red(text) + `
+`);
+  }
+  process.exit(1);
+}
+var pkgJson;
+function loadPkgJson() {
+  if (!pkgJson) {
+    pkgJson = JSON.parse(fs.readFileSync("package.json", "utf-8"));
+  }
+  return pkgJson;
+}
+async function fetchTypes(url, headers, targetFile, clear = false, showTimestamp = false) {
+  const timestamp = () => colors.zinc(new Date().toLocaleTimeString("en-GB", { hour12: false }));
+  const response = await fetch(url, {
+    method: "GET",
+    headers
+  });
+  const branchName = response.headers.get("x-branch-name");
+  const text = await response.text();
+  if (!response.ok) {
+    errorExit(text);
+  }
+  let header = `// Generated by requence-service CLI — DO NOT EDIT.
+// Changes will be overwritten.
+
+`;
+  if (branchName) {
+    header += `// !!! types for branch "${branchName}" !!!
+
+`;
+  }
+  const data = `${header}/* eslint-disable */
+/* oxlint-disable */
+/* prettier-ignore */
+
+${text}`;
+  fs.writeFileSync(targetFile, data);
+  if (clear) {
+    console.clear();
+  }
+  if (branchName) {
+    console.info(...showTimestamp ? [timestamp()] : [], colors.yellow("types for branch", chalk.bold(branchName), "saved to", chalk.bold(path.relative(process.cwd(), targetFile))));
+  } else {
+    console.info(...showTimestamp ? [timestamp()] : [], colors.green("types saved to", chalk.bold(path.relative(process.cwd(), targetFile))));
+  }
+}
+y.command("generate-types", "generates typescript types", (yargs2) => yargs2.option("access-token", {
+  describe: "access token",
+  type: "string"
+}).option("dev-token", {
+  description: "dev token",
+  type: "string"
+}).option("outfile", {
+  default: "requence-env.d.ts"
+}).option("outdir", {
+  default: ""
+}).option("watch", {
+  type: "boolean"
+}).option("clear", {
+  description: "clear the terminal on watch updates (use --no-clear to disable)",
+  type: "boolean",
+  default: true
+}), async (argv) => {
+  let token = argv.accessToken ?? process.env.REQUENCE_SERVICE_ACCESS_TOKEN ?? process.env.REQUENCE_ACCESS_TOKEN;
+  if (!token) {
+    const pkgJson2 = loadPkgJson();
+    token = pkgJson2.requence?.service?.accessToken ?? pkgJson2.requence?.accessToken;
+  }
+  if (argv.clear) {
+    console.info();
+  }
+  if (!token) {
+    errorExit("No access token found", `You can provide the access token as argument to ${chalk.bold("requence-service")},
+as environment variable ${chalk.bold("REQUENCE_ACCESS_TOKEN")} / ${chalk.bold("REQUENCE_SERVICE_ACCESS_TOKEN")} or
+in your ${chalk.bold("package.json")} in ${chalk.bold("requence.accessToken")} / ${chalk.bold("requence.service.accessToken")}`);
+  }
+  const parts = deobfuscate(token);
+  if (parts.length !== 3 || parts[0] !== "service") {
+    errorExit("Invalid service key");
+  }
+  const [, connectionString, serverUrl] = parts;
+  const headers = {
+    Authorization: `Bearer ${connectionString}`
+  };
+  let devToken = argv.devToken ?? process.env.REQUENCE_SERVICE_DEV_TOKEN ?? process.env.REQUENCE_DEV_TOKEN;
+  if (!devToken) {
+    const pkgJson2 = loadPkgJson();
+    devToken = pkgJson2.requence?.service?.devToken ?? pkgJson2.requence?.devToken;
+  }
+  if (devToken) {
+    const devParts = deobfuscate(devToken);
+    if (devParts[0] !== "api") {
+      throw new Error("invalid dev token: please provide a personal access token");
+    }
+    if (devParts[2] !== parts[2]) {
+      throw new Error("invalid dev token: access token and dev token belong to different requence instances");
+    }
+    headers["x-dev-authorization"] = devParts[1];
+  }
+  await fetchTypes(serverUrl + "/service/types/typescript", headers, path.join(argv.outdir || process.cwd(), argv.outfile));
+  if (!argv.watch) {
+    return;
+  }
+  if (argv.clear) {
+    console.clear();
+  }
+  console.info(colors.orange.bold("Watching for type changes…"));
+  let lastWrite = Date.now();
+  const timeSchema = z.coerce.number().int().positive();
+  createEventSource({
+    method: "GET",
+    url: serverUrl + "/service/watch",
+    headers,
+    async onMessage({ data }) {
+      const timeResult = timeSchema.safeParse(data);
+      if (!timeResult.success || timeResult.data < lastWrite) {
+        return;
+      }
+      lastWrite = timeResult.data;
+      if (argv.clear) {
+        console.clear();
+      }
+      console.info(colors.zinc.bold(`Regenerating types…${argv.clear ? `
+
+` : ""}`));
+      await fetchTypes(serverUrl + "/service/types/typescript", headers, path.join(argv.outdir || process.cwd(), argv.outfile), argv.clear, true);
+      console.info(colors.orange.bold(`${argv.clear ? `
+
+` : ""}Watching for type changes…`));
+    }
+  });
+}).scriptName("requence-service").help("h").demandCommand(1, 1).strict().parse();
+
+//# debugId=F7FC109C50F6F85D64756E2164756E21
+//# sourceMappingURL=cli.js.map

package/build/cli.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/cli.ts"],
+  "sourcesContent": [
+    "#!/usr/bin/env node\n\nimport fs from 'node:fs'\nimport path from 'node:path'\n\nimport { deobfuscate } from '@requence/helpers'\nimport chalk from 'chalk'\nimport { createEventSource } from 'eventsource-client'\nimport yargs from 'yargs'\nimport { hideBin } from 'yargs/helpers'\nimport { z } from 'zod/v4'\n\n// Load .env automatically (Node 20.12+)\nif (typeof process.loadEnvFile === 'function') {\n  try {\n    process.loadEnvFile()\n  } catch {\n    // Ignore if .env is missing\n  }\n}\n\nconst y = yargs(hideBin(process.argv))\n\nconst colors = {\n  red: chalk.hex('#ef4444'),\n  green: chalk.hex('#22c55e'),\n  yellow: chalk.hex('#eab308'),\n  orange: chalk.hex('#f97316'),\n  zinc: chalk.hex('#71717a'),\n}\n\nfunction errorExit(title: string, text?: string): never {\n  console.error(colors.red.bold(title + '\\n'))\n  if (text) {\n    console.error(colors.red(text) + '\\n')\n  }\n  process.exit(1)\n}\n\nlet pkgJson: any | null\nfunction loadPkgJson() {\n  if (!pkgJson) {\n    pkgJson = JSON.parse(fs.readFileSync('package.json', 'utf-8'))\n  }\n  return pkgJson\n}\n\nasync function fetchTypes(\n  url: string,\n  headers: HeadersInit,\n  targetFile: string,\n  clear = false,\n  showTimestamp = false,\n) {\n  const timestamp = () =>\n    colors.zinc(new Date().toLocaleTimeString('en-GB', { hour12: false }))\n  const response = await fetch(url, {\n    method: 'GET',\n    headers,\n  })\n\n  const branchName = response.headers.get('x-branch-name')\n  const text = await response.text()\n\n  if (!response.ok) {\n    errorExit(text)\n  }\n\n  let header =\n    '// Generated by requence-service CLI — DO NOT EDIT.\\n// Changes will be overwritten.\\n\\n'\n\n  if (branchName) {\n    header += `// !!! types for branch \"${branchName}\" !!!\\n\\n`\n  }\n  const data = `${header}/* eslint-disable */\\n/* oxlint-disable */\\n/* prettier-ignore */\\n\\n${text}`\n\n  fs.writeFileSync(targetFile, data)\n\n  if (clear) {\n    console.clear()\n  }\n\n  if (branchName) {\n    console.info(\n      ...(showTimestamp ? [timestamp()] : []),\n      colors.yellow(\n        'types for branch',\n        chalk.bold(branchName),\n        'saved to',\n        chalk.bold(path.relative(process.cwd(), targetFile)),\n      ),\n    )\n  } else {\n    console.info(\n      ...(showTimestamp ? [timestamp()] : []),\n      colors.green(\n        'types saved to',\n        chalk.bold(path.relative(process.cwd(), targetFile)),\n      ),\n    )\n  }\n}\n\ny.command(\n  'generate-types',\n  'generates typescript types',\n  (yargs) =>\n    yargs\n      .option('access-token', {\n        describe: 'access token',\n        type: 'string',\n      })\n      .option('dev-token', {\n        description: 'dev token',\n        type: 'string',\n      })\n      .option('outfile', {\n        default: 'requence-env.d.ts',\n      })\n      .option('outdir', {\n        default: '',\n      })\n      .option('watch', {\n        type: 'boolean',\n      })\n      .option('clear', {\n        description:\n          'clear the terminal on watch updates (use --no-clear to disable)',\n        type: 'boolean',\n        default: true,\n      }),\n  async (argv) => {\n    let token =\n      argv.accessToken ??\n      process.env.REQUENCE_SERVICE_ACCESS_TOKEN ??\n      process.env.REQUENCE_ACCESS_TOKEN\n\n    if (!token) {\n      const pkgJson = loadPkgJson()\n      token =\n        pkgJson.requence?.service?.accessToken ?? pkgJson.requence?.accessToken\n    }\n\n    if (argv.clear) {\n      console.info() // newline\n    }\n    if (!token) {\n      errorExit(\n        'No access token found',\n        `You can provide the access token as argument to ${chalk.bold('requence-service')},\\nas environment variable ${chalk.bold('REQUENCE_ACCESS_TOKEN')} / ${chalk.bold('REQUENCE_SERVICE_ACCESS_TOKEN')} or\\nin your ${chalk.bold('package.json')} in ${chalk.bold('requence.accessToken')} / ${chalk.bold('requence.service.accessToken')}`,\n      )\n    }\n\n    const parts = deobfuscate(token)\n    if (parts.length !== 3 || parts[0] !== 'service') {\n      errorExit('Invalid service key')\n    }\n\n    const [, connectionString, serverUrl] = parts\n    const headers: HeadersInit = {\n      Authorization: `Bearer ${connectionString}`,\n    }\n    let devToken =\n      argv.devToken ??\n      process.env.REQUENCE_SERVICE_DEV_TOKEN ??\n      process.env.REQUENCE_DEV_TOKEN\n\n    if (!devToken) {\n      const pkgJson = loadPkgJson()\n      devToken =\n        pkgJson.requence?.service?.devToken ?? pkgJson.requence?.devToken\n    }\n\n    if (devToken) {\n      const devParts = deobfuscate(devToken)\n      if (devParts[0] !== 'api') {\n        throw new Error(\n          'invalid dev token: please provide a personal access token',\n        )\n      }\n      if (devParts[2] !== parts[2]) {\n        throw new Error(\n          'invalid dev token: access token and dev token belong to different requence instances',\n        )\n      }\n\n      headers['x-dev-authorization'] = devParts[1]\n    }\n\n    await fetchTypes(\n      serverUrl + '/service/types/typescript',\n      headers,\n      path.join(argv.outdir || process.cwd(), argv.outfile),\n    )\n\n    if (!argv.watch) {\n      return\n    }\n\n    if (argv.clear) {\n      console.clear()\n    }\n    console.info(colors.orange.bold('Watching for type changes…'))\n    let lastWrite = Date.now()\n    const timeSchema = z.coerce.number().int().positive()\n    createEventSource({\n      method: 'GET',\n      url: serverUrl + '/service/watch',\n      headers,\n      async onMessage({ data }) {\n        const timeResult = timeSchema.safeParse(data)\n        if (!timeResult.success || timeResult.data < lastWrite) {\n          return\n        }\n        lastWrite = timeResult.data\n        if (argv.clear) {\n          console.clear()\n        }\n        console.info(\n          colors.zinc.bold(`Regenerating types…${argv.clear ? '\\n\\n' : ''}`),\n        )\n\n        await fetchTypes(\n          serverUrl + '/service/types/typescript',\n          headers,\n          path.join(argv.outdir || process.cwd(), argv.outfile),\n          argv.clear,\n          true,\n        )\n        console.info(\n          colors.orange.bold(\n            `${argv.clear ? '\\n\\n' : ''}Watching for type changes…`,\n          ),\n        )\n      },\n    })\n  },\n)\n  .scriptName('requence-service')\n  .help('h')\n  .demandCommand(1, 1)\n  .strict()\n  .parse()\n"
+  ],
+  "mappings": "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",
+  "debugId": "F7FC109C50F6F85D64756E2164756E21",
+  "names": []
+}