@requence/service 1.0.0-alpha.51 → 1.0.0-alpha.53

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @requence/service
 
+## 1.0.0-alpha.53
+
+### Patch Changes
+
+- 7fdea3b: lint
+
+## 1.0.0-alpha.52
+
+### Patch Changes
+
+- 6922266: trace ids
+
 ## 1.0.0-alpha.51
 
 ### Patch Changes

package/README.md

@@ -1,191 +1,330 @@
-# @requence/consumer
+# @requence/service
 
-This package connects a JavaScript runtime (e.g. Node.js / Bun) to the operator bus. It manages the retrieval and responses of messages.
+This package connects a TypeScript / Bun service to the Requence operator. It manages message retrieval, processing, and result delivery.
 
-## Usage
+## Installation
 
-```typescript
-import createConsumer from '@requence/consumer'
+```bash
+npm install @requence/service
+```
 
-createConsumer((ctx) => {
-  return 'this is my response'
-})
+## 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
 ```
 
-Every consumer instance needs a `url` parameter to connect to the operator and a `version`. In the basic example, those parameters get automatically retrieved from environment variables `REQUENCE_URL` and `VERSION`.
-To be more explicit about those configurations, you can pass an object as the first parameter:
+## Usage
 
 ```typescript
-createConsumer(
-  {
-    url: 'your operator connection url string',
-    version: 'your version in format major.minor.patch',
-  },
-  (ctx) => {
-    return 'this is my response'
-  },
-)
+import { createService } from '@requence/service'
+
+createService('1.0.0', (ctx) => {
+  return { message: `Hello, ${ctx.input.name}!` }
+})
 ```
 
-## Additional configuration
+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.
 
-By default, the consumer retrieves one message from the operator, processes it and passes the response back to the operator. If your service is capable of processing multiple messages in parallel, you can define a higher `prefetch`.
+### Options object
+
+Instead of a bare version string, you can pass an options object:
 
 ```typescript
-createConsumer(
+import { createService } from '@requence/service'
+
+createService(
   {
-    prefetch: 10, // this will process max. 10 messages at once when available
+    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 'this is my response'
+    return processData(ctx.input)
   },
 )
 ```
 
-## Unsubscribing service
+### Return value
 
-Should you ever need to unsubscribe your service from the operator programmatically, `createConsumer` returns a promise with an unsubscribe function.
+`createService` returns a `ServiceApi` object immediately (the connection is established in the background):
 
 ```typescript
-const unsubscribe = await createConsumer(...)
+const service = createService('1.0.0', handler)
 
-// later
-unsubscribe()
+// wait for the connection to be ready
+await service.open()
+
+// gracefully close the connection
+await service.close()
 ```
 
-To resubscribe, you have to call `createConsumer` again
+## Context API
+
+Every handler receives a `ctx` object.
 
-## Processing messages
+### Data access
 
-The message handler callback provides one argument: the message context.
-The context provides helper methods to access previous operator results and also methods to abort the processing early.
+| 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 |
 
-### context api data retrieval
+### Logging
+
+`ctx.debug` sends log messages to the Requence UI in real time:
 
 ```typescript
-ctx.getInput()
+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)
 ```
 
-The input that was defined when the task started
+### 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
-ctx.getMeta()
+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 ...')
+})
 ```
 
-The additional meta information added to the task
+> **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
-ctx.getConfiguration(): unknown
+createService('1.0.0', (ctx) => {
+  if (!ctx.input.requiredField) {
+    ctx.abort('Missing required field')
+  }
+
+  return processData(ctx.input)
+})
 ```
 
-The optional configuration of the current service
+#### `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
-ctx.getServiceMeta(serviceIdentifier): {
-  executionDate: Date | null, // null when the service was not yet executed
-  id: string, // service id used for internal routing
-  alias?: string, // service alias (see service Identifier)
-  name: string,
-  configuration?: unknown,
-  version: string
-}
+createService('1.0.0', (ctx) => {
+  if (ctx.input.type === 'pdf') {
+    return ctx.toOutput('pdf', { url: '...' })
+  }
+
+  return ctx.toOutput('other', { raw: ctx.input })
+})
 ```
 
-The meta parameters of a service, usually not needed
+#### `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
-ctx.getServiceData(serviceIdentifier): unknown
+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
+})
 ```
 
-The response of a previously executed service
+#### `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
-ctx.getLastServiceData(serviceIdentifier): unknown
+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()
+  }
+})
 ```
 
-Same as `ctx.getServiceData` but only returns the last data when a service is used multiple times
+Or race against it directly:
 
 ```typescript
