@geekmidas/manifest 9.2.0 → 9.3.0

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["field: ManifestField<T> | undefined"],"sources":["../src/index.ts"],"sourcesContent":["/**\n * Deployment manifest types — the build output of `gkm build` that enumerates a\n * project's deployable units (routes, functions, crons, subscribers, queues)\n * with the metadata an infrastructure layer needs to provision them.\n *\n * `gkm build` writes a single TypeScript module per provider\n * (`<out>/manifest/aws.ts`) of the form:\n *\n * ```ts\n * export const manifest = { routes: [...], functions: [...], ... } as const;\n * export type Route = (typeof manifest.routes)[number];\n * // ...derived types\n * ```\n *\n * This is the dependency-free data contract shared between the producer\n * (`@geekmidas/cli`) and consumers (e.g. `@geekmidas/cloud/sst`'s `fromManifest`\n * integrators).\n */\n\n/**\n * A manifest field is either a flat list or, when the build is partitioned\n * (e.g. by authorizer), an object keyed by partition name. Readonly-tolerant so\n * the `as const` generated manifest assigns cleanly.\n */\nexport type ManifestField<T> =\n\t| readonly T[]\n\t| Readonly<Record<string, readonly T[]>>;\n\n/** Flatten a manifest field (array or partitioned) into a plain array. */\nexport function flattenManifestField<T>(\n\tfield: ManifestField<T> | undefined,\n): T[] {\n\tif (!field) return [];\n\treturn Array.isArray(field)\n\t\t? [...field]\n\t\t: Object.values(field as Record<string, readonly T[]>).flat();\n}\n\n/**\n * A monitor set with `.monitor()`, so infrastructure can provision what it\n * reports to, e.g. create a heartbeat and set its URL in `env`.\n */\nexport interface MonitorInfo {\n\t/** The kind of monitor, e.g. `heartbeat`. */\n\ttype: string;\n\t/** The service it reports to, e.g. `betterStack`. Absent for a custom one. */\n\tprovider?: string;\n\t/** The environment variable it reads its target from. */\n\tenv?: string;\n}\n\n/** A single HTTP route. */\nexport interface RouteInfo {\n\t/** Route path, e.g. `/users/{id}`. */\n\tpath: string;\n\t/** HTTP method, e.g. `GET`. */\n\tmethod: string;\n\t/** Bundled handler entrypoint. */\n\thandler: string;\n\ttimeout?: number;\n\tmemorySize?: number;\n\t/** Required environment variables (a trailing `?` marks an optional var). */\n\tenvironment?: readonly string[];\n\t/** Authorizer name: `none`, `iam`, or a declared authorizer. */\n\tauthorizer: string;\n\t/** Monitors set with `.monitor()`; absent when there are none. */\n\tmonitoring?: readonly MonitorInfo[];\n}\n\n/** A standalone Lambda function. */\nexport interface FunctionInfo {\n\tname: string;\n\thandler: string;\n\ttimeout?: number;\n\tmemorySize?: number;\n\tenvironment?: readonly string[];\n\t/** Monitors set with `.monitor()`; absent when there are none. */\n\tmonitoring?: readonly MonitorInfo[];\n}\n\n/** A scheduled (cron) function. */\nexport interface CronInfo {\n\tname: string;\n\thandler: string;\n\t/** Schedule expression, e.g. `rate(1 day)` or `cron(0 12 * * ? *)`. */\n\tschedule: string;\n\ttimeout?: number;\n\tmemorySize?: number;\n\tenvironment?: readonly string[];\n\t/** Monitors set with `.monitor()`; absent when there are none. */\n\tmonitoring?: readonly MonitorInfo[];\n}\n\n/** An event subscriber function (topic/queue resolved by `transport`). */\nexport interface SubscriberInfo {\n\tname: string;\n\thandler: string;\n\tsubscribedEvents: readonly string[];\n\t/** Delivery transport — `topic` (SNS fan-out) or `queue` (SQS). */\n\ttransport?: 'topic' | 'queue';\n\t/** The {@link TopicInfo.name} this subscriber binds to (via `s.topic(topic)`). */\n\ttopic?: string;\n\ttimeout?: number;\n\tmemorySize?: number;\n\tenvironment?: readonly string[];\n}\n\n/**\n * A pub/sub topic — fan-out. A *resource* (no handler): it declares the event\n * contract; producers publish via the derived publisher and {@link SubscriberInfo}s\n * bind to it. Infra provisions an SNS topic.\n */\nexport interface TopicInfo {\n\tname: string;\n\t/** The event type names this topic carries. */\n\tevents: readonly string[];\n\t/** Whether the topic is FIFO. */\n\tfifo?: boolean;\n}\n\n/** A queue worker — a queue and its single consumer. */\nexport interface QueueInfo {\n\tname: string;\n\thandler: string;\n\t/** SQS event-source batch size. */\n\tbatchSize?: number;\n\t/** Whether the queue is FIFO. */\n\tfifo?: boolean;\n\ttimeout?: number;\n\tmemorySize?: number;\n\tenvironment?: readonly string[];\n}\n\n/**\n * The full deployment manifest — the shape of `export const manifest` in a\n * generated `manifest/<provider>.ts`. Each field is a {@link ManifestField}\n * (flat or partitioned).\n */\nexport interface Manifest {\n\troutes: ManifestField<RouteInfo>;\n\tfunctions?: ManifestField<FunctionInfo>;\n\tcrons?: ManifestField<CronInfo>;\n\tsubscribers?: ManifestField<SubscriberInfo>;\n\tqueues?: ManifestField<QueueInfo>;\n\ttopics?: ManifestField<TopicInfo>;\n}\n"],"mappings":";;;AA6BA,SAAgB,qBACfA,OACM;AACN,MAAK,MAAO,QAAO,CAAE;AACrB,QAAO,MAAM,QAAQ,MAAM,GACxB,CAAC,GAAG,KAAM,IACV,OAAO,OAAO,MAAsC,CAAC,MAAM;AAC9D"}
+{"version":3,"file":"index.cjs","names":["field: ManifestField<T> | undefined"],"sources":["../src/index.ts"],"sourcesContent":["/**\n * Deployment manifest types — the build output of `gkm build` that enumerates a\n * project's deployable units (routes, functions, crons, subscribers, queues)\n * with the metadata an infrastructure layer needs to provision them.\n *\n * `gkm build` writes a single TypeScript module per provider\n * (`<out>/manifest/aws.ts`) of the form:\n *\n * ```ts\n * export const manifest = { routes: [...], functions: [...], ... } as const;\n * export type Route = (typeof manifest.routes)[number];\n * // ...derived types\n * ```\n *\n * This is the dependency-free data contract shared between the producer\n * (`@geekmidas/cli`) and consumers (e.g. `@geekmidas/cloud/sst`'s `fromManifest`\n * integrators).\n */\n\n/**\n * A manifest field is either a flat list or, when the build is partitioned\n * (e.g. by authorizer), an object keyed by partition name. Readonly-tolerant so\n * the `as const` generated manifest assigns cleanly.\n */\nexport type ManifestField<T> =\n\t| readonly T[]\n\t| Readonly<Record<string, readonly T[]>>;\n\n/** Flatten a manifest field (array or partitioned) into a plain array. */\nexport function flattenManifestField<T>(\n\tfield: ManifestField<T> | undefined,\n): T[] {\n\tif (!field) return [];\n\treturn Array.isArray(field)\n\t\t? [...field]\n\t\t: Object.values(field as Record<string, readonly T[]>).flat();\n}\n\n/**\n * A monitor set with `.monitor()`, so infrastructure can provision what it\n * reports to, e.g. create a heartbeat and set its URL in `env`.\n */\nexport interface MonitorInfo {\n\t/** The kind of monitor, e.g. `heartbeat`. */\n\ttype: string;\n\t/** The service it reports to, e.g. `betterStack`. Absent for a custom one. */\n\tprovider?: string;\n\t/** The environment variable it reads its target from. */\n\tenv?: string;\n}\n\n/** A single HTTP route. */\nexport interface RouteInfo {\n\t/** Route path, e.g. `/users/{id}`. */\n\tpath: string;\n\t/** HTTP method, e.g. `GET`. */\n\tmethod: string;\n\t/** Bundled handler entrypoint. */\n\thandler: string;\n\ttimeout?: number;\n\tmemorySize?: number;\n\t/** Required environment variables (a trailing `?` marks an optional var). */\n\tenvironment?: readonly string[];\n\t/** Authorizer name: `none`, `iam`, or a declared authorizer. */\n\tauthorizer: string;\n\t/** Monitors set with `.monitor()`; absent when there are none. */\n\tmonitoring?: readonly MonitorInfo[];\n}\n\n/** A standalone Lambda function. */\nexport interface FunctionInfo {\n\tname: string;\n\thandler: string;\n\ttimeout?: number;\n\tmemorySize?: number;\n\tenvironment?: readonly string[];\n\t/** Monitors set with `.monitor()`; absent when there are none. */\n\tmonitoring?: readonly MonitorInfo[];\n}\n\n/** A scheduled (cron) function. */\nexport interface CronInfo {\n\tname: string;\n\thandler: string;\n\t/** Schedule expression, e.g. `rate(1 day)` or `cron(0 12 * * ? *)`. */\n\tschedule: string;\n\ttimeout?: number;\n\tmemorySize?: number;\n\tenvironment?: readonly string[];\n\t/** Monitors set with `.monitor()`; absent when there are none. */\n\tmonitoring?: readonly MonitorInfo[];\n}\n\n/** An event subscriber function (topic/queue resolved by `transport`). */\nexport interface SubscriberInfo {\n\tname: string;\n\thandler: string;\n\tsubscribedEvents: readonly string[];\n\t/** Delivery transport — `topic` (SNS fan-out) or `queue` (SQS). */\n\ttransport?: 'topic' | 'queue';\n\t/** The {@link TopicInfo.name} this subscriber binds to (via `s.topic(topic)`). */\n\ttopic?: string;\n\ttimeout?: number;\n\tmemorySize?: number;\n\tenvironment?: readonly string[];\n}\n\n/**\n * A pub/sub topic — fan-out. A *resource* (no handler): it declares the event\n * contract; producers publish via the derived publisher and {@link SubscriberInfo}s\n * bind to it. Infra provisions an SNS topic.\n */\nexport interface TopicInfo {\n\tname: string;\n\t/** The event type names this topic carries. */\n\tevents: readonly string[];\n\t/** Whether the topic is FIFO. */\n\tfifo?: boolean;\n}\n\n/** A queue worker — a queue and its single consumer. */\nexport interface QueueInfo {\n\tname: string;\n\thandler: string;\n\t/** SQS event-source batch size. */\n\tbatchSize?: number;\n\t/** Whether the queue is FIFO. */\n\tfifo?: boolean;\n\ttimeout?: number;\n\tmemorySize?: number;\n\tenvironment?: readonly string[];\n}\n\n/**\n * The full deployment manifest — the shape of `export const manifest` in a\n * generated `manifest/<provider>.ts`. Each field is a {@link ManifestField}\n * (flat or partitioned).\n */\nexport interface Manifest {\n\troutes: ManifestField<RouteInfo>;\n\tfunctions?: ManifestField<FunctionInfo>;\n\tcrons?: ManifestField<CronInfo>;\n\tsubscribers?: ManifestField<SubscriberInfo>;\n\tqueues?: ManifestField<QueueInfo>;\n\ttopics?: ManifestField<TopicInfo>;\n}\n\nexport * from './cron';\n"],"mappings":";;;;AA6BA,SAAgB,qBACfA,OACM;AACN,MAAK,MAAO,QAAO,CAAE;AACrB,QAAO,MAAM,QAAQ,MAAM,GACxB,CAAC,GAAG,KAAM,IACV,OAAO,OAAO,MAAsC,CAAC,MAAM;AAC9D"}

