@lunora/scheduler 1.0.0-alpha.1 → 1.0.0-alpha.3

package/dist/index.d.mts

@@ -131,10 +131,21 @@ interface Scheduler {
     scheduledFor: number;
   }>;
 }
+/**
+* Cloudflare Durable Object data-residency jurisdiction. Widening union —
+* Cloudflare adds values over time.
+* @see https://developers.cloudflare.com/durable-objects/reference/data-location/
+*/
+type DurableObjectJurisdiction = "eu" | "fedramp" | "us";
 /** Subset of `DurableObjectNamespace` the package consumes. */
 interface DurableObjectNamespaceLike {
   get: (id: DurableObjectIdLike) => DurableObjectStubLike;
   idFromName: (name: string) => DurableObjectIdLike;
+  /**
+  * Derive a jurisdiction-restricted subnamespace. Optional because older
+  * workers-types releases (and test doubles) may not expose it.
+  */
+  jurisdiction?: (jurisdiction: DurableObjectJurisdiction) => DurableObjectNamespaceLike;
 }
 interface DurableObjectIdLike {
   toString: () => string;
@@ -145,6 +156,13 @@ interface DurableObjectStubLike {
 interface LunoraSchedulerOptions {
   /** Optional named instance — useful for tenant isolation. Default `default`. */
   instanceName?: string;
+  /**
+  * Pin the SchedulerDO (durable timers + cron state) to a Cloudflare
+  * data-residency jurisdiction. Pass the same value as the worker's
+  * `jurisdiction` so scheduled state co-resides with app data. Omit for the
+  * un-pinned global namespace.
+  */
+  jurisdiction?: DurableObjectJurisdiction;
   /** Binding to the `SchedulerDO` durable object namespace. */
   namespace: DurableObjectNamespaceLike;
   /**
@@ -782,4 +800,4 @@ declare const isValidCronExpression: (schedule: string) => boolean;
 * job (`cron job "send digest"`) vs. the bare trigger.
 */
 declare const assertValidCronExpression: (schedule: string, context?: string) => void;
-export { type ArgsOf, CRON_SCHEDULE_KINDS, type CronJob, type CronJobsBuilder, type CronScheduleKind, type CronTarget, type CronTriggerOptions, type CronTriggerSnippet, type DailySchedule, type DurableObjectIdLike, type DurableObjectNamespaceLike, type DurableObjectStubLike, type EnqueueOptions, type FunctionReference, type HttpDispatcherOptions, type IntervalSchedule, type LunoraSchedulerOptions, type MessageBatchLike, type MonthlySchedule, type QueueConsumerOptions, type QueueDispatch, type QueueEnqueueOptions, type QueueJob, type QueueLike, type QueueMessageLike, type QueueSendOptionsLike, type QueueSendRequestLike, type QueueWorkpool, type QueueWorkpoolOptions, type RetryPolicy, type RunOptions, type ScheduleRecord, type Scheduler, SchedulerDO, type SchedulerDOState, type SchedulerEnv, type SchedulerPoolStatus, type SchedulerStatus, type WeeklySchedule, type WorkflowReference, type Workpool, type WorkpoolOptions, assertValidCronExpression, compileCronSchedule, createCronTrigger, createQueueConsumer, createQueueWorkpool, createScheduler, createWorkpool, cronJobs, httpDispatcher, isValidCronExpression, isWorkflowReference };
+export { type ArgsOf, CRON_SCHEDULE_KINDS, type CronJob, type CronJobsBuilder, type CronScheduleKind, type CronTarget, type CronTriggerOptions, type CronTriggerSnippet, type DailySchedule, type DurableObjectIdLike, type DurableObjectJurisdiction, type DurableObjectNamespaceLike, type DurableObjectStubLike, type EnqueueOptions, type FunctionReference, type HttpDispatcherOptions, type IntervalSchedule, type LunoraSchedulerOptions, type MessageBatchLike, type MonthlySchedule, type QueueConsumerOptions, type QueueDispatch, type QueueEnqueueOptions, type QueueJob, type QueueLike, type QueueMessageLike, type QueueSendOptionsLike, type QueueSendRequestLike, type QueueWorkpool, type QueueWorkpoolOptions, type RetryPolicy, type RunOptions, type ScheduleRecord, type Scheduler, SchedulerDO, type SchedulerDOState, type SchedulerEnv, type SchedulerPoolStatus, type SchedulerStatus, type WeeklySchedule, type WorkflowReference, type Workpool, type WorkpoolOptions, assertValidCronExpression, compileCronSchedule, createCronTrigger, createQueueConsumer, createQueueWorkpool, createScheduler, createWorkpool, cronJobs, httpDispatcher, isValidCronExpression, isWorkflowReference };

package/dist/index.d.ts

@@ -131,10 +131,21 @@ interface Scheduler {
     scheduledFor: number;
   }>;
 }
+/**
+* Cloudflare Durable Object data-residency jurisdiction. Widening union —
+* Cloudflare adds values over time.
+* @see https://developers.cloudflare.com/durable-objects/reference/data-location/
+*/
+type DurableObjectJurisdiction = "eu" | "fedramp" | "us";
 /** Subset of `DurableObjectNamespace` the package consumes. */
 interface DurableObjectNamespaceLike {
   get: (id: DurableObjectIdLike) => DurableObjectStubLike;
   idFromName: (name: string) => DurableObjectIdLike;
+  /**
+  * Derive a jurisdiction-restricted subnamespace. Optional because older
+  * workers-types releases (and test doubles) may not expose it.
+  */
+  jurisdiction?: (jurisdiction: DurableObjectJurisdiction) => DurableObjectNamespaceLike;
 }
 interface DurableObjectIdLike {
   toString: () => string;
@@ -145,6 +156,13 @@ interface DurableObjectStubLike {
 interface LunoraSchedulerOptions {
   /** Optional named instance — useful for tenant isolation. Default `default`. */
   instanceName?: string;
+  /**
+  * Pin the SchedulerDO (durable timers + cron state) to a Cloudflare
+  * data-residency jurisdiction. Pass the same value as the worker's
+  * `jurisdiction` so scheduled state co-resides with app data. Omit for the
+  * un-pinned global namespace.
+  */
+  jurisdiction?: DurableObjectJurisdiction;
   /** Binding to the `SchedulerDO` durable object namespace. */
   namespace: DurableObjectNamespaceLike;
   /**
@@ -782,4 +800,4 @@ declare const isValidCronExpression: (schedule: string) => boolean;
 * job (`cron job "send digest"`) vs. the bare trigger.
 */
 declare const assertValidCronExpression: (schedule: string, context?: string) => void;
-export { type ArgsOf, CRON_SCHEDULE_KINDS, type CronJob, type CronJobsBuilder, type CronScheduleKind, type CronTarget, type CronTriggerOptions, type CronTriggerSnippet, type DailySchedule, type DurableObjectIdLike, type DurableObjectNamespaceLike, type DurableObjectStubLike, type EnqueueOptions, type FunctionReference, type HttpDispatcherOptions, type IntervalSchedule, type LunoraSchedulerOptions, type MessageBatchLike, type MonthlySchedule, type QueueConsumerOptions, type QueueDispatch, type QueueEnqueueOptions, type QueueJob, type QueueLike, type QueueMessageLike, type QueueSendOptionsLike, type QueueSendRequestLike, type QueueWorkpool, type QueueWorkpoolOptions, type RetryPolicy, type RunOptions, type ScheduleRecord, type Scheduler, SchedulerDO, type SchedulerDOState, type SchedulerEnv, type SchedulerPoolStatus, type SchedulerStatus, type WeeklySchedule, type WorkflowReference, type Workpool, type WorkpoolOptions, assertValidCronExpression, compileCronSchedule, createCronTrigger, createQueueConsumer, createQueueWorkpool, createScheduler, createWorkpool, cronJobs, httpDispatcher, isValidCronExpression, isWorkflowReference };
+export { type ArgsOf, CRON_SCHEDULE_KINDS, type CronJob, type CronJobsBuilder, type CronScheduleKind, type CronTarget, type CronTriggerOptions, type CronTriggerSnippet, type DailySchedule, type DurableObjectIdLike, type DurableObjectJurisdiction, type DurableObjectNamespaceLike, type DurableObjectStubLike, type EnqueueOptions, type FunctionReference, type HttpDispatcherOptions, type IntervalSchedule, type LunoraSchedulerOptions, type MessageBatchLike, type MonthlySchedule, type QueueConsumerOptions, type QueueDispatch, type QueueEnqueueOptions, type QueueJob, type QueueLike, type QueueMessageLike, type QueueSendOptionsLike, type QueueSendRequestLike, type QueueWorkpool, type QueueWorkpoolOptions, type RetryPolicy, type RunOptions, type ScheduleRecord, type Scheduler, SchedulerDO, type SchedulerDOState, type SchedulerEnv, type SchedulerPoolStatus, type SchedulerStatus, type WeeklySchedule, type WorkflowReference, type Workpool, type WorkpoolOptions, assertValidCronExpression, compileCronSchedule, createCronTrigger, createQueueConsumer, createQueueWorkpool, createScheduler, createWorkpool, cronJobs, httpDispatcher, isValidCronExpression, isWorkflowReference };

package/dist/index.mjs

@@ -1,7 +1,7 @@
-export { default as createScheduler } from './packem_shared/createScheduler-KCso4_at.mjs';
-export { default as createWorkpool } from './packem_shared/createWorkpool-D5cWPQmH.mjs';
+export { default as createScheduler } from './packem_shared/createScheduler-CWMn70nv.mjs';
+export { default as createWorkpool } from './packem_shared/createWorkpool-CEnqCafM.mjs';
 export { createCronTrigger } from './packem_shared/createCronTrigger-Cq9IBcWQ.mjs';
-export { CRON_SCHEDULE_KINDS, compileCronSchedule, cronJobs } from './packem_shared/compileCronSchedule-BaLlXJiN.mjs';
+export { CRON_SCHEDULE_KINDS, compileCronSchedule, cronJobs } from './packem_shared/CRON_SCHEDULE_KINDS-BaLlXJiN.mjs';
 export { createQueueConsumer, createQueueWorkpool, httpDispatcher } from './packem_shared/createQueueConsumer-DWahNPfz.mjs';
 export { SchedulerDO } from './packem_shared/SchedulerDO-BNzXNnS4.mjs';
 export { isWorkflowReference } from './packem_shared/isWorkflowReference-C9mQkMXt.mjs';

package/dist/packem_shared/{createScheduler-KCso4_at.mjs → createScheduler-CWMn70nv.mjs}

@@ -1,5 +1,11 @@
+import { a as applyJurisdiction } from './jurisdiction-CR2zC3Et.mjs';
+
+const schedulerStub = (options) => {
+  const namespace = applyJurisdiction(options.namespace, options.jurisdiction);
+  return namespace.get(namespace.idFromName(options.instanceName ?? "default"));
+};
 const callDO = async (options, path, body) => {
-  const stub = options.namespace.get(options.namespace.idFromName(options.instanceName ?? "default"));
+  const stub = schedulerStub(options);
   const response = await stub.fetch(`https://scheduler.internal${path}`, {
     body: JSON.stringify(body),
     headers: { "content-type": "application/json" },
@@ -12,7 +18,7 @@ const callDO = async (options, path, body) => {
   return await response.json();
 };
 const getDO = async (options, path) => {
-  const stub = options.namespace.get(options.namespace.idFromName(options.instanceName ?? "default"));
+  const stub = schedulerStub(options);
   const response = await stub.fetch(`https://scheduler.internal${path}`, { method: "GET" });
   if (!response.ok) {
     const text = await response.text();

package/dist/packem_shared/{createWorkpool-D5cWPQmH.mjs → createWorkpool-CEnqCafM.mjs}

@@ -1,5 +1,11 @@
+import { a as applyJurisdiction } from './jurisdiction-CR2zC3Et.mjs';
+
+const workpoolStub = (options) => {
+  const namespace = applyJurisdiction(options.namespace, options.jurisdiction);
+  return namespace.get(namespace.idFromName(options.instanceName ?? "default"));
+};
 const callDO = async (options, path, body) => {
-  const stub = options.namespace.get(options.namespace.idFromName(options.instanceName ?? "default"));
+  const stub = workpoolStub(options);
   const response = await stub.fetch(`https://scheduler.internal${path}`, {
     body: JSON.stringify(body),
     headers: { "content-type": "application/json" },
@@ -12,7 +18,7 @@ const callDO = async (options, path, body) => {
   return await response.json();
 };
 const getDO = async (options, path) => {
-  const stub = options.namespace.get(options.namespace.idFromName(options.instanceName ?? "default"));
+  const stub = workpoolStub(options);
   const response = await stub.fetch(`https://scheduler.internal${path}`, { method: "GET" });
   if (!response.ok) {
     const text = await response.text();

package/dist/packem_shared/jurisdiction-CR2zC3Et.mjs

@@ -0,0 +1,13 @@
+const applyJurisdiction = (namespace, jurisdiction) => {
+  if (jurisdiction === void 0) {
+    return namespace;
+  }
+  if (typeof namespace.jurisdiction !== "function") {
+    throw new TypeError(
+      `@lunora/scheduler: Durable Object namespace does not support jurisdiction("${jurisdiction}") — update @cloudflare/workers-types or remove the jurisdiction option`
+    );
+  }
+  return namespace.jurisdiction(jurisdiction);
+};
+
+export { applyJurisdiction as a };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/scheduler",
-  "version": "1.0.0-alpha.1",
+  "version": "1.0.0-alpha.3",
   "description": "Scheduling for Lunora: runAfter / runAt and Cron Triggers via SchedulerDO",
   "keywords": [
     "cloudflare",
@@ -25,7 +25,7 @@
     "directory": "packages/scheduler"
   },
   "files": [
-    "dist",
+    "./dist",
     "__assets__",
     "README.md",
     "LICENSE.md"