@temporal-contract/contract 0.0.2 → 0.0.4

package/dist/index.mjs

@@ -190,4 +190,118 @@ const defineContract = (definition) => {
 };
 
 //#endregion
-export { defineActivity, defineContract, defineQuery, defineSignal, defineUpdate, defineWorkflow };
+//#region src/nexus-types.ts
+/**
+* BUILDER FUNCTIONS (Proposed API)
+* These would be added to builder.ts when Nexus support is implemented
+*/
+/**
+* Builder for creating Nexus operation definitions
+*
+* @template TOperation - A NexusOperationDefinition containing input and output schemas
+* @param definition - The Nexus operation definition with typed input/output schemas
+* @returns The same definition with preserved types
+*
+* @example
+* ```typescript
+* const processPayment = defineNexusOperation({
+*   input: z.object({ amount: z.number(), customerId: z.string() }),
+*   output: z.object({ transactionId: z.string(), status: z.enum(['success', 'failed']) }),
+* });
+* ```
+*/
+function defineNexusOperation(definition) {
+	return definition;
+}
+/**
+* Builder for creating Nexus service definitions
+*
+* @template TService - A NexusServiceDefinition containing a record of operations
+* @param definition - The Nexus service definition with typed operations
+* @returns The same definition with preserved types
+*
+* @example
+* ```typescript
+* const PaymentService = defineNexusService({
+*   operations: {
+*     processPayment: defineNexusOperation({ ... }),
+*     refundPayment: defineNexusOperation({ ... }),
+*   },
+* });
+* ```
+*/
+function defineNexusService(definition) {
+	return definition;
+}
+/**
+* USAGE EXAMPLE
+*
+* This example demonstrates the complete type-safe Nexus workflow:
+*
+* ```typescript
+* import { defineContract, defineNexusService, defineNexusOperation } from '@temporal-contract/contract';
+* import { z } from 'zod';
+*
+* // 1. Define contract with Nexus service
+* const paymentContract = defineContract({
+*   taskQueue: 'payments',
+*   workflows: { ... },
+*   nexusServices: {
+*     PaymentService: defineNexusService({
+*       operations: {
+*         processPayment: defineNexusOperation({
+*           input: z.object({
+*             amount: z.number().positive(),
+*             customerId: z.string().uuid(),
+*           }),
+*           output: z.object({
+*             transactionId: z.string(),
+*             status: z.enum(['success', 'failed']),
+*           }),
+*         }),
+*       },
+*     }),
+*   },
+* });
+*
+* // 2. Worker implementation (type-safe handlers)
+* import { createNexusHandlers } from '@temporal-contract/worker';
+*
+* const nexusHandlers = createNexusHandlers(paymentContract, {
+*   PaymentService: {
+*     processPayment: async ({ amount, customerId }) => {
+*       // ✅ Fully typed parameters
+*       // ✅ Input automatically validated
+*       const payment = await processPaymentInDatabase(customerId, amount);
+*       // ✅ Return value validated against schema
+*       return {
+*         transactionId: payment.id,
+*         status: 'success',
+*       };
+*     },
+*   },
+* });
+*
+* // 3. Client usage (type-safe invocation)
+* import { createNexusClient } from '@temporal-contract/client';
+*
+* const nexusClient = createNexusClient<typeof paymentContract>(connection, {
+*   namespace: 'payments-ns',
+* });
+*
+* // ✅ Fully typed invocation
+* const result = await nexusClient.invoke('PaymentService', 'processPayment', {
+*   amount: 100,
+*   customerId: 'cust-123',
+* });
+*
+* // ❌ TypeScript errors caught at compile time
+* await nexusClient.invoke('PaymentService', 'processPayment', {
+*   amount: -50, // Error: amount must be positive
+*   customerId: 'invalid', // Error: customerId must be UUID
+* });
+* ```
+*/
+
+//#endregion
+export { defineActivity, defineContract, defineNexusOperation, defineNexusService, defineQuery, defineSignal, defineUpdate, defineWorkflow };

package/package.json

@@ -1,8 +1,12 @@
 {
   "name": "@temporal-contract/contract",
-  "version": "0.0.2",
-  "type": "module",
+  "version": "0.0.4",
   "description": "Contract builder for temporal-contract",
+  "keywords": [
+    "temporal",
+    "typescript",
+    "contract"
+  ],
   "homepage": "https://github.com/btravers/temporal-contract#readme",
   "bugs": {
     "url": "https://github.com/btravers/temporal-contract/issues"
@@ -12,16 +16,9 @@
     "url": "https://github.com/btravers/temporal-contract.git",
     "directory": "packages/contract"
   },
-  "author": "Benoit TRAVERS <benoit.travers.frgmail.com>",
   "license": "MIT",
-  "keywords": [
-    "temporal",
-    "typescript",
-    "contract"
-  ],
-  "main": "./dist/index.cjs",
-  "module": "./dist/index.mjs",
-  "types": "./dist/index.d.mts",
+  "author": "Benoit TRAVERS <benoit.travers.frgmail.com>",
+  "type": "module",
   "exports": {
     ".": {
       "import": {
@@ -35,6 +32,12 @@
     },
     "./package.json": "./package.json"
   },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "files": [
+    "dist"
+  ],
   "dependencies": {
     "@standard-schema/spec": "1.0.0",
     "zod": "4.1.13"
@@ -42,17 +45,17 @@
   "devDependencies": {
     "@vitest/coverage-v8": "4.0.15",
     "arktype": "2.1.28",
-    "tsdown": "0.17.2",
+    "tsdown": "0.17.3",
     "typescript": "5.9.3",
     "valibot": "1.2.0",
     "vitest": "4.0.15",
-    "@temporal-contract/tsconfig": "0.0.2"
+    "@temporal-contract/tsconfig": "0.0.4"
   },
   "scripts": {
-    "dev": "tsdown src/index.ts --format cjs,esm --dts --watch",
     "build": "tsdown src/index.ts --format cjs,esm --dts --clean",
-    "typecheck": "tsc --noEmit",
+    "dev": "tsdown src/index.ts --format cjs,esm --dts --watch",
     "test": "vitest run",
-    "test:watch": "vitest"
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
   }
 }

package/.turbo/turbo-build.log

@@ -1,17 +0,0 @@
-
-> @temporal-contract/contract@0.0.2 build /home/runner/work/temporal-contract/temporal-contract/packages/contract
-> tsdown src/index.ts --format cjs,esm --dts --clean
-
-ℹ tsdown v0.17.2 powered by rolldown v1.0.0-beta.53
-ℹ entry: src/index.ts
-ℹ tsconfig: tsconfig.json
-ℹ Build start
-ℹ [CJS] dist/index.cjs  6.97 kB │ gzip: 1.69 kB
-ℹ [CJS] 1 files, total: 6.97 kB
-ℹ [CJS] dist/index.d.cts  15.66 kB │ gzip: 2.56 kB
-ℹ [CJS] 1 files, total: 15.66 kB
-✔ Build complete in 1491ms
-ℹ [ESM] dist/index.mjs     6.74 kB │ gzip: 1.67 kB
-ℹ [ESM] dist/index.d.mts  15.66 kB │ gzip: 2.56 kB
-ℹ [ESM] 2 files, total: 22.40 kB
-✔ Build complete in 1492ms

package/CHANGELOG.md

@@ -1,7 +0,0 @@
-# @temporal-contract/contract
-
-## 0.0.2
-
-### Patch Changes
-
-- Release version 0.0.2