four-stroke 0.1.3 → 0.2.0

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

@@ -1,7 +1,7 @@
 import { defineConfig } from "oxlint";
 
 export default defineConfig({
-  plugins: ["eslint", "typescript", "unicorn", "oxc", "import", "promise", "vitest"],
+  plugins: ["eslint", "typescript", "unicorn", "oxc", "import", "promise", "vitest", "react"],
   options: {
     typeAware: true,
   },
@@ -53,13 +53,26 @@ 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",
+    "react/react-in-jsx-scope": "off",
+    "react/jsx-max-depth": "off",
+    "react/function-component-definition": [
+      "error",
+      {
+        namedComponents: "arrow-function",
+        unnamedComponents: "arrow-function",
+      },
+    ],
   },
   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.2.0",
   "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.66.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/src/components/viewer-menu.tsx

@@ -5,35 +5,35 @@ interface ViewerMenuProps {
   viewer: Viewer;
 }
 
-export default function ViewerMenu({ logoutUrl, viewer }: ViewerMenuProps): React.ReactNode {
-  return (
-    <details className="group relative">
-      <summary className="flex cursor-pointer list-none items-center gap-3 rounded-md px-2 py-1.5 hover:bg-stone-100 focus:outline-none focus:ring-2 focus:ring-emerald-900 focus:ring-offset-2 [&::-webkit-details-marker]:hidden">
-        {viewer.picture ? (
-          <img
-            alt=""
-            className="size-9 rounded-full object-cover"
-            referrerPolicy="no-referrer"
-            src={viewer.picture}
-          />
-        ) : (
-          <span
-            aria-hidden="true"
-            className="grid size-9 place-items-center rounded-full bg-emerald-950 text-sm font-semibold text-white"
-          >
-            {viewer.name.slice(0, 1).toUpperCase()}
-          </span>
-        )}
-        <span className="max-w-48 truncate text-sm font-medium">{viewer.name}</span>
-      </summary>
-      <nav className="absolute right-0 mt-2 w-40 rounded-md border border-stone-200 bg-white py-1 shadow-lg">
-        <a
-          className="block px-4 py-2 text-sm font-medium text-neutral-700 hover:bg-stone-100 focus:bg-stone-100 focus:outline-none"
-          href={logoutUrl}
+const ViewerMenu = ({ logoutUrl, viewer }: ViewerMenuProps): React.ReactNode => (
+  <details className="group relative">
+    <summary className="flex cursor-pointer list-none items-center gap-3 rounded-md px-2 py-1.5 hover:bg-stone-100 focus:outline-none focus:ring-2 focus:ring-emerald-900 focus:ring-offset-2 [&::-webkit-details-marker]:hidden">
+      {viewer.picture ? (
+        <img
+          alt=""
+          className="size-9 rounded-full object-cover"
+          referrerPolicy="no-referrer"
+          src={viewer.picture}
+        />
+      ) : (
+        <span
+          aria-hidden="true"
+          className="grid size-9 place-items-center rounded-full bg-emerald-950 text-sm font-semibold text-white"
         >
-          Logout
-        </a>
-      </nav>
-    </details>
-  );
-}
+          {viewer.name.slice(0, 1).toUpperCase()}
+        </span>
+      )}
+      <span className="max-w-48 truncate text-sm font-medium">{viewer.name}</span>
+    </summary>
+    <nav className="absolute right-0 mt-2 w-40 rounded-md border border-stone-200 bg-white py-1 shadow-lg">
+      <a
+        className="block px-4 py-2 text-sm font-medium text-neutral-700 hover:bg-stone-100 focus:bg-stone-100 focus:outline-none"
+        href={logoutUrl}
+      >
+        Logout
+      </a>
+    </nav>
+  </details>
+);
+
+export default ViewerMenu;

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.