-ctx.getServiceError(serviceIdentifier): string | null
+const result = await Promise.race([
+  fetchData(),
+  ctx.terminated,
+])
 ```
 
-The error message of a previously executed service or null when said service was not yet executed or did process without error.
+> 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
-ctx.getLastServiceError(serviceIdentifier): string | null
+createService('1.0.0', async function* (ctx) {
+  for (const chunk of await fetchChunks(ctx.input)) {
+    yield { chunk }
+  }
+})
 ```
 
-Same as `ctx.getServiceError` but only returns the last error when a service is used multiple times
+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
-ctx.getResults(): Array<{
-  executionDate: Date | null, // null when the service was not yet executed
-  id: string, // service id used for internal routing
-  alias?: string, // service alias (see service Identifier)
-  name: string,
-  configuration?: unknown,
-  version: string
-  error?: string
-  data?: unknown | null
-}>
+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')
+})
 ```
 
-get results of all configured services in this task. When a service did run prior to the current service, `executionDate` and `error` or `data` will be available.
+`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
-ctx.getTenantName(): String
+import { createService } from '@requence/service'
+
+createService(
+  {
+    version: '1.0.0',
+    devToken: process.env.REQUENCE_DEV_TOKEN,
+  },
+  (ctx) => ctx.input,
+)
 ```
 
-The name of the tenant that initiated the task
+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`.
 
-### context api processing control
+## CLI — Generate Types
 
-```typescript
-ctx.retry(delay?: number): never
+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
 ```
 
-Instructs the operator to retry the service after an optional delay in milliseconds (minimum is 100ms). No code gets executed after this line.
-**Currently, it is your responsibility to prevent infinite loops.**
+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
-ctx.abort(reason?: string): never
+import { wrapIterable } from '@requence/service'
+
+createService('1.0.0', async function* (ctx) {
+  for await (const event of wrapIterable(eventStream)) {
+    yield processEvent(event)
+  }
+})
 ```
 
-Instructs the operator to abort the processing of this service immediately.
-If the service is not configured with a fail over, the complete task will fail.
+### `asyncEventEmitter(initial?)`
 
-### service identifier
+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:
 
-Most context methods require a service identifier as parameter. This identifier can either be a service name or a service alias. The latter is useful for situations where a service is used multiple times in a task and needs the data from one specific execution.
+```typescript
+import { asyncEventEmitter, createService } from '@requence/service'
 
-## Full example
+createService('1.0.0', async function* (ctx) {
+  const emitter = asyncEventEmitter<string>()
 
-Pseudo implementation of a database service
+  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 createConsumer from '@requence/consumer'
-import db from './database.js' // pseudo code
-createConsumer(
+import { createService } from '@requence/service'
+import { db } from './database.js'
+
+createService(
   {
-    url: 'amqp://username:password@host',
     version: '1.2.3',
-    prefetch: 2, // we can process 2 messages in parallel
+    prefetch: 2, // process 2 messages in parallel
   },
   async (ctx) => {
-    const ocrData = ctx.getServiceData('ocr')
-
-    if (!ocrData) {
-      ctx.abort('Ocr service is mandatory for this AI service')
+    if (!db.isConnected) {
+      ctx.retry(2_000) // wait 2s for the DB to recover
     }
 
-    if (!db.isConnected) {
-      // lets wait 2s for the db to recover
-      ctx.retry(2000)
+    if (!ctx.input.ocrData) {
+      ctx.abort('OCR data is mandatory')
     }
 
-    const response = await db.getDataBasedOnOcr(ocrData)
+    const result = await db.getDataBasedOnOcr(ctx.input.ocrData)
 
-    return response
+    return result
   },
 )
 ```

package/build/cli.js

@@ -56,6 +56,7 @@ async function fetchTypes(url, headers, targetFile, clear = false, showTimestamp
 `;
   }
   const data = `${header}/* eslint-disable */
+/* oxlint-disable */
 /* prettier-ignore */
 
 ${text}`;
@@ -156,5 +157,5 @@ in your ${chalk.bold("package.json")} in ${chalk.bold("requence.accessToken")} /
   });
 }).scriptName("requence-service").help("h").demandCommand(1, 1).strict().parse();
 
-//# debugId=190F4F01CE4319C364756E2164756E21
+//# debugId=F3C67DF0D72FBC3064756E2164756E21
 //# sourceMappingURL=cli.js.map

package/build/cli.js.map

@@ -2,9 +2,9 @@
   "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\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/* 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_ACCESS_TOKEN ??\n      process.env.REQUENCE_ACCESS_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"
