@empyria/restate 0.1.2 → 0.1.3

package/README.md

@@ -45,7 +45,7 @@ import { checkServiceHandler } from '@empyria/restate/lib/Admin.js'
 
 | Module                                   | Purpose                                                                                                                                                                                                       |
 | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| [lib/Admin.js](./lib/Admin.js)           | Restate Admin API client — service/handler discovery, deployment registration and teardown, workflow/message dispatch, and `setupRestate` for wiring up an endpoint with health checks and graceful shutdown. |
+| [lib/Admin.js](./lib/Admin.js)           | Restate Admin API client — service/handler discovery, deployment registration and teardown, workflow/message dispatch, `defineWorkflow`/`defineService`/`defineObject`/`definePubsub` construct definers, and `setupRestate` for wiring up an endpoint with health checks and graceful shutdown. |
 | [lib/Caller.js](./lib/Caller.js)         | `CallerServiceDef` — a generic Restate service that dispatches a call to any handler on any other service by name, for when the target isn't known at compile time.                                           |
 | [lib/Cron.js](./lib/Cron.js)             | `cronJobInitiator`/`cronJob` — Restate services implementing cron-driven, replay-safe recurring job scheduling on top of `croner`.                                                                            |
 | [lib/Validation.js](./lib/Validation.js) | `withValidation` — wraps a workflow handler with input/output JSON schema validation via `@empyria/common`.                                                                                                   |

package/lib/Admin.js

@@ -6,6 +6,7 @@ import { setTimeout as sleep } from 'timers/promises'
 
 import * as restate from '@restatedev/restate-sdk'
 import * as clients from '@restatedev/restate-sdk-clients'
+import { createPubsubObject } from '@restatedev/pubsub'
 
 export { restate, clients }
 
@@ -437,6 +438,21 @@ export function defineObject(def) {
 	return restate.object(def)
 }
 
+/**
+ * Typed wrapper around `@restatedev/pubsub`'s `createPubsubObject`; see {@link defineWorkflow}.
+ * Unlike `defineWorkflow`/`defineService`/`defineObject`, there's no handler map to write —
+ * `createPubsubObject` returns a complete `VirtualObjectDefinition` on its own (pull/publish/
+ * subscribe/truncate), so this exists purely for the same "one `define*` per Restate construct"
+ * naming consistency, not to add behavior. Register the result alongside your other
+ * services/objects on the same endpoint (see `setupRestate`'s `services` param) — that's what
+ * makes the endpoint's ingress serve `/pubsub/<topic>` as an SSE stream for it.
+ * @param {Parameters<typeof createPubsubObject>[0]} name
+ * @param {Parameters<typeof createPubsubObject>[1]} [options]
+ */
+export function definePubsub(name, options) {
+	return createPubsubObject(name, options)
+}
+
 /**
  * Starts the HTTP/2 Restate endpoint, a health-check HTTP server, registers
  * the deployment with the admin API, and wires SIGTERM/SIGINT for graceful

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@empyria/restate",
-	"version": "0.1.2",
+	"version": "0.1.3",
 	"description": "Restate.dev helpers for the Empyria nanoservice framework",
 	"license": "MIT",
 	"author": "Imre Fazekas <imre.fazekas@icloud.com>",
@@ -26,13 +26,14 @@
 	"dependencies": {
 		"@empyria/classification": "0.1.2",
 		"@empyria/common": "0.1.2",
-		"@restatedev/restate-sdk": "1.16.7",
-		"@restatedev/restate-sdk-clients": "1.16.7",
-		"@restatedev/restate-sdk-core": "1.16.7",
+		"@restatedev/pubsub": "0.3.2",
+		"@restatedev/restate-sdk": "1.16.8",
+		"@restatedev/restate-sdk-clients": "1.16.8",
+		"@restatedev/restate-sdk-core": "1.16.8",
 		"croner": "10.0.1"
 	},
 	"devDependencies": {
-		"@restatedev/restate-server": "1.7.4",
+		"@restatedev/restate-server": "1.7.6",
 		"oxfmt": "0.64.0",
 		"oxlint": "1.79.0"
 	},

package/test/Admin.test.js

@@ -20,6 +20,7 @@ import {
 	defineWorkflow,
 	defineService,
 	defineObject,
+	definePubsub,
 	createRestateAdmin,
 	restate,
 	clients,
@@ -455,6 +456,18 @@ describe('defineWorkflow / defineService / defineObject', () => {
 	})
 })
 
+describe('definePubsub', () => {
+	test('is a passthrough to createPubsubObject, name and all', () => {
+		const pubsub = definePubsub('pubsub')
+		expect(pubsub.name).toBe('pubsub')
+	})
+
+	test('forwards options (e.g. pullTimeout) to createPubsubObject', () => {
+		const pubsub = definePubsub('pubsub', { pullTimeout: { seconds: 30 } })
+		expect(pubsub.name).toBe('pubsub')
+	})
+})
+
 describe('createRestateAdmin', () => {
 	test('binds restateAdminURL/restateURL across its methods', async () => {
 		globalThis.fetch = mock(async (url) => {