@rippling/rippling-sdk 0.2.0-alpha.51 → 0.2.0-alpha.52

package/examples/functions/durable.ts

@@ -0,0 +1,96 @@
+import RipplingSDK, { DurableFunctionContext, FunctionEvent, FunctionResponse } from '@rippling/rippling-sdk';
+
+type OfferLetterCompletedEvent = {
+  status: 'signed' | 'declined';
+  signedDocumentId?: string;
+  declinedReason?: string;
+  completedAt?: string;
+};
+
+export async function onRipplingEvent(
+  event: FunctionEvent,
+  context: DurableFunctionContext,
+): Promise<FunctionResponse> {
+  const client = new RipplingSDK({
+    bearerToken: context.env.rippling_user_bearer_token,
+  });
+
+  const workflowDefinitionId = event['workflow_definition_id'] as string | undefined;
+  const employeeId = event['employee_id'] as string | undefined;
+  const offerLetterDocumentId = event['offer_letter_document_id'] as string | undefined;
+  const startDate = event['start_date'] as string | undefined;
+  const signingBonusAmount = Number(event['signing_bonus_amount'] ?? 0);
+
+  if (!workflowDefinitionId || !employeeId || !offerLetterDocumentId || !startDate) {
+    context.fail('Missing required onboarding inputs.', {
+      code: 'missing_onboarding_inputs',
+      details: {
+        hasWorkflowDefinitionId: Boolean(workflowDefinitionId),
+        hasEmployeeId: Boolean(employeeId),
+        hasOfferLetterDocumentId: Boolean(offerLetterDocumentId),
+        hasStartDate: Boolean(startDate),
+      },
+    });
+  }
+
+  await context.step('send offer letter document', async () => {
+    await client.workflowActionExecutions.create({
+      action_type: 'send_document',
+      payload: {
+        document: offerLetterDocumentId,
+        recipients: [employeeId],
+      },
+      workflow_definition_id: workflowDefinitionId,
+    });
+  });
+
+  const offerCompletion = await context.waitForEvent<OfferLetterCompletedEvent>(
+    'wait for signed offer letter',
+    {
+      type: 'offer_letter_completed',
+      timeout: '7 days',
+    },
+  );
+
+  if (offerCompletion.isTimeout()) {
+    context.fail('Offer letter was not completed before the deadline.', {
+      code: 'offer_letter_timeout',
+      details: offerCompletion,
+    });
+  }
+
+  if (offerCompletion.payload.status !== 'signed') {
+    context.fail('Offer letter was declined.', {
+      code: 'offer_letter_declined',
+      details: offerCompletion.payload,
+    });
+  }
+
+  await context.sleepUntil('wait until employee start date', startDate);
+
+  if (signingBonusAmount > 0) {
+    await context.step('schedule signing bonus payment', async () => {
+      await client.workflowActionExecutions.create({
+        action_type: 'make_payment',
+        payload: {
+          apply_cap: false,
+          description: `Signing bonus for durable run ${context.function.run_id}`,
+          payment_amount: signingBonusAmount,
+          recipients: [employeeId],
+        },
+        workflow_definition_id: workflowDefinitionId,
+      });
+    });
+  }
+
+  return new FunctionResponse({
+    statusCode: 200,
+    body: {
+      employeeId,
+      offerStatus: offerCompletion.payload.status,
+      signedDocumentId: offerCompletion.payload.signedDocumentId,
+      completedAt: offerCompletion.payload.completedAt,
+      signingBonusScheduled: signingBonusAmount > 0,
+    },
+  });
+}

package/functions.d.mts

@@ -12,6 +12,33 @@ export declare class FunctionResponse {
     constructor({ body, statusCode, headers, message }?: FunctionResponseOptions);
 }
 export type FunctionEvent = Record<string, any>;
