@homie-rocks/studio 0.58.18 → 0.58.19

package/CHANGELOG.md

@@ -17,6 +17,16 @@ To bring a studio up to date, tell Claude: "Upgrade my studio to the newest Homi
 `npx -y @homie-rocks/studio@latest upgrade`, which shows what's new since the version your studio pins (from this
 file) and what the upgrade would change, and changes nothing until you agree.
 
+## [0.58.19] - 2026-10-21
+
+**Plugin 0.58.13**
+
+A platform that runs a studio's scheduled ticks can use the worker's own cron parser.
+
+### Added
+
+- `@homie-rocks/studio/worker/schedule` exports the worker's own cron parser (`parseSchedule`, `nextDue`, with its types), Cloudflare's five-field UTC dialect, so a platform that runs a dispatch Worker's scheduled ticks schedules them as the studio's Cron Triggers would fire.
+
 ## [0.58.18] - 2026-10-21
 
 **Plugin 0.58.12**

package/lib/template-history.json

@@ -4722,6 +4722,48 @@
      }
     }
    }
+  },
+  "0.58.19": {
+   "files": {
+    "CLAUDE.md": "ddf2b2a0376202f6",
+    "README.md": "684b3cca8001673c",
+    "HANDOFF.md": "29337e2ace95b2e7",
+    "games/README.md": "5ad32fe80c61f117",
+    "music/README.md": "a3dc042dadd39df8",
+    "videos/README.md": "16babc3437d5545b",
+    "posts/README.md": "37841aae476bd540",
+    "site/README.md": "1dbdf22c03a1e505",
+    "site/src/worker.mjs": "6cc5c6131eaf6fd0"
+   },
+   "sections": {
+    "AGENTS.md": {
+     "(intro)": "af7f2f732505d379",
+     "## Version-matched authoring guides": "f6261a0e5801b96b",
+     "## Layout": "f3a280b8c96cd068",
+     "## Apps: one screen, roles and parts": "c10aa0441ea89702",
+     "## Commands (all through the pinned CLI in node_modules)": "c20d90de21cde0c7",
+     "## The site": "0cb8dd9a6f8a0096",
+     "## Making games": "bb715272fd1a615b",
+     "## The Game Codex and progress": "0738ef719cef3a4c",
+     "## Art direction and models": "a48fff7bf0a5f2fc",
+     "## Running live games (the back office)": "51ebf2ab756f6e4d",
+     "## Servers and AI seats": "1ccfd549d2369a60",
+     "## Selling things (the shop)": "0df5a5fe1833c624",
+     "## Continuing a build from the Claude app": "0d68081e924ca419",
+     "## Rules": "b2234d80f6cbe71d",
+     "## Telling Homie": "80b46fdd9e578db8",
+     "## Beta": "9d02638207a26e73"
+    }
+   },
+   "named": {
+    "Homie Arcade": {
+     "sections": {
+      "AGENTS.md": {
+       "## Commands (all through the pinned CLI in node_modules)": "8364e05cebefcba4"
+      }
+     }
+    }
+   }
   }
  }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@homie-rocks/studio",
-  "version": "0.58.18",
+  "version": "0.58.19",
   "description": "A studio for games, music and video on its own Cloudflare: scaffold, multiplayer starters on the netplay contract, a port toolkit that makes existing single-player web games multiplayer, the site Worker with public rooms (Table/Lobby Durable Objects and D1, all on the free Workers plan, no payment method), a site with the hub's sections (Home, Games, Music, Videos, Rooms, Posts with feeds) in the studio's own look, an epic landing page for every game, big songs and videos in the studio's own R2 once it has storage (uploaded, checked by SHA-256, served at the same addresses), deploy, and the homie.rocks directory.",
   "type": "module",
   "license": "Apache-2.0",
@@ -85,6 +85,10 @@
       "default": "./apps/apps.ts"
     },
     "./worker/selling": "./worker/selling/index.mjs",
+    "./worker/schedule": {
+      "types": "./worker/function-schedule.d.ts",
+      "default": "./worker/function-schedule.mjs"
+    },
     "./tools": {
       "types": "./tools/tools.ts",
       "default": "./tools/tools.ts"

package/worker/build-id.mjs

@@ -1,2 +1,2 @@
 // Generated by lib/build-identity.mjs; identifies the bundled runtime sources.
-export const STUDIO_BUILD = Object.freeze({"version":"0.58.18","sha256":"333254a4a029de3f655b1689480b580903801f14cc0d9e6ea99f2bac4b9e5c7f"});
+export const STUDIO_BUILD = Object.freeze({"version":"0.58.19","sha256":"fa06dab84c72f3a1707fb037047a67228f8d74f19a31dc3f913833f9373b5327"});

package/worker/function-schedule.d.ts

@@ -0,0 +1,14 @@
+/** A five-field Cloudflare cron expression in UTC (Sunday = 1), parsed. */
+export interface Schedule {
+  parts: string[];
+  fields: {values: number[]; special: string[]}[];
+  dayMatches(date: Date): boolean;
+  /** Whether the expression is due at this time (its UTC minute). */
+  matches(time: number): boolean;
+}
+/** Parse a cron expression; throws on one Cloudflare would refuse. */
+export function parseSchedule(expression: string): Schedule;
+/** The first time after `after` the expression is due, or null when it never is. */
+export function nextDue(expression: string | Schedule, after?: number): number | null;
+export function scheduleTrigger(definitions: {schedule?: string}[], options?: {eventFeeds?: boolean}): string | null;
+export function scheduleStatus(definitions: {name: string; schedule?: string}[], crons: string[], now?: number): {function: string; schedule: string; nextDue: string | null; status: string}[];

package/worker/version.mjs

@@ -1,2 +1,2 @@
 /** The @homie-rocks/studio version this Worker code is (package.json's; a test keeps them equal). Cache-busts /_homie/site.js. */
-export const STUDIO_VERSION_TAG = '0.58.18';
+export const STUDIO_VERSION_TAG = '0.58.19';