+    "#!/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\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_ACCESS_TOKEN ??\n      process.env.REQUENCE_ACCESS_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": "190F4F01CE4319C364756E2164756E21",
+  "mappings": ";;;;;;AAEA;AACA;AAGA;AACA;AACA;AACA;AACA;AAEA,IAAM,IAAI,MAAM,QAAQ,QAAQ,IAAI,CAAC;AAErC,IAAM,SAAS;AAAA,EACb,KAAK,MAAM,IAAI,SAAS;AAAA,EACxB,OAAO,MAAM,IAAI,SAAS;AAAA,EAC1B,QAAQ,MAAM,IAAI,SAAS;AAAA,EAC3B,QAAQ,MAAM,IAAI,SAAS;AAAA,EAC3B,MAAM,MAAM,IAAI,SAAS;AAC3B;AAEA,SAAS,SAAS,CAAC,OAAe,MAAsB;AAAA,EACtD,QAAQ,MAAM,OAAO,IAAI,KAAK,QAAQ;AAAA,CAAI,CAAC;AAAA,EAC3C,IAAI,MAAM;AAAA,IACR,QAAQ,MAAM,OAAO,IAAI,IAAI,IAAI;AAAA,CAAI;AAAA,EACvC;AAAA,EACA,QAAQ,KAAK,CAAC;AAAA;AAGhB,IAAI;AACJ,SAAS,WAAW,GAAG;AAAA,EACrB,KAAK,SAAS;AAAA,IACZ,UAAU,KAAK,MAAM,GAAG,aAAa,gBAAgB,OAAO,CAAC;AAAA,EAC/D;AAAA,EACA,OAAO;AAAA;AAGT,eAAe,UAAU,CACvB,KACA,SACA,YACA,QAAQ,OACR,gBAAgB,OAChB;AAAA,EACA,MAAM,YAAY,MAChB,OAAO,KAAK,IAAI,KAAK,EAAE,mBAAmB,SAAS,EAAE,QAAQ,MAAM,CAAC,CAAC;AAAA,EACvE,MAAM,WAAW,MAAM,MAAM,KAAK;AAAA,IAChC,QAAQ;AAAA,IACR;AAAA,EACF,CAAC;AAAA,EAED,MAAM,aAAa,SAAS,QAAQ,IAAI,eAAe;AAAA,EACvD,MAAM,OAAO,MAAM,SAAS,KAAK;AAAA,EAEjC,KAAK,SAAS,IAAI;AAAA,IAChB,UAAU,IAAI;AAAA,EAChB;AAAA,EAEA,IAAI,SACF;AAAA;AAAA;AAAA;AAAA,EAEF,IAAI,YAAY;AAAA,IACd,UAAU,4BAA4B;AAAA;AAAA;AAAA,EACxC;AAAA,EACA,MAAM,OAAO,GAAG;AAAA;AAAA;AAAA;AAAA,EAA8E;AAAA,EAE9F,GAAG,cAAc,YAAY,IAAI;AAAA,EAEjC,IAAI,OAAO;AAAA,IACT,QAAQ,MAAM;AAAA,EAChB;AAAA,EAEA,IAAI,YAAY;AAAA,IACd,QAAQ,KACN,GAAI,gBAAgB,CAAC,UAAU,CAAC,IAAI,CAAC,GACrC,OAAO,OACL,oBACA,MAAM,KAAK,UAAU,GACrB,YACA,MAAM,KAAK,KAAK,SAAS,QAAQ,IAAI,GAAG,UAAU,CAAC,CACrD,CACF;AAAA,EACF,EAAO;AAAA,IACL,QAAQ,KACN,GAAI,gBAAgB,CAAC,UAAU,CAAC,IAAI,CAAC,GACrC,OAAO,MACL,kBACA,MAAM,KAAK,KAAK,SAAS,QAAQ,IAAI,GAAG,UAAU,CAAC,CACrD,CACF;AAAA;AAAA;AAIJ,EAAE,QACA,kBACA,8BACA,CAAC,WACC,OACG,OAAO,gBAAgB;AAAA,EACtB,UAAU;AAAA,EACV,MAAM;AACR,CAAC,EACA,OAAO,aAAa;AAAA,EACnB,aAAa;AAAA,EACb,MAAM;AACR,CAAC,EACA,OAAO,WAAW;AAAA,EACjB,SAAS;AACX,CAAC,EACA,OAAO,UAAU;AAAA,EAChB,SAAS;AACX,CAAC,EACA,OAAO,SAAS;AAAA,EACf,MAAM;AACR,CAAC,EACA,OAAO,SAAS;AAAA,EACf,aACE;AAAA,EACF,MAAM;AAAA,EACN,SAAS;AACX,CAAC,GACL,OAAO,SAAS;AAAA,EACd,IAAI,QACF,KAAK,eACL,QAAQ,IAAI,iCACZ,QAAQ,IAAI;AAAA,EAEd,KAAK,OAAO;AAAA,IACV,MAAM,WAAU,YAAY;AAAA,IAC5B,QACE,SAAQ,UAAU,SAAS,eAAe,SAAQ,UAAU;AAAA,EAChE;AAAA,EAEA,IAAI,KAAK,OAAO;AAAA,IACd,QAAQ,KAAK;AAAA,EACf;AAAA,EACA,KAAK,OAAO;AAAA,IACV,UACE,yBACA,mDAAmD,MAAM,KAAK,kBAAkB;AAAA,0BAA+B,MAAM,KAAK,uBAAuB,OAAO,MAAM,KAAK,+BAA+B;AAAA,UAAiB,MAAM,KAAK,cAAc,QAAQ,MAAM,KAAK,sBAAsB,OAAO,MAAM,KAAK,8BAA8B,GACvU;AAAA,EACF;AAAA,EAEA,MAAM,QAAQ,YAAY,KAAK;AAAA,EAC/B,IAAI,MAAM,WAAW,KAAK,MAAM,OAAO,WAAW;AAAA,IAChD,UAAU,qBAAqB;AAAA,EACjC;AAAA,EAEA,SAAS,kBAAkB,aAAa;AAAA,EACxC,MAAM,UAAuB;AAAA,IAC3B,eAAe,UAAU;AAAA,EAC3B;AAAA,EACA,IAAI,WACF,KAAK,YACL,QAAQ,IAAI,iCACZ,QAAQ,IAAI;AAAA,EAEd,KAAK,UAAU;AAAA,IACb,MAAM,WAAU,YAAY;AAAA,IAC5B,WACE,SAAQ,UAAU,SAAS,YAAY,SAAQ,UAAU;AAAA,EAC7D;AAAA,EAEA,IAAI,UAAU;AAAA,IACZ,MAAM,WAAW,YAAY,QAAQ;AAAA,IACrC,IAAI,SAAS,OAAO,OAAO;AAAA,MACzB,MAAM,IAAI,MACR,2DACF;AAAA,IACF;AAAA,IACA,IAAI,SAAS,OAAO,MAAM,IAAI;AAAA,MAC5B,MAAM,IAAI,MACR,sFACF;AAAA,IACF;AAAA,IAEA,QAAQ,yBAAyB,SAAS;AAAA,EAC5C;AAAA,EAEA,MAAM,WACJ,YAAY,6BACZ,SACA,KAAK,KAAK,KAAK,UAAU,QAAQ,IAAI,GAAG,KAAK,OAAO,CACtD;AAAA,EAEA,KAAK,KAAK,OAAO;AAAA,IACf;AAAA,EACF;AAAA,EAEA,IAAI,KAAK,OAAO;AAAA,IACd,QAAQ,MAAM;AAAA,EAChB;AAAA,EACA,QAAQ,KAAK,OAAO,OAAO,KAAK,4BAA2B,CAAC;AAAA,EAC5D,IAAI,YAAY,KAAK,IAAI;AAAA,EACzB,MAAM,aAAa,EAAE,OAAO,OAAO,EAAE,IAAI,EAAE,SAAS;AAAA,EACpD,kBAAkB;AAAA,IAChB,QAAQ;AAAA,IACR,KAAK,YAAY;AAAA,IACjB;AAAA,SACM,UAAS,GAAG,QAAQ;AAAA,MACxB,MAAM,aAAa,WAAW,UAAU,IAAI;AAAA,MAC5C,KAAK,WAAW,WAAW,WAAW,OAAO,WAAW;AAAA,QACtD;AAAA,MACF;AAAA,MACA,YAAY,WAAW;AAAA,MACvB,IAAI,KAAK,OAAO;AAAA,QACd,QAAQ,MAAM;AAAA,MAChB;AAAA,MACA,QAAQ,KACN,OAAO,KAAK,KAAK,sBAAqB,KAAK,QAAQ;AAAA;AAAA,IAAS,IAAI,CAClE;AAAA,MAEA,MAAM,WACJ,YAAY,6BACZ,SACA,KAAK,KAAK,KAAK,UAAU,QAAQ,IAAI,GAAG,KAAK,OAAO,GACpD,KAAK,OACL,IACF;AAAA,MACA,QAAQ,KACN,OAAO,OAAO,KACZ,GAAG,KAAK,QAAQ;AAAA;AAAA,IAAS,8BAC3B,CACF;AAAA;AAAA,EAEJ,CAAC;AAAA,CAEL,EACG,WAAW,kBAAkB,EAC7B,KAAK,GAAG,EACR,cAAc,GAAG,CAAC,EAClB,OAAO,EACP,MAAM;",
+  "debugId": "F3C67DF0D72FBC3064756E2164756E21",
   "names": []
 }