@adonis-agora/durable 0.1.0

package/dist/stubs/database/migrations/create_durable_tables.stub

@@ -0,0 +1,87 @@
+{{{
+  exports({ to: app.migrationsPath(`${new Date().getTime()}_create_durable_tables.ts`) })
+}}}
+import { BaseSchema } from '@adonisjs/lucid/schema'
+
+/**
+ * Durable workflow tables for the @adonis-agora/durable `lucid` state store: runs, step checkpoints, the
+ * search-attribute side-table, signal waiters and buffered signals. JSON payloads are stored as TEXT (the store
+ * (de)serializes them) and timestamps as epoch-ms integers, so the schema is portable across
+ * SQLite / Postgres / MySQL.
+ */
+export default class extends BaseSchema {
+  async up() {
+    this.schema.createTable('durable_workflow_runs', (table) => {
+      table.string('id').primary()
+      table.string('workflow').notNullable()
+      table.string('workflow_version').notNullable()
+      table.string('status').notNullable()
+      table.text('input')
+      table.text('output')
+      table.text('error')
+      table.bigInteger('wake_at')
+      table.string('locked_by')
+      table.bigInteger('locked_until')
+      table.integer('recovery_attempts')
+      table.text('tags')
+      table.text('search_attributes')
+      table.integer('priority')
+      table.bigInteger('created_at').notNullable()
+      table.bigInteger('updated_at').notNullable()
+      table.index(['status'], 'durable_runs_status_idx')
+      table.index(['status', 'wake_at'], 'durable_runs_due_idx')
+    })
+
+    this.schema.createTable('durable_step_checkpoints', (table) => {
+      table.string('run_id').notNullable()
+      table.integer('seq').notNullable()
+      table.string('name').notNullable()
+      table.string('kind').notNullable()
+      table.string('step_id').notNullable()
+      table.string('status').notNullable()
+      table.text('input')
+      table.text('output')
+      table.text('error')
+      table.text('events')
+      table.integer('attempts').notNullable()
+      table.string('worker_group')
+      table.bigInteger('wake_at')
+      table.bigInteger('enqueued_at')
+      table.bigInteger('started_at').notNullable()
+      table.bigInteger('finished_at').notNullable()
+      table.primary(['run_id', 'seq'])
+      table.index(['run_id', 'name'], 'durable_checkpoints_name_idx')
+    })
+
+    this.schema.createTable('durable_run_attributes', (table) => {
+      table.string('run_id').notNullable()
+      table.string('key').notNullable()
+      table.string('str_value')
+      table.double('num_value')
+      table.primary(['run_id', 'key'])
+      table.index(['key', 'num_value'], 'durable_run_attributes_num_idx')
+      table.index(['key', 'str_value'], 'durable_run_attributes_str_idx')
+    })
+
+    this.schema.createTable('durable_signal_waiters', (table) => {
+      table.string('token').primary()
+      table.string('run_id').notNullable()
+      table.integer('seq').notNullable()
+    })
+
+    this.schema.createTable('durable_buffered_signals', (table) => {
+      table.increments('id').primary()
+      table.string('token').notNullable()
+      table.text('payload')
+      table.index(['token'], 'durable_buffered_signals_token_idx')
+    })
+  }
+
+  async down() {
+    this.schema.dropTableIfExists('durable_buffered_signals')
+    this.schema.dropTableIfExists('durable_signal_waiters')
+    this.schema.dropTableIfExists('durable_run_attributes')
+    this.schema.dropTableIfExists('durable_step_checkpoints')
+    this.schema.dropTableIfExists('durable_workflow_runs')
+  }
+}

package/dist/stubs/database/migrations/create_durable_transport_tables.stub