+export type DurableDuration = number | string;
+export type DurableTimestamp = number | Date | string;
+export interface DurableWaitForEventOptions {
+    type: string;
+    timeout?: DurableDuration;
+}
+export interface DurableFailureOptions {
+    code?: string;
+    details?: unknown;
+}
+export interface DurableWaitForEventEventResult<T = unknown> {
+    kind: 'event';
+    waitName: string;
+    eventType: string;
+    payload: T;
+}
+export interface DurableWaitForEventTimeoutResult {
+    kind: 'timeout';
+    waitName: string;
+    eventType: string;
+}
+export interface DurableWaitForEventResultHelpers<T = unknown> {
+    isEvent(): this is DurableWaitForEventEventResult<T> & DurableWaitForEventResultHelpers<T>;
+    isTimeout(): this is DurableWaitForEventTimeoutResult & DurableWaitForEventResultHelpers<T>;
+    throwTimeout(this: DurableWaitForEventTimeoutResult & DurableWaitForEventResultHelpers<T>): never;
+}
+export type DurableWaitForEventResult<T = unknown> = (DurableWaitForEventEventResult<T> & DurableWaitForEventResultHelpers<T>) | (DurableWaitForEventTimeoutResult & DurableWaitForEventResultHelpers<T>);
 export interface FunctionContext {
     env: {
         rippling_user_bearer_token: string | undefined;
@@ -21,9 +48,17 @@ export interface FunctionContext {
         function_id: string;
         function_version_id: string;
         run_id: string;
+        role_id?: string;
     };
     settings: Record<string, string | boolean | number>;
 }
+export interface DurableFunctionContext extends FunctionContext {
+    step<T>(name: string, fn: () => Promise<T> | T, opts?: unknown): Promise<T>;
+    sleep(name: string, duration: DurableDuration): Promise<void>;
+    sleepUntil(name: string, timestamp: DurableTimestamp): Promise<void>;
+    waitForEvent<T = unknown>(name: string, opts: DurableWaitForEventOptions): Promise<DurableWaitForEventResult<T>>;
+    fail(message: string, opts?: DurableFailureOptions): never;
+}
 export declare class DataBridgeRecord {
     id: string;
     version: string;

package/functions.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"functions.d.mts","sourceRoot":"","sources":["src/functions.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"functions.d.mts","sourceRoot":"","sources":["src/functions.ts"],"names":[],"mappings":"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"}

package/functions.d.ts

@@ -12,6 +12,33 @@ export declare class FunctionResponse {
     constructor({ body, statusCode, headers, message }?: FunctionResponseOptions);
 }
 export type FunctionEvent = Record<string, any>;
+export type DurableDuration = number | string;
+export type DurableTimestamp = number | Date | string;
+export interface DurableWaitForEventOptions {
+    type: string;
+    timeout?: DurableDuration;
+}
+export interface DurableFailureOptions {
+    code?: string;
+    details?: unknown;
+}
+export interface DurableWaitForEventEventResult<T = unknown> {
+    kind: 'event';
+    waitName: string;
+    eventType: string;
+    payload: T;
+}
+export interface DurableWaitForEventTimeoutResult {
+    kind: 'timeout';
+    waitName: string;
+    eventType: string;
+}
+export interface DurableWaitForEventResultHelpers<T = unknown> {
+    isEvent(): this is DurableWaitForEventEventResult<T> & DurableWaitForEventResultHelpers<T>;
+    isTimeout(): this is DurableWaitForEventTimeoutResult & DurableWaitForEventResultHelpers<T>;
+    throwTimeout(this: DurableWaitForEventTimeoutResult & DurableWaitForEventResultHelpers<T>): never;
+}
+export type DurableWaitForEventResult<T = unknown> = (DurableWaitForEventEventResult<T> & DurableWaitForEventResultHelpers<T>) | (DurableWaitForEventTimeoutResult & DurableWaitForEventResultHelpers<T>);
 export interface FunctionContext {
     env: {
         rippling_user_bearer_token: string | undefined;
@@ -21,9 +48,17 @@ export interface FunctionContext {
         function_id: string;
         function_version_id: string;
         run_id: string;
+        role_id?: string;
     };
     settings: Record<string, string | boolean | number>;
 }
+export interface DurableFunctionContext extends FunctionContext {
+    step<T>(name: string, fn: () => Promise<T> | T, opts?: unknown): Promise<T>;
+    sleep(name: string, duration: DurableDuration): Promise<void>;
+    sleepUntil(name: string, timestamp: DurableTimestamp): Promise<void>;
+    waitForEvent<T = unknown>(name: string, opts: DurableWaitForEventOptions): Promise<DurableWaitForEventResult<T>>;
+    fail(message: string, opts?: DurableFailureOptions): never;
+}
 export declare class DataBridgeRecord {
     id: string;
     version: string;

package/functions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"functions.d.ts","sourceRoot":"","sources":["src/functions.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"functions.d.ts","sourceRoot":"","sources":["src/functions.ts"],"names":[],"mappings":"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"}

package/functions.js.map

@@ -1 +1 @@
-{"version":3,"file":"functions.js","sourceRoot":"","sources":["src/functions.ts"],"names":[],"mappings":";;;AAUA,MAAa,gBAAgB;IAM3B,YAAY,EAAE,IAAI,GAAG,EAAE,EAAE,UAAU,GAAG,GAAG,EAAE,OAAO,GAAG,EAAE,EAAE,OAAO,GAAG,EAAE,KAA8B,EAAE;QACnG,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAZD,4CAYC;AAmBD,MAAa,gBAAgB;IAM3B,YAAY,EAAU,EAAE,OAAe,EAAE,KAAU,EAAE,QAAa;QAChE,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF;AAZD,4CAYC;AAED,MAAa,mBAAmB;IAI9B,YAAY,EAAU,EAAE,OAAe;QACrC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AARD,kDAQC;AAED,MAAa,cAAc;IAKzB,YAAY,UAAkB,EAAE,SAAc,EAAE,YAAiB;QAC/D,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;CACF;AAVD,wCAUC;AAWD,MAAa,kBAAkB;IAQ7B,YAAY,EACV,OAAO,GAAG,EAAE,EACZ,UAAU,GAAG,EAAE,EACf,UAAU,GAAG,EAAE,EACf,KAAK,GAAG,EAAE,EACV,IAAI,GAAG,KAAK,EACZ,KAAK,GAAG,EAAE,MACmB,EAAE;QAC/B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AAvBD,gDAuBC;AAYD,MAAa,wBAAyB,SAAQ,KAAK;IAEjD,YAAY,OAAe,EAAE,iBAAyB;QACpD,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC;YACjC,OAAO;YACP,iBAAiB;SAClB,CAAC,CAAC;QAEH,KAAK,CAAC,WAAW,CAAC,CAAC;QACnB,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,iBAAiB,GAAG,iBAAiB,CAAC;IAC7C,CAAC;CACF;AAZD,4DAYC"}
+{"version":3,"file":"functions.js","sourceRoot":"","sources":["src/functions.ts"],"names":[],"mappings":";;;AAUA,MAAa,gBAAgB;IAM3B,YAAY,EAAE,IAAI,GAAG,EAAE,EAAE,UAAU,GAAG,GAAG,EAAE,OAAO,GAAG,EAAE,EAAE,OAAO,GAAG,EAAE,KAA8B,EAAE;QACnG,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAZD,4CAYC;AA6DD,MAAa,gBAAgB;IAM3B,YAAY,EAAU,EAAE,OAAe,EAAE,KAAU,EAAE,QAAa;QAChE,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF;AAZD,4CAYC;AAED,MAAa,mBAAmB;IAI9B,YAAY,EAAU,EAAE,OAAe;QACrC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AARD,kDAQC;AAED,MAAa,cAAc;IAKzB,YAAY,UAAkB,EAAE,SAAc,EAAE,YAAiB;QAC/D,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;CACF;AAVD,wCAUC;AAWD,MAAa,kBAAkB;IAQ7B,YAAY,EACV,OAAO,GAAG,EAAE,EACZ,UAAU,GAAG,EAAE,EACf,UAAU,GAAG,EAAE,EACf,KAAK,GAAG,EAAE,EACV,IAAI,GAAG,KAAK,EACZ,KAAK,GAAG,EAAE,MACmB,EAAE;QAC/B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AAvBD,gDAuBC;AAYD,MAAa,wBAAyB,SAAQ,KAAK;IAEjD,YAAY,OAAe,EAAE,iBAAyB;QACpD,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC;YACjC,OAAO;YACP,iBAAiB;SAClB,CAAC,CAAC;QAEH,KAAK,CAAC,WAAW,CAAC,CAAC;QACnB,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,iBAAiB,GAAG,iBAAiB,CAAC;IAC7C,CAAC;CACF;AAZD,4DAYC"}

package/functions.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"functions.mjs","sourceRoot":"","sources":["src/functions.ts"],"names":[],"mappings":"AAUA,MAAM,OAAO,gBAAgB;IAM3B,YAAY,EAAE,IAAI,GAAG,EAAE,EAAE,UAAU,GAAG,GAAG,EAAE,OAAO,GAAG,EAAE,EAAE,OAAO,GAAG,EAAE,KAA8B,EAAE;QACnG,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAmBD,MAAM,OAAO,gBAAgB;IAM3B,YAAY,EAAU,EAAE,OAAe,EAAE,KAAU,EAAE,QAAa;QAChE,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF;AAED,MAAM,OAAO,mBAAmB;IAI9B,YAAY,EAAU,EAAE,OAAe;QACrC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAED,MAAM,OAAO,cAAc;IAKzB,YAAY,UAAkB,EAAE,SAAc,EAAE,YAAiB;QAC/D,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;CACF;AAWD,MAAM,OAAO,kBAAkB;IAQ7B,YAAY,EACV,OAAO,GAAG,EAAE,EACZ,UAAU,GAAG,EAAE,EACf,UAAU,GAAG,EAAE,EACf,KAAK,GAAG,EAAE,EACV,IAAI,GAAG,KAAK,EACZ,KAAK,GAAG,EAAE,MACmB,EAAE;QAC/B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AAYD,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IAEjD,YAAY,OAAe,EAAE,iBAAyB;QACpD,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC;YACjC,OAAO;YACP,iBAAiB;SAClB,CAAC,CAAC;QAEH,KAAK,CAAC,WAAW,CAAC,CAAC;QACnB,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,iBAAiB,GAAG,iBAAiB,CAAC;IAC7C,CAAC;CACF"}
+{"version":3,"file":"functions.mjs","sourceRoot":"","sources":["src/functions.ts"],"names":[],"mappings":"AAUA,MAAM,OAAO,gBAAgB;IAM3B,YAAY,EAAE,IAAI,GAAG,EAAE,EAAE,UAAU,GAAG,GAAG,EAAE,OAAO,GAAG,EAAE,EAAE,OAAO,GAAG,EAAE,KAA8B,EAAE;QACnG,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AA6DD,MAAM,OAAO,gBAAgB;IAM3B,YAAY,EAAU,EAAE,OAAe,EAAE,KAAU,EAAE,QAAa;QAChE,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF;AAED,MAAM,OAAO,mBAAmB;IAI9B,YAAY,EAAU,EAAE,OAAe;QACrC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAED,MAAM,OAAO,cAAc;IAKzB,YAAY,UAAkB,EAAE,SAAc,EAAE,YAAiB;QAC/D,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;CACF;AAWD,MAAM,OAAO,kBAAkB;IAQ7B,YAAY,EACV,OAAO,GAAG,EAAE,EACZ,UAAU,GAAG,EAAE,EACf,UAAU,GAAG,EAAE,EACf,KAAK,GAAG,EAAE,EACV,IAAI,GAAG,KAAK,EACZ,KAAK,GAAG,EAAE,MACmB,EAAE;QAC/B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AAYD,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IAEjD,YAAY,OAAe,EAAE,iBAAyB;QACpD,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC;YACjC,OAAO;YACP,iBAAiB;SAClB,CAAC,CAAC;QAEH,KAAK,CAAC,WAAW,CAAC,CAAC;QACnB,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,iBAAiB,GAAG,iBAAiB,CAAC;IAC7C,CAAC;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rippling/rippling-sdk",
-  "version": "0.2.0-alpha.51",
+  "version": "0.2.0-alpha.52",
   "description": "The official TypeScript library for the Rippling SDK API",
   "author": "Rippling SDK <no-reply@rippling.com>",
   "types": "./index.d.ts",

package/src/functions.md

@@ -0,0 +1,238 @@
+# Durable Function APIs
+
+Durable functions are Rippling functions that receive a `DurableFunctionContext`. They let you split work into named, durable steps; pause execution; wait for external events; and fail runs with structured metadata.
+
+## Function signature
+
+```ts
+import RipplingSDK, { DurableFunctionContext, FunctionEvent, FunctionResponse } from '@rippling/rippling-sdk';
+
+export async function onRipplingEvent(
+  event: FunctionEvent,
+  context: DurableFunctionContext,
+): Promise<FunctionResponse> {
+  return new FunctionResponse({ statusCode: 200 });
+}
+```
+
+## Context APIs
+
+```ts
+// context.step()
+const documentResult = await context.step('send offer letter', async () => {
+  return await client.workflowActionExecutions.create({
+    action_type: 'send_document',
+    payload: {
+      document: offerLetterDocumentId,
+      recipients: [employeeId],
+    },
+    workflow_definition_id: event['workflow_definition_id'],
+  });
+});
+
+// context.sleep()
+await context.sleep('wait before retry', '1 hour');
+await context.sleep('wait 5 seconds', 5000); // milliseconds
+
+// context.sleepUntil()
+await context.sleepUntil('wait until launch', new Date('2025-01-01T00:00:00Z'));
+await context.sleepUntil('wait until timestamp', Date.parse('2025-01-01T00:00:00Z'));
+
+// context.waitForEvent()
+const approval = await context.waitForEvent<{ approved: boolean }>('wait for approval', {
+  type: 'approval',
+  timeout: '24 hours',
+});
+
+if (approval.isTimeout()) {
+  context.fail('Approval timed out', {
+    code: 'approval_timeout',
+    details: approval,
+  });
+}
+
+if (!approval.payload.approved) {
+  context.fail('Approval was rejected', {
+    code: 'approval_rejected',
+    details: approval.payload,
+  });
+}
+```
+
+## `DurableFunctionContext`
+
+`DurableFunctionContext` extends the standard `FunctionContext` with durable execution methods.
+
+```ts
+interface DurableFunctionContext extends FunctionContext {
+  step<T>(name: string, fn: () => Promise<T> | T, opts?: unknown): Promise<T>;
+  sleep(name: string, duration: DurableDuration): Promise<void>;
+  sleepUntil(name: string, timestamp: DurableTimestamp): Promise<void>;
+  waitForEvent<T = unknown>(
+    name: string,
+    opts: DurableWaitForEventOptions,
+  ): Promise<DurableWaitForEventResult<T>>;
+  fail(message: string, opts?: DurableFailureOptions): never;
+}
+
+interface DurableWaitForEventEventResult<T = unknown> {
+  kind: 'event';
+  waitName: string;
+  eventType: string;
+  payload: T;
+}
+
+interface DurableWaitForEventTimeoutResult {
+  kind: 'timeout';
+  waitName: string;
+  eventType: string;
+}
+
+interface DurableWaitForEventResultHelpers<T = unknown> {
+  isEvent(): this is DurableWaitForEventEventResult<T> & DurableWaitForEventResultHelpers<T>;
+  isTimeout(): this is DurableWaitForEventTimeoutResult & DurableWaitForEventResultHelpers<T>;
+  throwTimeout(this: DurableWaitForEventTimeoutResult & DurableWaitForEventResultHelpers<T>): never;
+}
+
+type DurableWaitForEventResult<T = unknown> =
+  | (DurableWaitForEventEventResult<T> & DurableWaitForEventResultHelpers<T>)
+  | (DurableWaitForEventTimeoutResult & DurableWaitForEventResultHelpers<T>);
+```
+
+The inherited `FunctionContext` includes environment, function metadata, and settings.
+
+```ts
+interface FunctionContext {
+  env: {
+    rippling_user_bearer_token: string | undefined;
+  };
+  function: {
+    company_id: string;
+    function_id: string;
+    function_version_id: string;
+    run_id: string;
+    role_id?: string;
+  };
+  settings: Record<string, string | boolean | number>;
+}
+```
+
+## Step API
+
+Use `context.step()` for work that should be durably tracked. Each step should have a stable, descriptive name.
+
+```ts
+const employeeId = event['employee_id'] as string;
+const offerLetterDocumentId = event['offer_letter_document_id'] as string;
+const signingBonusAmount = Number(event['signing_bonus_amount'] ?? 0);
+
+await context.step('send offer letter document', async () => {
+  await client.workflowActionExecutions.create({
+    action_type: 'send_document',
+    payload: {
+      document: offerLetterDocumentId,
+      recipients: [employeeId],
+    },
+    workflow_definition_id: event['workflow_definition_id'],
+  });
+});
+
+if (signingBonusAmount > 0) {
+  await context.step('schedule signing bonus payment', async () => {
+    await client.workflowActionExecutions.create({
+      action_type: 'make_payment',
+      payload: {
+        apply_cap: false,
+        description: `Signing bonus for run ${context.function.run_id}`,
+        payment_amount: signingBonusAmount,
+        recipients: [employeeId],
+      },
+      workflow_definition_id: event['workflow_definition_id'],
+    });
+  });
+}
+```
+
+### Idempotency
+
+Code inside `context.step()` may be replayed or retried by the durable runtime. Design side-effecting steps to be idempotent when possible.
+
+```ts
+await context.step('make relocation payment', async () => {
+  await client.workflowActionExecutions.create({
+    action_type: 'make_payment',
+    payload: {
+      apply_cap: true,
+      description: `Relocation payment for durable run ${context.function.run_id}`,
+      payment_amount: 250000,
+      recipients: [employeeId],
+    },
+    workflow_definition_id: event['workflow_definition_id'],
+  });
+});
+```
+
+## Sleep and scheduling
+
+Use `context.sleep()` for relative delays and `context.sleepUntil()` for absolute wake-up times.
+
+```ts
+// Relative delays
+await context.sleep('wait 15 minutes', '15 minutes');
+await context.sleep('wait 1 day', '1 day');
+await context.sleep('wait 5 seconds', 5000); // milliseconds
+
+// Absolute times
+await context.sleepUntil('wait until deadline', new Date('2025-12-31T23:59:59Z'));
+await context.sleepUntil('wait until epoch timestamp', 1767225599000);
+await context.sleepUntil('wait until ISO timestamp', '2025-12-31T23:59:59Z');
+```
+
+`DurableDuration` accepts a `number` or `string`. `DurableTimestamp` accepts a `number`, `Date`, or `string`.
+
+## Waiting for external events
+
+Use `context.waitForEvent()` when a function should pause until another system sends an event back to the run. The method returns a structured result with `kind: 'event'` when the event arrives, or `kind: 'timeout'` when the timeout expires.
+
+```ts
+type ApprovalEvent = {
+  approved: boolean;
+  reviewerId: string;
+  reason?: string;
+};
+
+const approval = await context.waitForEvent<ApprovalEvent>('wait for manager approval', {
+  type: 'manager_approval',
+  timeout: '3 days',
+});
+
+if (approval.isTimeout()) {
+  context.fail('Manager approval timed out', {
+    code: 'approval_timeout',
+    details: approval,
+  });
+}
+
+if (!approval.payload.approved) {
+  context.fail('Manager rejected the request', {
+    code: 'approval_rejected',
+    details: approval.payload,
+  });
+}
+```
+
+## Failing a durable function
+
+Use `context.fail()` to stop the run with a human-readable message and optional structured failure metadata.
+
+```ts
+context.fail('The requested employee could not be found', {
+  code: 'employee_not_found',
+  details: {
+    employeeId,
+    runId: context.function.run_id,
+  },
+});
+```
+
+Because `fail()` returns `never`, TypeScript understands that code after it is unreachable.

package/src/functions.ts

@@ -23,6 +23,36 @@ export class FunctionResponse {
 }
 
 export type FunctionEvent = Record<string, any>;
+export type DurableDuration = number | string;
+export type DurableTimestamp = number | Date | string;
+export interface DurableWaitForEventOptions {
+  type: string;
+  timeout?: DurableDuration;
+}
+export interface DurableFailureOptions {
+  code?: string;
+  details?: unknown;
+}
+export interface DurableWaitForEventEventResult<T = unknown> {
+  kind: 'event';
+  waitName: string;
+  eventType: string;
+  payload: T;
+}
+export interface DurableWaitForEventTimeoutResult {
+  kind: 'timeout';
+  waitName: string;
+  eventType: string;
+}
+export interface DurableWaitForEventResultHelpers<T = unknown> {
+  isEvent(): this is DurableWaitForEventEventResult<T> & DurableWaitForEventResultHelpers<T>;
+  isTimeout(): this is DurableWaitForEventTimeoutResult & DurableWaitForEventResultHelpers<T>;
+  throwTimeout(this: DurableWaitForEventTimeoutResult & DurableWaitForEventResultHelpers<T>): never;
+}
+export type DurableWaitForEventResult<T = unknown> =
+  | (DurableWaitForEventEventResult<T> & DurableWaitForEventResultHelpers<T>)
+  | (DurableWaitForEventTimeoutResult & DurableWaitForEventResultHelpers<T>);
+
 export interface FunctionContext {
   env: {
     // Set to the Rippling user's bearer token when the function is triggered by a user.
@@ -35,10 +65,22 @@ export interface FunctionContext {
     function_id: string;
     function_version_id: string;
     run_id: string;
+    role_id?: string;
   };
   settings: Record<string, string | boolean | number>;
 }
 
+export interface DurableFunctionContext extends FunctionContext {
+  step<T>(name: string, fn: () => Promise<T> | T, opts?: unknown): Promise<T>;
+  sleep(name: string, duration: DurableDuration): Promise<void>;
+  sleepUntil(name: string, timestamp: DurableTimestamp): Promise<void>;
+  waitForEvent<T = unknown>(
+    name: string,
+    opts: DurableWaitForEventOptions,
+  ): Promise<DurableWaitForEventResult<T>>;
+  fail(message: string, opts?: DurableFailureOptions): never;
+}
+
 export class DataBridgeRecord {
   id: string;
   version: string;

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.2.0-alpha.51'; // x-release-please-version
+export const VERSION = '0.2.0-alpha.52'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.2.0-alpha.51";
+export declare const VERSION = "0.2.0-alpha.52";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.2.0-alpha.51";
+export declare const VERSION = "0.2.0-alpha.52";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '0.2.0-alpha.51'; // x-release-please-version
+exports.VERSION = '0.2.0-alpha.52'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '0.2.0-alpha.51'; // x-release-please-version
+export const VERSION = '0.2.0-alpha.52'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map