@ts-cloud/core 0.16.41 → 0.16.43

package/dist/types.d.ts

@@ -584,6 +584,28 @@ export interface InfrastructureConfig {
      * }
      */
     r2?: R2Config;
+    /**
+     * Cloudflare Workers, bundled with `Bun.build` and uploaded through
+     * Cloudflare's account API on `cloud deploy` (see `reconcileCloudflareWorkers`).
+     *
+     * Keyed by a logical name; `name` is the script name in Cloudflare. Like
+     * `r2`, nothing here touches AWS, and the deploy needs `CLOUDFLARE_API_TOKEN`
+     * and `CLOUDFLARE_ACCOUNT_ID` in the env.
+     *
+     * @example
+     * workers: {
+     *   tiles: {
+     *     name: 'my-app-tiles',
+     *     entry: 'workers/tiles.ts',
+     *     bindings: {
+     *       r2Buckets: { TILES: 'my-app-tiles' },
+     *       vars: { CACHE_SECONDS: '86400' },
+     *     },
+     *     customDomains: ['tiles.example.com'],
+     *   },
+     * }
+     */
+    workers?: Record<string, WorkerConfig>;
     security?: SecurityConfig;
     monitoring?: MonitoringConfig;
     api?: ApiConfig;
@@ -1928,6 +1950,16 @@ export interface DnsZoneConfig {
      * reported rather than failing the deploy.
      */
     minTlsVersion?: '1.0' | '1.1' | '1.2' | '1.3';
+    /**
+     * Tiered cache: a data center that misses asks an upper-tier data center
+     * before the origin, so the origin answers once per region rather than once
+     * per city. `smart` lets Cloudflare choose the upper tier by latency to the
+     * origin; `generic` uses a fixed set; `off` turns it off. Free on every plan.
+     * It applies to everything Cloudflare caches through the CDN, including a
+     * Worker's `fetch()` subrequests, but not to a Worker's Cache API, which is
+     * local to one data center.
+     */
+    tieredCache?: 'smart' | 'generic' | 'off';
 }
 /**
  * The registrar half of {@link DnsConfig}.
@@ -2289,6 +2321,40 @@ export interface R2Config {
     /** Buckets keyed by a logical name (the key is not the bucket name; `name` is). */
     buckets: Record<string, R2BucketConfig>;
 }
+/** Bindings a Worker is uploaded with. Secrets are not declared here; see {@link WorkerConfig}. */
+export interface WorkerBindingsConfig {
+    /** R2 buckets, keyed by the binding name the Worker reads (`env.TILES`) with the bucket name as the value. */
+    r2Buckets?: Record<string, string>;
+    /** Plain-text environment variables, keyed by binding name. Visible in the dashboard; not for secrets. */
+    vars?: Record<string, string>;
+}
+/**
+ * One Cloudflare Worker (an ES module Worker), deployed from a TypeScript or
+ * JavaScript entry that is bundled into a single module.
+ *
+ * Secrets set out of band (`wrangler secret put`, the dashboard) survive a
+ * deploy: the upload keeps existing `secret_text` bindings rather than
+ * replacing them.
+ */
+export interface WorkerConfig {
+    /** Script name in Cloudflare (lowercase letters, digits, `-` and `_`, up to 63 chars). */
+    name: string;
+    /** Entry module, relative to the project root, e.g. `workers/tiles.ts`. */
+    entry: string;
+    /** Workers runtime compatibility date. @default '2025-09-01' */
+    compatibilityDate?: string;
+    /** Workers runtime compatibility flags, e.g. `['nodejs_compat']`. */
+    compatibilityFlags?: string[];
+    bindings?: WorkerBindingsConfig;
+    /**
+     * Hostnames the Worker serves as Workers Custom Domains. Cloudflare creates
+     * the DNS record and certificate itself, so a hostname must not already have
+     * a DNS record or be attached to an R2 bucket or another Worker: the deploy
+     * warns and leaves it alone rather than detaching anything. Attached, never
+     * detached: removing a hostname from config leaves it attached.
+     */
+    customDomains?: string[];
+}
 export interface StorageItemConfig {
     /**
      * Physical S3 bucket name. When omitted, defaults to `{slug}-{environment}-{key}`.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ts-cloud/core",
   "type": "module",
-  "version": "0.16.41",
+  "version": "0.16.43",
   "description": "Core CloudFormation generation library for ts-cloud",
   "author": "Chris Breuer <chris@stacksjs.com>",
   "license": "MIT",
@@ -31,7 +31,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@ts-cloud/aws-types": "0.16.41"
+    "@ts-cloud/aws-types": "0.16.43"
   },
   "devDependencies": {
     "typescript": "^7.0.2"