@@ -0,0 +1,75 @@
+{{{
+  exports({ to: app.migrationsPath(`${new Date().getTime()}_create_durable_transport_tables.ts`) })
+}}}
+import { BaseSchema } from '@adonisjs/lucid/schema'
+
+/**
+ * Transport tables for the @adonis-agora/durable `db` transport: the point-to-point work channels (tasks /
+ * results / heartbeats / control) that let durable remote steps run cross-process over the database
+ * alone. JSON payloads are stored as TEXT (the transport (de)serializes them) and timestamps as
+ * epoch-ms integers, so the schema is portable across SQLite / Postgres / MySQL. Only needed when you
+ * select the `db` transport in config/durable.ts.
+ */
+export default class extends BaseSchema {
+  async up() {
+    this.schema.createTable('durable_transport_tasks', (table) => {
+      table.string('step_id').primary()
+      table.string('run_id').notNullable()
+      table.integer('seq').notNullable()
+      table.string('name').notNullable()
+      table.string('grp').notNullable()
+      table.text('input')
+      table.string('traceparent')
+      table.text('context')
+      table.string('transport')
+      table.integer('attempt').notNullable()
+      table.string('claimed_by')
+      table.bigInteger('claimed_at')
+      table.bigInteger('created_at').notNullable()
+      table.index(['grp', 'claimed_at', 'created_at'], 'durable_transport_tasks_grp_idx')
+    })
+
+    this.schema.createTable('durable_transport_results', (table) => {
+      table.string('step_id').primary()
+      table.string('run_id').notNullable()
+      table.integer('seq').notNullable()
+      table.string('status').notNullable()
+      table.text('output')
+      table.text('error')
+      table.bigInteger('started_at')
+      table.text('events')
+      table.string('claimed_by')
+      table.bigInteger('claimed_at')
+      table.bigInteger('created_at').notNullable()
+      table.index(['claimed_at', 'created_at'], 'durable_transport_results_idx')
+    })
+
+    this.schema.createTable('durable_transport_heartbeats', (table) => {
+      table.increments('id').primary()
+      table.string('run_id').notNullable()
+      table.integer('seq').notNullable()
+      table.string('step_id').notNullable()
+      table.string('grp').notNullable()
+      table.string('claimed_by')
+      table.bigInteger('claimed_at')
+      table.bigInteger('created_at').notNullable()
+      table.index(['claimed_at', 'created_at'], 'durable_transport_heartbeats_idx')
+    })
+
+    this.schema.createTable('durable_transport_control', (table) => {
+      table.increments('id').primary()
+      table.text('payload').notNullable()
+      table.string('claimed_by')
+      table.bigInteger('claimed_at')
+      table.bigInteger('created_at').notNullable()
+      table.index(['claimed_at', 'created_at'], 'durable_transport_control_idx')
+    })
+  }
+
+  async down() {
+    this.schema.dropTableIfExists('durable_transport_control')
+    this.schema.dropTableIfExists('durable_transport_heartbeats')
+    this.schema.dropTableIfExists('durable_transport_results')
+    this.schema.dropTableIfExists('durable_transport_tasks')
+  }
+}

package/dist/stubs/main.d.ts

@@ -0,0 +1,3 @@
+/** Absolute path to the published stubs directory (`dist/stubs/main.js`). */
+export declare const stubsRoot: string;
+//# sourceMappingURL=main.d.ts.map

package/dist/stubs/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../stubs/main.ts"],"names":[],"mappings":"AAEA,6EAA6E;AAC7E,eAAO,MAAM,SAAS,QAAgD,CAAC"}

package/dist/stubs/main.js

@@ -0,0 +1,4 @@
+import { fileURLToPath } from 'node:url';
+/** Absolute path to the published stubs directory (`dist/stubs/main.js`). */
+export const stubsRoot = fileURLToPath(new URL('./', import.meta.url));
+//# sourceMappingURL=main.js.map

