four-stroke 0.1.3 → 0.1.4

package/REVIEW.md

@@ -0,0 +1,8 @@
+[//]: # Autogenerated by https://github.com/change-engine/ecu/github
+
+# Review instructions
+
+## Do not report
+
+- PRs opened by dependabot[bot]
+- Any branch matching `dependabot/**`

package/oxfmt.config.ts

@@ -1,15 +1 @@
-import { defineConfig } from "oxfmt";
-
-export default defineConfig({
-  sortImports: {
-    newlinesBetween: false,
-    groups: [
-      ["value-builtin", "value-external"],
-      ["value-internal", "value-parent", "value-sibling", "value-index"],
-      { newlinesBetween: true },
-      "type-import",
-      "unknown",
-    ],
-  },
-  ignorePatterns: ["worker-configuration.d.ts", "wrangler.jsonc"],
-});
+export { default } from "./oxfmt.config.mjs";

package/oxlint.config.mjs

@@ -53,13 +53,17 @@ export default defineConfig({
     "no-anonymous-default-export": "off",
     "no-continue": "off",
     "init-declarations": "off",
-    "prefer-to-be-truthy": "off",
+    "vitest/prefer-to-be-truthy": "off",
+    "vitest/prefer-to-be-falsy": "off",
     "vitest/prefer-expect-assertions": "off",
     "vitest/prefer-importing-vitest-globals": "off",
     "vitest/no-importing-vitest-globals": "error",
     "vitest/require-top-level-describe": "off",
     "vitest/max-expects": "off",
     "vitest/no-hooks": "off",
+    "unicorn/number-literal-case": "off",
+    "eslint/one-var": "off",
+    "vitest/prefer-called-once": "off",
   },
   overrides: [
     {

package/oxlint.config.ts

@@ -1,90 +1 @@
-import { defineConfig } from "oxlint";
-
-export default defineConfig({
-  plugins: ["eslint", "typescript", "unicorn", "oxc", "import", "promise", "vitest"],
-  options: {
-    typeAware: true,
-  },
-  categories: {
-    correctness: "error",
-    suspicious: "warn",
-    perf: "error",
-    style: "warn",
-  },
-  rules: {
-    "no-map-spread": "off",
-    "no-named-export": "off",
-    "no-magic-numbers": "off",
-    "consistent-indexed-object-style": "off",
-    "id-length": "off",
-    "no-await-expression-member": "off",
-    "max-nested-calls": "off",
-    "sort-keys": "off",
-    curly: "off",
-    "switch-case-braces": "off",
-    "vitest/require-hook": "off",
-    "no-ternary": "off",
-    "group-exports": "off",
-    "exports-last": "off",
-    "prefer-default-export": "off",
-    "no-null": "off",
-    "consistent-type-specifier-style": "off",
-    "max-statements": "off",
-    "consistent-type-imports": "error",
-    "relative-url-style": ["error", "always"],
-    "no-namespace": "off",
-    "no-duplicate-imports": ["error", { allowSeparateTypeImports: true }],
-    "func-style": "off",
-    "sort-imports": [
-      "error",
-      {
-        ignoreDeclarationSort: true,
-        ignoreMemberSort: false,
-      },
-    ],
-    "new-cap": "off",
-    "promise/prefer-await-to-callbacks": "off",
-    "promise/avoid-new": "off",
-    "prefer-await-to-then": "off",
-    "max-params": "off",
-    "no-underscore-dangle": "off",
-    "no-nested-ternary": "off",
-    "unicorn/no-nested-ternary": "off",
-    "no-anonymous-default-export": "off",
-    "no-continue": "off",
-    "init-declarations": "off",
-    "prefer-to-be-truthy": "off",
-    "vitest/prefer-expect-assertions": "off",
-    "vitest/prefer-importing-vitest-globals": "off",
-    "vitest/no-importing-vitest-globals": "error",
-    "vitest/require-top-level-describe": "off",
-    "vitest/max-expects": "off",
-    "vitest/no-hooks": "off",
-  },
-  overrides: [
-    {
-      files: ["*.test.ts", "*.spec.ts"],
-      rules: {
-        "@typescript-eslint/no-explicit-any": "off",
-      },
-    },
-    {
-      files: ["*-definitions.ts"],
-      rules: {
-        "no-unused-vars": "off",
-        "@typescript-eslint/no-redundant-type-constituents": "off",
-        "@typescript-eslint/no-duplicate-type-constituents": "off",
-        "group-exports": "off",
-        "exports-last": "off",
-        "consistent-indexed-object-style": "off",
-      },
-    },
-    {
-      files: ["bin/*.mjs", "src/cmd.mjs"],
-      rules: {
-        "import/no-nodejs-modules": "off",
-        "prefer-destructuring": "off",
-      },
-    },
-  ],
-});
+export { default } from "./oxlint.config.mjs";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "four-stroke",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "Simple Cloudflare Worker SSR SPA framework",
   "license": "MIT",
   "repository": {
@@ -19,17 +19,17 @@
   "type": "module",
   "main": "src/fake.ts",
   "dependencies": {
-    "@types/react": "^19.2.17",
+    "@types/react": "^19.2.18",
     "openapi-typescript": "^7.13.0"
   },
   "devDependencies": {
-    "@cloudflare/vitest-pool-workers": "^0.18.4",
-    "knip": "^6.29.0",
-    "oxfmt": "^0.60.0",
-    "oxlint": "^1.75.0",
+    "@cloudflare/vitest-pool-workers": "^0.22.0",
+    "knip": "^6.32.2",
+    "oxfmt": "^0.64.0",
+    "oxlint": "^1.79.0",
     "oxlint-tsgolint": "^7.0.2001",
     "typescript": "^7.0.2",
-    "vitest": "^4.1.10"
+    "vitest": "^4.1.11"
   },
   "peerDependencies": {
     "@sentry/cli": "^3.6.0",

package/tsconfig.json

@@ -20,5 +20,5 @@
     "verbatimModuleSyntax": true,
     "jsx": "react-jsx"
   },
-  "exclude": ["../../dist"]
+  "exclude": ["../../dist", "oxfmt.config.ts", "oxlint.config.ts"]
 }

package/worker-configuration.d.ts

@@ -1,6 +1,6 @@
 /* eslint-disable */
 // Generated by Wrangler by running `wrangler types` (hash: f0ebc0bbc8852abc1241a56510ca0186)
-// Runtime types generated with workerd@1.20260625.1 2025-09-15 disable_nodejs_fs_module,nodejs_compat
+// Runtime types generated with workerd@1.20260722.1 2025-09-15 disable_nodejs_fs_module,nodejs_compat
 interface __BaseEnv_Env {
 }
 declare namespace Cloudflare {
@@ -523,7 +523,7 @@ declare abstract class DurableObjectNamespace<T extends Rpc.DurableObjectBranded
     getByName(name: string, options?: DurableObjectNamespaceGetDurableObjectOptions): DurableObjectStub<T>;
     jurisdiction(jurisdiction: DurableObjectJurisdiction): DurableObjectNamespace<T>;
 }
-type DurableObjectJurisdiction = "eu" | "fedramp" | "fedramp-high";
+type DurableObjectJurisdiction = "eu" | "fedramp" | "fedramp-high" | "us";
 interface DurableObjectNamespaceNewUniqueIdOptions {
     jurisdiction?: DurableObjectJurisdiction;
 }
@@ -12217,6 +12217,13 @@ interface ForwardableEmailMessage extends EmailMessage {
      * @returns A promise that resolves when the email message is replied.
      */
     reply(message: EmailMessage): Promise<EmailSendResult>;
+    /**
+     * Reply to the sender of this email message with a message built from the given
+     * fields. Threading headers (In-Reply-To/References) are set automatically.
+     * @param builder The reply message contents.
+     * @returns A promise that resolves when the email message is replied.
+     */
+    reply(builder: EmailReplyMessageBuilder): Promise<EmailSendResult>;
 }
 /** A file attachment for an email message */
 type EmailAttachment = {
@@ -12237,23 +12244,46 @@ interface EmailAddress {
     name: string;
     email: string;
 }
+/**
+ * Recipient fields for `SendEmail.send()`. At least one of `to`, `cc`, or
+ * `bcc` must be provided.
+ */
+type EmailDestinations = {
+    to?: string | EmailAddress | (string | EmailAddress)[];
+    cc?: string | EmailAddress | (string | EmailAddress)[];
+    bcc?: string | EmailAddress | (string | EmailAddress)[];
+} & ({
+    to: string | EmailAddress | (string | EmailAddress)[];
+} | {
+    cc: string | EmailAddress | (string | EmailAddress)[];
+} | {
+    bcc: string | EmailAddress | (string | EmailAddress)[];
+});
+/**
+ * Fields shared by all composed emails (no recipients). Used directly by
+ * `ForwardableEmailMessage.reply()`, which always replies to the original
+ * sender, and extended by `EmailMessageBuilder` for `SendEmail.send()`.
+ */
+interface EmailReplyMessageBuilder {
+    from: string | EmailAddress;
+    subject: string;
+    replyTo?: string | EmailAddress;
+    headers?: Record<string, string>;
+    text?: string;
+    html?: string;
+    attachments?: EmailAttachment[];
+}
+/**
+ * Fields for composing an email without constructing raw MIME, for
+ * `SendEmail.send()`. Requires at least one of `to`, `cc`, or `bcc`.
+ */
+type EmailMessageBuilder = EmailReplyMessageBuilder & EmailDestinations;
 /**
  * A binding that allows a Worker to send email messages.
  */
 interface SendEmail {
     send(message: EmailMessage): Promise<EmailSendResult>;
-    send(builder: {
-        from: string | EmailAddress;
-        to: string | EmailAddress | (string | EmailAddress)[];
-        subject: string;
-        replyTo?: string | EmailAddress;
-        cc?: string | EmailAddress | (string | EmailAddress)[];
-        bcc?: string | EmailAddress | (string | EmailAddress)[];
-        headers?: Record<string, string>;
-        text?: string;
-        html?: string;
-        attachments?: EmailAttachment[];
-    }): Promise<EmailSendResult>;
+    send(builder: EmailMessageBuilder): Promise<EmailSendResult>;
 }
 declare abstract class EmailEvent extends ExtendableEvent {
     readonly message: ForwardableEmailMessage;
@@ -13075,6 +13105,11 @@ declare namespace CloudflareWorkersModule {
     export type WorkflowDurationLabel = 'second' | 'minute' | 'hour' | 'day' | 'week' | 'month' | 'year';
     export type WorkflowSleepDuration = `${number} ${WorkflowDurationLabel}${'s' | ''}` | number;
     export type WorkflowDelayDuration = WorkflowSleepDuration;
+    export type WorkflowDynamicDelayContext = {
+        ctx: WorkflowStepContext<WorkflowDelayFunction>;
+        error: Error;
+    };
+    export type WorkflowDelayFunction = (input: WorkflowDynamicDelayContext) => WorkflowDelayDuration | Promise<WorkflowDelayDuration>;
     export type WorkflowTimeoutDuration = WorkflowSleepDuration;
     export type WorkflowRetentionDuration = WorkflowSleepDuration;
     export type WorkflowBackoff = 'constant' | 'linear' | 'exponential';
@@ -13082,7 +13117,7 @@ declare namespace CloudflareWorkersModule {
     export type WorkflowStepConfig = {
         retries?: {
             limit: number;
-            delay: WorkflowDelayDuration | number;
+            delay: WorkflowDelayDuration | number | WorkflowDelayFunction;
             backoff?: WorkflowBackoff;
         };
         timeout?: WorkflowTimeoutDuration | number;
@@ -13108,13 +13143,22 @@ declare namespace CloudflareWorkersModule {
         type: string;
         sensitive?: WorkflowStepSensitivity;
     };
-    export type WorkflowStepContext = {
+    export type WorkflowStepContext<Delay = WorkflowDelayDuration | number> = {
         step: {
             name: string;
             count: number;
         };
         attempt: number;
-        config: WorkflowStepConfig;
+        config: {
+            retries?: {
+                limit: number;
+                backoff?: WorkflowBackoff;
+            } & (Delay extends WorkflowDelayFunction ? {} : {
+                delay: WorkflowDelayDuration | number;
+            });
+            timeout?: WorkflowTimeoutDuration | number;
+            sensitive?: WorkflowStepSensitivity;
+        };
     };
     export type WorkflowRollbackContext<T = unknown> = {
         ctx: WorkflowStepContext;
@@ -13130,7 +13174,9 @@ declare namespace CloudflareWorkersModule {
     };
     export abstract class WorkflowStep {
         do<T extends Rpc.Serializable<T>>(name: string, callback: (ctx: WorkflowStepContext) => Promise<T>, rollbackOptions?: WorkflowStepRollbackOptions<T>): Promise<T>;
-        do<T extends Rpc.Serializable<T>>(name: string, config: WorkflowStepConfig, callback: (ctx: WorkflowStepContext) => Promise<T>, rollbackOptions?: WorkflowStepRollbackOptions<T>): Promise<T>;
+        do<T extends Rpc.Serializable<T>, const C extends WorkflowStepConfig>(name: string, config: C, callback: (ctx: WorkflowStepContext<C['retries'] extends {
+            delay: infer D;
+        } ? D : WorkflowDelayDuration | number>) => Promise<T>, rollbackOptions?: WorkflowStepRollbackOptions<T>): Promise<T>;
         sleep: (name: string, duration: WorkflowSleepDuration) => Promise<void>;
         sleepUntil: (name: string, timestamp: Date | number) => Promise<void>;
         waitForEvent<T extends Rpc.Serializable<T>>(name: string, options: {
@@ -14040,6 +14086,7 @@ declare namespace TailStream {
         readonly dispatchNamespace?: string;
         readonly entrypoint?: string;
         readonly executionModel: string;
+        readonly durableObjectId?: string;
         readonly scriptName?: string;
         readonly scriptTags?: string[];
         readonly scriptVersion?: ScriptVersion;
@@ -14594,6 +14641,13 @@ interface WorkflowError {
     code?: number;
     message: string;
 }
+interface WorkflowInstanceTerminateOptions {
+    /**
+     * If true, run registered rollback handlers before terminating the instance.
+     * Only steps that registered rollback handlers are rolled back.
+     */
+    rollback?: boolean;
+}
 interface WorkflowInstanceRestartOptions {
     /**
      * Restart from a specific step. If omitted, the instance restarts from the beginning.
@@ -14627,8 +14681,9 @@ declare abstract class WorkflowInstance {
     public resume(): Promise<void>;
     /**
      * Terminate the instance. If it is errored, terminated or complete, an error will be thrown.
+     * @param options Options for termination, including whether registered rollback handlers should run.
      */
-    public terminate(): Promise<void>;
+    public terminate(options?: WorkflowInstanceTerminateOptions): Promise<void>;
     /**
      * Restart the instance. Optionally restart from a specific step, preserving
      * cached results for all steps before it.