package/dist/index.d.cts

@@ -1,4 +1,7 @@
+import { CronConversion, CronConversionWarning, CronDialect, CronField, CronPeriodError, InvalidCronExpressionError, ParsedCron, UnconvertibleCronExpressionError, cronPeriod, parseCron, toAwsCron, toUnixCron } from "./cron-CjhmidCo.cjs";
+
 //#region src/index.d.ts
+
 /**
  * Deployment manifest types — the build output of `gkm build` that enumerates a
  * project's deployable units (routes, functions, crons, subscribers, queues)
@@ -126,7 +129,6 @@ interface Manifest {
   queues?: ManifestField<QueueInfo>;
   topics?: ManifestField<TopicInfo>;
 }
-//# sourceMappingURL=index.d.ts.map
 //#endregion
-export { CronInfo, FunctionInfo, Manifest, ManifestField, MonitorInfo, QueueInfo, RouteInfo, SubscriberInfo, TopicInfo, flattenManifestField };
+export { CronConversion, CronConversionWarning, CronDialect, CronField, CronInfo, CronPeriodError, FunctionInfo, InvalidCronExpressionError, Manifest, ManifestField, MonitorInfo, ParsedCron, QueueInfo, RouteInfo, SubscriberInfo, TopicInfo, UnconvertibleCronExpressionError, cronPeriod, flattenManifestField, parseCron, toAwsCron, toUnixCron };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/index.ts"],"sourcesContent":[],"mappings":";;AAwBA;;;;;;AAEW;AAGX;;;;;AAEI;AAWJ;AAUA;AAkBA;AAWA;AAaA;AAkBA;AASA;AAiBA;;AACuB,KAnHX,aAmHW,CAAA,CAAA,CAAA,GAAA,SAlHX,CAkHW,EAAA,GAjHpB,QAiHoB,CAjHX,MAiHW,CAAA,MAAA,EAAA,SAjHa,CAiHb,EAAA,CAAA,CAAA;;AACI,iBA/GX,oBA+GW,CAAA,CAAA,CAAA,CAAA,KAAA,EA9GnB,aA8GmB,CA9GL,CA8GK,CAAA,GAAA,SAAA,CAAA,EA7GxB,CA6GwB,EAAA;;;;;AAEZ,UApGE,WAAA,CAoGF;EAAa;EACK,IAAvB,EAAA,MAAA;EAAa;EACU,QAAvB,CAAA,EAAA,MAAA;EAAa;;;;UA5FN,SAAA;;;;;;;;;;;;;;wBAcM;;;UAIN,YAAA;;;;;;;wBAOM;;;UAIN,QAAA;;;;;;;;;wBASM;;;UAIN,cAAA;;;;;;;;;;;;;;;;;UAkBA,SAAA;;;;;;;;UASA,SAAA;;;;;;;;;;;;;;;;UAiBA,QAAA;UACR,cAAc;cACV,cAAc;UAClB,cAAc;gBACR,cAAc;WACnB,cAAc;WACd,cAAc"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/index.ts"],"sourcesContent":[],"mappings":";;;;;;;AAwBA;;;;;;AAEW;AAGX;;;;;AAEI;AAWJ;AAUA;AAkBA;AAWA;AAaA;AAkBA;AASA;AAiBiB,KAlHL,aAkHa,CAAA,CAAA,CAAA,GAAA,SAjHb,CAiHa,EAAA,GAhHtB,QAgHsB,CAhHb,MAgHa,CAAA,MAAA,EAAA,SAhHW,CAgHX,EAAA,CAAA,CAAA;;AACF,iBA9GP,oBA8GO,CAAA,CAAA,CAAA,CAAA,KAAA,EA7Gf,aA6Ge,CA7GD,CA6GC,CAAA,GAAA,SAAA,CAAA,EA5GpB,CA4GoB,EAAA;;;;;AAEd,UAnGQ,WAAA,CAmGR;EAAa;EACqB,IAA5B,EAAA,MAAA;EAAa;EACK,QAAvB,CAAA,EAAA,MAAA;EAAa;EACU,GAAvB,CAAA,EAAA,MAAA;AAAa;;UA5FN,SAAA;;;;;;;;;;;;;;wBAcM;;;UAIN,YAAA;;;;;;;wBAOM;;;UAIN,QAAA;;;;;;;;;wBASM;;;UAIN,cAAA;;;;;;;;;;;;;;;;;UAkBA,SAAA;;;;;;;;UASA,SAAA;;;;;;;;;;;;;;;;UAiBA,QAAA;UACR,cAAc;cACV,cAAc;UAClB,cAAc;gBACR,cAAc;WACnB,cAAc;WACd,cAAc"}

package/dist/index.d.mts

@@ -1,4 +1,7 @@
+import { CronConversion, CronConversionWarning, CronDialect, CronField, CronPeriodError, InvalidCronExpressionError, ParsedCron, UnconvertibleCronExpressionError, cronPeriod, parseCron, toAwsCron, toUnixCron } from "./cron-DlCX5PWN.mjs";
+
 //#region src/index.d.ts
+
 /**
  * Deployment manifest types — the build output of `gkm build` that enumerates a
  * project's deployable units (routes, functions, crons, subscribers, queues)
@@ -126,7 +129,6 @@ interface Manifest {
   queues?: ManifestField<QueueInfo>;
   topics?: ManifestField<TopicInfo>;
 }
-//# sourceMappingURL=index.d.ts.map
 //#endregion
-export { CronInfo, FunctionInfo, Manifest, ManifestField, MonitorInfo, QueueInfo, RouteInfo, SubscriberInfo, TopicInfo, flattenManifestField };
+export { CronConversion, CronConversionWarning, CronDialect, CronField, CronInfo, CronPeriodError, FunctionInfo, InvalidCronExpressionError, Manifest, ManifestField, MonitorInfo, ParsedCron, QueueInfo, RouteInfo, SubscriberInfo, TopicInfo, UnconvertibleCronExpressionError, cronPeriod, flattenManifestField, parseCron, toAwsCron, toUnixCron };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"sourcesContent":[],"mappings":";;AAwBA;;;;;;AAEW;AAGX;;;;;AAEI;AAWJ;AAUA;AAkBA;AAWA;AAaA;AAkBA;AASA;AAiBA;;AACuB,KAnHX,aAmHW,CAAA,CAAA,CAAA,GAAA,SAlHX,CAkHW,EAAA,GAjHpB,QAiHoB,CAjHX,MAiHW,CAAA,MAAA,EAAA,SAjHa,CAiHb,EAAA,CAAA,CAAA;;AACI,iBA/GX,oBA+GW,CAAA,CAAA,CAAA,CAAA,KAAA,EA9GnB,aA8GmB,CA9GL,CA8GK,CAAA,GAAA,SAAA,CAAA,EA7GxB,CA6GwB,EAAA;;;;;AAEZ,UApGE,WAAA,CAoGF;EAAa;EACK,IAAvB,EAAA,MAAA;EAAa;EACU,QAAvB,CAAA,EAAA,MAAA;EAAa;;;;UA5FN,SAAA;;;;;;;;;;;;;;wBAcM;;;UAIN,YAAA;;;;;;;wBAOM;;;UAIN,QAAA;;;;;;;;;wBASM;;;UAIN,cAAA;;;;;;;;;;;;;;;;;UAkBA,SAAA;;;;;;;;UASA,SAAA;;;;;;;;;;;;;;;;UAiBA,QAAA;UACR,cAAc;cACV,cAAc;UAClB,cAAc;gBACR,cAAc;WACnB,cAAc;WACd,cAAc"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"sourcesContent":[],"mappings":";;;;;;;AAwBA;;;;;;AAEW;AAGX;;;;;AAEI;AAWJ;AAUA;AAkBA;AAWA;AAaA;AAkBA;AASA;AAiBiB,KAlHL,aAkHa,CAAA,CAAA,CAAA,GAAA,SAjHb,CAiHa,EAAA,GAhHtB,QAgHsB,CAhHb,MAgHa,CAAA,MAAA,EAAA,SAhHW,CAgHX,EAAA,CAAA,CAAA;;AACF,iBA9GP,oBA8GO,CAAA,CAAA,CAAA,CAAA,KAAA,EA7Gf,aA6Ge,CA7GD,CA6GC,CAAA,GAAA,SAAA,CAAA,EA5GpB,CA4GoB,EAAA;;;;;AAEd,UAnGQ,WAAA,CAmGR;EAAa;EACqB,IAA5B,EAAA,MAAA;EAAa;EACK,QAAvB,CAAA,EAAA,MAAA;EAAa;EACU,GAAvB,CAAA,EAAA,MAAA;AAAa;;UA5FN,SAAA;;;;;;;;;;;;;;wBAcM;;;UAIN,YAAA;;;;;;;wBAOM;;;UAIN,QAAA;;;;;;;;;wBASM;;;UAIN,cAAA;;;;;;;;;;;;;;;;;UAkBA,SAAA;;;;;;;;UASA,SAAA;;;;;;;;;;;;;;;;UAiBA,QAAA;UACR,cAAc;cACV,cAAc;UAClB,cAAc;gBACR,cAAc;WACnB,cAAc;WACd,cAAc"}

package/dist/index.mjs

@@ -1,3 +1,5 @@
+import { CronPeriodError, InvalidCronExpressionError, UnconvertibleCronExpressionError, cronPeriod, parseCron, toAwsCron, toUnixCron } from "./cron-DC4hQ1oa.mjs";
+
 //#region src/index.ts
 /** Flatten a manifest field (array or partitioned) into a plain array. */
 function flattenManifestField(field) {
@@ -6,5 +8,5 @@ function flattenManifestField(field) {
 }
 
 //#endregion
-export { flattenManifestField };
+export { CronPeriodError, InvalidCronExpressionError, UnconvertibleCronExpressionError, cronPeriod, flattenManifestField, parseCron, toAwsCron, toUnixCron };
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["field: ManifestField<T> | undefined"],"sources":["../src/index.ts"],"sourcesContent":["/**\n * Deployment manifest types — the build output of `gkm build` that enumerates a\n * project's deployable units (routes, functions, crons, subscribers, queues)\n * with the metadata an infrastructure layer needs to provision them.\n *\n * `gkm build` writes a single TypeScript module per provider\n * (`<out>/manifest/aws.ts`) of the form:\n *\n * ```ts\n * export const manifest = { routes: [...], functions: [...], ... } as const;\n * export type Route = (typeof manifest.routes)[number];\n * // ...derived types\n * ```\n *\n * This is the dependency-free data contract shared between the producer\n * (`@geekmidas/cli`) and consumers (e.g. `@geekmidas/cloud/sst`'s `fromManifest`\n * integrators).\n */\n\n/**\n * A manifest field is either a flat list or, when the build is partitioned\n * (e.g. by authorizer), an object keyed by partition name. Readonly-tolerant so\n * the `as const` generated manifest assigns cleanly.\n */\nexport type ManifestField<T> =\n\t| readonly T[]\n\t| Readonly<Record<string, readonly T[]>>;\n\n/** Flatten a manifest field (array or partitioned) into a plain array. */\nexport function flattenManifestField<T>(\n\tfield: ManifestField<T> | undefined,\n): T[] {\n\tif (!field) return [];\n\treturn Array.isArray(field)\n\t\t? [...field]\n\t\t: Object.values(field as Record<string, readonly T[]>).flat();\n}\n\n/**\n * A monitor set with `.monitor()`, so infrastructure can provision what it\n * reports to, e.g. create a heartbeat and set its URL in `env`.\n */\nexport interface MonitorInfo {\n\t/** The kind of monitor, e.g. `heartbeat`. */\n\ttype: string;\n\t/** The service it reports to, e.g. `betterStack`. Absent for a custom one. */\n\tprovider?: string;\n\t/** The environment variable it reads its target from. */\n\tenv?: string;\n}\n\n/** A single HTTP route. */\nexport interface RouteInfo {\n\t/** Route path, e.g. `/users/{id}`. */\n\tpath: string;\n\t/** HTTP method, e.g. `GET`. */\n\tmethod: string;\n\t/** Bundled handler entrypoint. */\n\thandler: string;\n\ttimeout?: number;\n\tmemorySize?: number;\n\t/** Required environment variables (a trailing `?` marks an optional var). */\n\tenvironment?: readonly string[];\n\t/** Authorizer name: `none`, `iam`, or a declared authorizer. */\n\tauthorizer: string;\n\t/** Monitors set with `.monitor()`; absent when there are none. */\n\tmonitoring?: readonly MonitorInfo[];\n}\n\n/** A standalone Lambda function. */\nexport interface FunctionInfo {\n\tname: string;\n\thandler: string;\n\ttimeout?: number;\n\tmemorySize?: number;\n\tenvironment?: readonly string[];\n\t/** Monitors set with `.monitor()`; absent when there are none. */\n\tmonitoring?: readonly MonitorInfo[];\n}\n\n/** A scheduled (cron) function. */\nexport interface CronInfo {\n\tname: string;\n\thandler: string;\n\t/** Schedule expression, e.g. `rate(1 day)` or `cron(0 12 * * ? *)`. */\n\tschedule: string;\n\ttimeout?: number;\n\tmemorySize?: number;\n\tenvironment?: readonly string[];\n\t/** Monitors set with `.monitor()`; absent when there are none. */\n\tmonitoring?: readonly MonitorInfo[];\n}\n\n/** An event subscriber function (topic/queue resolved by `transport`). */\nexport interface SubscriberInfo {\n\tname: string;\n\thandler: string;\n\tsubscribedEvents: readonly string[];\n\t/** Delivery transport — `topic` (SNS fan-out) or `queue` (SQS). */\n\ttransport?: 'topic' | 'queue';\n\t/** The {@link TopicInfo.name} this subscriber binds to (via `s.topic(topic)`). */\n\ttopic?: string;\n\ttimeout?: number;\n\tmemorySize?: number;\n\tenvironment?: readonly string[];\n}\n\n/**\n * A pub/sub topic — fan-out. A *resource* (no handler): it declares the event\n * contract; producers publish via the derived publisher and {@link SubscriberInfo}s\n * bind to it. Infra provisions an SNS topic.\n */\nexport interface TopicInfo {\n\tname: string;\n\t/** The event type names this topic carries. */\n\tevents: readonly string[];\n\t/** Whether the topic is FIFO. */\n\tfifo?: boolean;\n}\n\n/** A queue worker — a queue and its single consumer. */\nexport interface QueueInfo {\n\tname: string;\n\thandler: string;\n\t/** SQS event-source batch size. */\n\tbatchSize?: number;\n\t/** Whether the queue is FIFO. */\n\tfifo?: boolean;\n\ttimeout?: number;\n\tmemorySize?: number;\n\tenvironment?: readonly string[];\n}\n\n/**\n * The full deployment manifest — the shape of `export const manifest` in a\n * generated `manifest/<provider>.ts`. Each field is a {@link ManifestField}\n * (flat or partitioned).\n */\nexport interface Manifest {\n\troutes: ManifestField<RouteInfo>;\n\tfunctions?: ManifestField<FunctionInfo>;\n\tcrons?: ManifestField<CronInfo>;\n\tsubscribers?: ManifestField<SubscriberInfo>;\n\tqueues?: ManifestField<QueueInfo>;\n\ttopics?: ManifestField<TopicInfo>;\n}\n"],"mappings":";;AA6BA,SAAgB,qBACfA,OACM;AACN,MAAK,MAAO,QAAO,CAAE;AACrB,QAAO,MAAM,QAAQ,MAAM,GACxB,CAAC,GAAG,KAAM,IACV,OAAO,OAAO,MAAsC,CAAC,MAAM;AAC9D"}
+{"version":3,"file":"index.mjs","names":["field: ManifestField<T> | undefined"],"sources":["../src/index.ts"],"sourcesContent":["/**\n * Deployment manifest types — the build output of `gkm build` that enumerates a\n * project's deployable units (routes, functions, crons, subscribers, queues)\n * with the metadata an infrastructure layer needs to provision them.\n *\n * `gkm build` writes a single TypeScript module per provider\n * (`<out>/manifest/aws.ts`) of the form:\n *\n * ```ts\n * export const manifest = { routes: [...], functions: [...], ... } as const;\n * export type Route = (typeof manifest.routes)[number];\n * // ...derived types\n * ```\n *\n * This is the dependency-free data contract shared between the producer\n * (`@geekmidas/cli`) and consumers (e.g. `@geekmidas/cloud/sst`'s `fromManifest`\n * integrators).\n */\n\n/**\n * A manifest field is either a flat list or, when the build is partitioned\n * (e.g. by authorizer), an object keyed by partition name. Readonly-tolerant so\n * the `as const` generated manifest assigns cleanly.\n */\nexport type ManifestField<T> =\n\t| readonly T[]\n\t| Readonly<Record<string, readonly T[]>>;\n\n/** Flatten a manifest field (array or partitioned) into a plain array. */\nexport function flattenManifestField<T>(\n\tfield: ManifestField<T> | undefined,\n): T[] {\n\tif (!field) return [];\n\treturn Array.isArray(field)\n\t\t? [...field]\n\t\t: Object.values(field as Record<string, readonly T[]>).flat();\n}\n\n/**\n * A monitor set with `.monitor()`, so infrastructure can provision what it\n * reports to, e.g. create a heartbeat and set its URL in `env`.\n */\nexport interface MonitorInfo {\n\t/** The kind of monitor, e.g. `heartbeat`. */\n\ttype: string;\n\t/** The service it reports to, e.g. `betterStack`. Absent for a custom one. */\n\tprovider?: string;\n\t/** The environment variable it reads its target from. */\n\tenv?: string;\n}\n\n/** A single HTTP route. */\nexport interface RouteInfo {\n\t/** Route path, e.g. `/users/{id}`. */\n\tpath: string;\n\t/** HTTP method, e.g. `GET`. */\n\tmethod: string;\n\t/** Bundled handler entrypoint. */\n\thandler: string;\n\ttimeout?: number;\n\tmemorySize?: number;\n\t/** Required environment variables (a trailing `?` marks an optional var). */\n\tenvironment?: readonly string[];\n\t/** Authorizer name: `none`, `iam`, or a declared authorizer. */\n\tauthorizer: string;\n\t/** Monitors set with `.monitor()`; absent when there are none. */\n\tmonitoring?: readonly MonitorInfo[];\n}\n\n/** A standalone Lambda function. */\nexport interface FunctionInfo {\n\tname: string;\n\thandler: string;\n\ttimeout?: number;\n\tmemorySize?: number;\n\tenvironment?: readonly string[];\n\t/** Monitors set with `.monitor()`; absent when there are none. */\n\tmonitoring?: readonly MonitorInfo[];\n}\n\n/** A scheduled (cron) function. */\nexport interface CronInfo {\n\tname: string;\n\thandler: string;\n\t/** Schedule expression, e.g. `rate(1 day)` or `cron(0 12 * * ? *)`. */\n\tschedule: string;\n\ttimeout?: number;\n\tmemorySize?: number;\n\tenvironment?: readonly string[];\n\t/** Monitors set with `.monitor()`; absent when there are none. */\n\tmonitoring?: readonly MonitorInfo[];\n}\n\n/** An event subscriber function (topic/queue resolved by `transport`). */\nexport interface SubscriberInfo {\n\tname: string;\n\thandler: string;\n\tsubscribedEvents: readonly string[];\n\t/** Delivery transport — `topic` (SNS fan-out) or `queue` (SQS). */\n\ttransport?: 'topic' | 'queue';\n\t/** The {@link TopicInfo.name} this subscriber binds to (via `s.topic(topic)`). */\n\ttopic?: string;\n\ttimeout?: number;\n\tmemorySize?: number;\n\tenvironment?: readonly string[];\n}\n\n/**\n * A pub/sub topic — fan-out. A *resource* (no handler): it declares the event\n * contract; producers publish via the derived publisher and {@link SubscriberInfo}s\n * bind to it. Infra provisions an SNS topic.\n */\nexport interface TopicInfo {\n\tname: string;\n\t/** The event type names this topic carries. */\n\tevents: readonly string[];\n\t/** Whether the topic is FIFO. */\n\tfifo?: boolean;\n}\n\n/** A queue worker — a queue and its single consumer. */\nexport interface QueueInfo {\n\tname: string;\n\thandler: string;\n\t/** SQS event-source batch size. */\n\tbatchSize?: number;\n\t/** Whether the queue is FIFO. */\n\tfifo?: boolean;\n\ttimeout?: number;\n\tmemorySize?: number;\n\tenvironment?: readonly string[];\n}\n\n/**\n * The full deployment manifest — the shape of `export const manifest` in a\n * generated `manifest/<provider>.ts`. Each field is a {@link ManifestField}\n * (flat or partitioned).\n */\nexport interface Manifest {\n\troutes: ManifestField<RouteInfo>;\n\tfunctions?: ManifestField<FunctionInfo>;\n\tcrons?: ManifestField<CronInfo>;\n\tsubscribers?: ManifestField<SubscriberInfo>;\n\tqueues?: ManifestField<QueueInfo>;\n\ttopics?: ManifestField<TopicInfo>;\n}\n\nexport * from './cron';\n"],"mappings":";;;;AA6BA,SAAgB,qBACfA,OACM;AACN,MAAK,MAAO,QAAO,CAAE;AACrB,QAAO,MAAM,QAAQ,MAAM,GACxB,CAAC,GAAG,KAAM,IACV,OAAO,OAAO,MAAsC,CAAC,MAAM;AAC9D"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geekmidas/manifest",
-  "version": "9.2.0",
+  "version": "9.3.0",
   "type": "module",
   "exports": {
     ".": {

package/src/__tests__/cron.spec.ts

@@ -0,0 +1,253 @@
+import { describe, expect, it } from 'vitest';
+import {
+	CronPeriodError,
+	cronPeriod,
+	InvalidCronExpressionError,
+	parseCron,
+	toAwsCron,
+	toUnixCron,
+	UnconvertibleCronExpressionError,
+} from '../cron';
+
+describe('parseCron', () => {
+	it.each([
+		['cron(0 8 * * *)', 'unix'],
+		['cron(*/15 * * * *)', 'unix'],
+		['cron(0 9 * * 1-5)', 'unix'],
+		['cron(0 9 * * MON-FRI)', 'unix'],
+		['cron(0 6,18 * * *)', 'unix'],
+		['cron(0 0 1 * 0)', 'unix'],
+		['cron(0 9 1 * MON)', 'unix'],
+		['cron(0 0 * * 7)', 'unix'],
+		['cron(0 08 * * ? *)', 'aws'],
+		['cron(0/30 * * * ? *)', 'aws'],
+		['cron(0 0 * * ? *)', 'aws'],
+		['cron(0 9 ? * MON-FRI *)', 'aws'],
+		['cron(0 9 ? * 2-6 *)', 'aws'],
+		['cron(0 9 L * ? *)', 'aws'],
+		['cron(0 9 15W * ? *)', 'aws'],
+		['cron(0 9 ? * 6#3 *)', 'aws'],
+		['cron(0 9 ? * FRIL 2026-2027)', 'aws'],
+	])('accepts %s as %s', (expression, dialect) => {
+		expect(parseCron(expression).dialect).toBe(dialect);
+	});
+
+	it('splits the fields', () => {
+		expect(parseCron('cron(0 9 ? * MON-FRI 2026)')).toEqual({
+			dialect: 'aws',
+			minute: '0',
+			hour: '9',
+			dayOfMonth: '?',
+			month: '*',
+			dayOfWeek: 'MON-FRI',
+			year: '2026',
+		});
+	});
+
+	it.each([
+		['4 fields', 'cron(0 8 * *)', undefined, '0 8 * *'],
+		['7 fields', 'cron(0 0 8 * * ? *)', undefined, '0 0 8 * * ? *'],
+		['rate()', 'rate(1 day)', undefined, 'rate(1 day)'],
+		['`?` in Unix', 'cron(0 8 * * ?)', 'dayOfWeek', '?'],
+		['AWS without `?`', 'cron(0 8 * * * *)', 'dayOfWeek', '*'],
+		['AWS with `?` in both day fields', 'cron(0 8 ? * ? *)', 'dayOfWeek', '?'],
+		[
+			'AWS with both day fields restricted',
+			'cron(0 9 1 * MON *)',
+			'dayOfWeek',
+			'MON',
+		],
+		['AWS day-of-week 0', 'cron(0 9 ? * 0 *)', 'dayOfWeek', '0'],
+		['hour 25', 'cron(0 25 * * *)', 'hour', '25'],
+		['minute 60', 'cron(60 * * * ? *)', 'minute', '60'],
+		['`L` in Unix', 'cron(0 9 L * *)', 'dayOfMonth', 'L'],
+		['a double space', 'cron(0  8 * * *)', 'hour', ''],
+		['an unknown month', 'cron(0 8 * FOO *)', 'month', 'FOO'],
+		['a year before 1970', 'cron(0 8 * * ? 1969)', 'year', '1969'],
+		['an invalid atom in a list', 'cron(0 6,24 * * *)', 'hour', '24'],
+	])('rejects %s', (_, expression, field, token) => {
+		expect(() => parseCron(expression)).toThrow(
+			expect.objectContaining({
+				name: 'InvalidCronExpressionError',
+				message: 'Invalid cron expression',
+				cause: { expression, field, token },
+			}),
+		);
+	});
+
+	it('throws InvalidCronExpressionError', () => {
+		expect(() => parseCron('cron(0 25 * * *)')).toThrow(
+			InvalidCronExpressionError,
+		);
+	});
+});
+
+describe('toAwsCron', () => {
+	it.each([
+		['both day fields `*`', 'cron(0 8 * * *)', 'cron(0 8 * * ? *)'],
+		['only day-of-month restricted', 'cron(0 0 1 * *)', 'cron(0 0 1 * ? *)'],
+		['only day-of-week restricted', 'cron(0 9 * * 1-5)', 'cron(0 9 ? * 2-6 *)'],
+		['day-of-week names', 'cron(0 9 * * MON-FRI)', 'cron(0 9 ? * MON-FRI *)'],
+		['SUN as 0', 'cron(0 0 * * 0)', 'cron(0 0 ? * 1 *)'],
+		['SUN as 7', 'cron(0 0 * * 7)', 'cron(0 0 ? * 1 *)'],
+		['a range wrapping past SUN', 'cron(0 0 * * 5-7)', 'cron(0 0 ? * 1,6,7 *)'],
+		['a step', 'cron(0 0 * * */2)', 'cron(0 0 ? * 1,3,5,7 *)'],
+		['every day of the week', 'cron(0 0 * * 0-6)', 'cron(0 0 ? * * *)'],
+	])('converts %s', (_, unix, aws) => {
+		expect(toAwsCron(unix)).toEqual({ expression: aws, warnings: [] });
+	});
+
+	it('keeps day-of-week and warns when both day fields are restricted', () => {
+		expect(toAwsCron('cron(0 9 1 * 1)')).toEqual({
+			expression: 'cron(0 9 ? * 2 *)',
+			warnings: [
+				{
+					code: 'dayOfMonthDropped',
+					message:
+						'Both day fields are restricted, so day-of-month was dropped and the cron runs on fewer days',
+					token: '1',
+				},
+			],
+		});
+	});
+
+	it('returns an AWS expression unchanged', () => {
+		expect(toAwsCron('cron(0 9 15W * ? *)')).toEqual({
+			expression: 'cron(0 9 15W * ? *)',
+			warnings: [],
+		});
+	});
+
+	it('rejects an invalid expression', () => {
+		expect(() => toAwsCron('cron(0 25 * * *)')).toThrow(
+			InvalidCronExpressionError,
+		);
+	});
+});
+
+describe('toUnixCron', () => {
+	it.each([
+		['`?` in day-of-week', 'cron(0 8 * * ? *)', 'cron(0 8 * * *)'],
+		['`?` in day-of-month', 'cron(0 9 ? * 2-6 *)', 'cron(0 9 * * 1-5)'],
+		['day-of-week names', 'cron(0 9 ? * MON-FRI *)', 'cron(0 9 * * MON-FRI)'],
+		['SUN as 1', 'cron(0 0 ? * 1 *)', 'cron(0 0 * * 0)'],
+		['SAT as 7', 'cron(0 0 ? * 7 *)', 'cron(0 0 * * 6)'],
+		['`L` in day-of-month', 'cron(0 9 L * ? *)', 'cron(0 9 L * *)'],
+		['`nL` in day-of-week', 'cron(0 9 ? * 6L *)', 'cron(0 9 * * 5L)'],
+		['`n#k` in day-of-week', 'cron(0 9 ? * 6#3 *)', 'cron(0 9 * * 5#3)'],
+		['a named `nL`', 'cron(0 9 ? * FRIL *)', 'cron(0 9 * * FRIL)'],
+	])('converts %s', (_, aws, unix) => {
+		expect(toUnixCron(aws)).toEqual({ expression: unix, warnings: [] });
+	});
+
+	it('drops a specific year with a warning', () => {
+		expect(toUnixCron('cron(0 9 ? * FRI 2026-2027)')).toEqual({
+			expression: 'cron(0 9 * * FRI)',
+			warnings: [
+				{
+					code: 'yearDropped',
+					message: 'The year was dropped, so the cron runs every year',
+					token: '2026-2027',
+				},
+			],
+		});
+	});
+
+	it('returns a Unix expression unchanged', () => {
+		expect(toUnixCron('cron(0 9 1 * MON)')).toEqual({
+			expression: 'cron(0 9 1 * MON)',
+			warnings: [],
+		});
+	});
+
+	it.each(['15W', 'LW', 'L-3'])('rejects %s in day-of-month', (token) => {
+		const expression = `cron(0 9 ${token} * ? *)`;
+		expect(() => toUnixCron(expression)).toThrow(
+			expect.objectContaining({
+				name: 'UnconvertibleCronExpressionError',
+				message: 'Cron expression cannot be converted',
+				cause: { expression, field: 'dayOfMonth', token },
+			}),
+		);
+		expect(() => toUnixCron(expression)).toThrow(
+			UnconvertibleCronExpressionError,
+		);
+	});
+});
+
+describe('round trip', () => {
+	it.each([
+		'cron(0 8 * * *)',
+		'cron(*/15 * * * *)',
+		'cron(0 9 * * 1-5)',
+		'cron(0 9 * * MON-FRI)',
+		'cron(0 6,18 1 * *)',
+		'cron(0 0 * * 0)',
+	])('%s converts to AWS and back unchanged', (unix) => {
+		expect(toUnixCron(toAwsCron(unix).expression).expression).toBe(unix);
+	});
+});
+
+describe('cronPeriod', () => {
+	const MINUTE = 60;
+	const HOUR = 60 * MINUTE;
+	const DAY = 24 * HOUR;
+
+	it.each([
+		['cron(0 8 * * ? *)', DAY, 'once a day'],
+		['cron(0 8 * * *)', DAY, 'once a day, Unix'],
+		['cron(0/15 * * * ? *)', 15 * MINUTE, 'every 15 minutes'],
+		['cron(* * * * *)', MINUTE, 'every minute'],
+		['cron(0 */2 * * *)', 2 * HOUR, 'every 2 hours'],
+		['cron(0 6,18 * * ? *)', 12 * HOUR, 'twice a day, evenly'],
+		['cron(0 6,9 * * ? *)', 21 * HOUR, 'twice a day, unevenly'],
+		['cron(0 9 ? * MON-FRI *)', 3 * DAY, 'weekdays, over the weekend'],
+		['cron(0 9 * * 1-5)', 3 * DAY, 'weekdays, Unix numbers'],
+		['cron(0 9 ? * MON *)', 7 * DAY, 'weekly'],
+		['cron(0 0 1 * ? *)', 31 * DAY, 'monthly, over a 31-day month'],
+		['cron(0 0 L * ? *)', 31 * DAY, 'the last day of the month'],
+		['cron(0 0 L-2 * ? *)', 31 * DAY, 'two days before the last'],
+		['cron(0 0 ? * 6#3 *)', 35 * DAY, 'the third Friday of the month'],
+		['cron(0 0 ? * 6L *)', 35 * DAY, 'the last Friday of the month'],
+		['cron(0 0 1 JAN ? *)', 366 * DAY, 'yearly, over a leap year'],
+		['cron(0 0 29 2 ? *)', (4 * 365 + 1) * DAY, 'leap days only'],
+	])('%s is %i seconds (%s)', (expression, period) => {
+		expect(cronPeriod(expression)).toBe(period);
+	});
+
+	it('runs on the nearest weekday for nW', () => {
+		// The 15th falls on a weekend in some months, moving the run a day, so
+		// the longest gap is a month plus up to two days.
+		const period = cronPeriod('cron(0 9 15W * ? *)');
+		expect(period).toBeGreaterThan(31 * DAY);
+		expect(period).toBeLessThanOrEqual(33 * DAY);
+	});
+
+	it('runs on the last weekday for LW', () => {
+		const period = cronPeriod('cron(0 9 LW * ? *)');
+		expect(period).toBeGreaterThan(31 * DAY);
+		expect(period).toBeLessThanOrEqual(33 * DAY);
+	});
+
+	it('uses the AWS form when a Unix expression restricts both day fields', () => {
+		// AWS keeps day-of-week, so this runs on Mondays, not also on the 1st.
+		expect(cronPeriod('cron(0 9 1 * MON)')).toBe(7 * DAY);
+	});
+
+	it('rejects an invalid expression', () => {
+		expect(() => cronPeriod('cron(0 25 * * *)')).toThrow(
+			InvalidCronExpressionError,
+		);
+	});
+
+	it('rejects an expression that runs less than twice', () => {
+		const expression = 'cron(0 0 30 2 ? *)';
+		expect(() => cronPeriod(expression)).toThrow(CronPeriodError);
+		expect(() => cronPeriod(expression)).toThrow(
+			expect.objectContaining({
+				message: 'Cron expression runs less than twice in eight years',
+				cause: { expression },
+			}),
+		);
+	});
+});