package/dist/stubs/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../stubs/main.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,6EAA6E;AAC7E,MAAM,CAAC,MAAM,SAAS,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,154 @@
+{
+  "name": "@adonis-agora/durable",
+  "version": "0.1.0",
+  "description": "Durable cross-app workflows for AdonisJS — deterministic replay engine, AdonisJS binding, ace commands, dashboard, OpenTelemetry, Telescope, testing harness and Redis admission, all in one package. Part of the Agora ecosystem.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/DavideCarvalho/adonis-durable.git",
+    "directory": "packages/adonis"
+  },
+  "author": "Davi Carvalho <davi@goflip.ai>",
+  "type": "module",
+  "main": "./dist/src/index.js",
+  "types": "./dist/src/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "import": "./dist/src/index.js",
+      "default": "./dist/src/index.js"
+    },
+    "./durable_provider": {
+      "types": "./dist/providers/durable_provider.d.ts",
+      "import": "./dist/providers/durable_provider.js",
+      "default": "./dist/providers/durable_provider.js"
+    },
+    "./dashboard_provider": {
+      "types": "./dist/providers/dashboard_provider.d.ts",
+      "import": "./dist/providers/dashboard_provider.js",
+      "default": "./dist/providers/dashboard_provider.js"
+    },
+    "./configure": {
+      "types": "./dist/configure.d.ts",
+      "import": "./dist/configure.js",
+      "default": "./dist/configure.js"
+    },
+    "./otel": {
+      "types": "./dist/src/otel/index.d.ts",
+      "import": "./dist/src/otel/index.js",
+      "default": "./dist/src/otel/index.js"
+    },
+    "./telescope": {
+      "types": "./dist/src/telescope/index.d.ts",
+      "import": "./dist/src/telescope/index.js",
+      "default": "./dist/src/telescope/index.js"
+    },
+    "./dashboard": {
+      "types": "./dist/src/dashboard/index.d.ts",
+      "import": "./dist/src/dashboard/index.js",
+      "default": "./dist/src/dashboard/index.js"
+    },
+    "./testing": {
+      "types": "./dist/src/testing-kit/index.d.ts",
+      "import": "./dist/src/testing-kit/index.js",
+      "default": "./dist/src/testing-kit/index.js"
+    },
+    "./admission-redis": {
+      "types": "./dist/src/admission-redis/index.d.ts",
+      "import": "./dist/src/admission-redis/index.js",
+      "default": "./dist/src/admission-redis/index.js"
+    },
+    "./commands": {
+      "types": "./dist/commands/main.d.ts",
+      "import": "./dist/commands/main.js",
+      "default": "./dist/commands/main.js"
+    },
+    "./commands/*": {
+      "types": "./dist/commands/*.d.ts",
+      "import": "./dist/commands/*.js",
+      "default": "./dist/commands/*.js"
+    }
+  },
+  "files": [
+    "dist/",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "sideEffects": false,
+  "dependencies": {
+    "zod": "^3.23.0"
+  },
+  "peerDependencies": {
+    "@adonisjs/core": "^6.12.0",
+    "@adonisjs/lucid": "^20.0.0 || ^21.0.0",
+    "@adonisjs/queue": "^0.6.0",
+    "@adonisjs/redis": "^9.0.0",
+    "@opentelemetry/api": "^1.0.0",
+    "cron-parser": "^4.0.0 || ^5.0.0",
+    "ioredis": "^5.0.0",
+    "vitest": "^3.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@adonisjs/lucid": {
+      "optional": true
+    },
+    "@adonisjs/queue": {
+      "optional": true
+    },
+    "@adonisjs/redis": {
+      "optional": true
+    },
+    "@opentelemetry/api": {
+      "optional": true
+    },
+    "cron-parser": {
+      "optional": true
+    },
+    "ioredis": {
+      "optional": true
+    },
+    "vitest": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@adonisjs/assembler": "^7.8.0",
+    "@adonisjs/core": "^6.17.0",
+    "@adonisjs/lucid": "^21.6.0",
+    "@adonisjs/queue": "^0.6.1",
+    "@adonisjs/redis": "^9.0.0",
+    "@opentelemetry/api": "^1.9.0",
+    "@opentelemetry/context-async-hooks": "^1.30.0",
+    "@opentelemetry/sdk-trace-base": "^1.30.0",
+    "@types/node": "^20.0.0",
+    "better-sqlite3": "^11.0.0",
+    "cron-parser": "^4.9.0",
+    "ioredis": "^5.4.0",
+    "typescript": "^5.4.0",
+    "vitest": "^3.0.0",
+    "zod": "^3.25.0"
+  },
+  "engines": {
+    "node": ">=20.6.0"
+  },
+  "keywords": [
+    "adonisjs",
+    "adonis",
+    "durable",
+    "workflow",
+    "saga",
+    "replay",
+    "dashboard",
+    "opentelemetry",
+    "telescope",
+    "testing",
+    "agora"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json && pnpm run copy:stubs",
+    "copy:stubs": "mkdir -p dist/stubs/config dist/stubs/database/migrations dist/assets && cp stubs/config/durable.stub dist/stubs/config/durable.stub && cp stubs/config/durable_dashboard.stub dist/stubs/config/durable_dashboard.stub && cp -r stubs/database/migrations/. dist/stubs/database/migrations/ && cp assets/dashboard.html dist/assets/dashboard.html",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
+}