@geekmidas/constructs 10.0.0-alpha.11 → 10.0.0-alpha.111

package/dist/CronBuilder-D3sF9tS_.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"CronBuilder-D3sF9tS_.mjs","names":["uniqBy"],"sources":["../src/crons/Cron.ts","../src/crons/CronBuilder.ts"],"sourcesContent":["import type { AuditableAction } from '@geekmidas/audit';\nimport type { EventPublisher } from '@geekmidas/events';\nimport type { Logger } from '@geekmidas/logger';\nimport type { ComposableStandardSchema } from '@geekmidas/schema';\nimport type { Service } from '@geekmidas/services';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\nimport { ConstructType } from '../Construct';\nimport { Function, type FunctionHandler } from '../functions';\nimport type { TopicEvent } from '../publisher';\n\nexport class Cron<\n\tTInput extends ComposableStandardSchema | undefined = undefined,\n\tTServices extends Service[] = [],\n\tTLogger extends Logger = Logger,\n\tOutSchema extends StandardSchemaV1 | undefined = undefined,\n\tTDatabase = undefined,\n\tTDatabaseServiceName extends string = string,\n> extends Function<\n\tTInput,\n\tTServices,\n\tTLogger,\n\tOutSchema,\n\tundefined,\n\tstring,\n\tTDatabase,\n\tTDatabaseServiceName,\n\tAuditableAction<string, unknown>,\n\tFunctionHandler<TInput, TServices, TLogger, OutSchema, TDatabase>\n> {\n\t/**\n\t * Where this cron's schedule lives when a server runs it.\n\t *\n\t * Carried from the worker that built it, which declared it once with\n\t * `.database(db)`. Unread on AWS, where the schedule is an EventBridge rule\n\t * and nothing in this process fires anything.\n\t *\n\t * A service rather than the construct, because what reads it is service\n\t * discovery in the generated server — which registers services, and failed\n\t * on the construct with `service.register is not a function`.\n\t */\n\tscheduleStore?: Service<string, unknown>;\n\n\tstatic isCron(obj: any): obj is Cron<any, any, any, any> {\n\t\treturn Boolean(\n\t\t\tobj &&\n\t\t\t\t(obj as Function).__IS_FUNCTION__ === true &&\n\t\t\t\tobj.type === ConstructType.Cron,\n\t\t);\n\t}\n\n\tconstructor(\n\t\tfn: FunctionHandler<TInput, TServices, TLogger, OutSchema, TDatabase>,\n\t\ttimeout?: number,\n\t\tprotected _schedule?: ScheduleExpression,\n\t\tinput?: TInput,\n\t\toutputSchema?: OutSchema,\n\t\tservices: TServices = [] as unknown as TServices,\n\t\tlogger?: TLogger,\n\t\t/** What it publishes once it has run, each to its own topic. */\n\t\tevents: TopicEvent[] = [],\n\t\tmemorySize?: number,\n\t\tdatabaseService?: Service<TDatabaseServiceName, TDatabase>,\n\t\t/**\n\t\t * The construct ids `.dependsOn()` named — last, so no existing positional\n\t\t * argument moves.\n\t\t */\n\t\tconstructs: string[] = [],\n\t) {\n\t\tsuper(\n\t\t\tfn,\n\t\t\ttimeout,\n\t\t\tConstructType.Cron,\n\t\t\tinput,\n\t\t\toutputSchema,\n\t\t\tservices,\n\t\t\tlogger,\n\t\t\tevents,\n\t\t\tmemorySize,\n\t\t\tundefined, // auditorStorageService\n\t\t\tdatabaseService,\n\t\t\tconstructs,\n\t\t);\n\t}\n\n\tget schedule(): ScheduleExpression | undefined {\n\t\treturn this._schedule;\n\t}\n}\n\nexport type RateExpression = `rate(${string})`;\n\ntype CronMinute =\n\t| '*'\n\t| number\n\t| `${number}`\n\t| `${number}-${number}`\n\t| `${number}/${number}`\n\t| `*/${number}`\n\t| `${number},${number}`\n\t| string; // Allow more complex patterns\n\ntype CronHour =\n\t| '*'\n\t| number\n\t| `${number}`\n\t| `${number}-${number}`\n\t| `${number}/${number}`\n\t| `*/${number}`\n\t| `${number},${number}`\n\t| string; // Allow more complex patterns\n\ntype CronDay =\n\t| '*'\n\t| number\n\t| `${number}`\n\t| `${number}-${number}`\n\t| `${number}/${number}`\n\t| `*/${number}`\n\t| `${number},${number}`\n\t| string; // Allow more complex patterns\n\ntype CronMonth =\n\t| '*'\n\t| number\n\t| `${number}`\n\t| `${number}-${number}`\n\t| `${number}/${number}`\n\t| `*/${number}`\n\t| 'JAN'\n\t| 'FEB'\n\t| 'MAR'\n\t| 'APR'\n\t| 'MAY'\n\t| 'JUN'\n\t| 'JUL'\n\t| 'AUG'\n\t| 'SEP'\n\t| 'OCT'\n\t| 'NOV'\n\t| 'DEC'\n\t| string; // Allow more complex patterns\n\ntype CronWeekday =\n\t| '*'\n\t| number\n\t| `${number}`\n\t| `${number}-${number}`\n\t| `${number}/${number}`\n\t| `*/${number}`\n\t| 'SUN'\n\t| 'MON'\n\t| 'TUE'\n\t| 'WED'\n\t| 'THU'\n\t| 'FRI'\n\t| 'SAT'\n\t| `${string}-${string}` // Allow patterns like MON-FRI\n\t| string; // Allow more complex patterns\n\nexport type CronExpression =\n\t`cron(${CronMinute} ${CronHour} ${CronDay} ${CronMonth} ${CronWeekday})`;\n\nexport type ScheduleExpression = RateExpression | CronExpression;\n","import type { Logger } from '@geekmidas/logger';\nimport type {\n\tComposableStandardSchema,\n\tInferStandardSchema,\n} from '@geekmidas/schema';\nimport type { Service } from '@geekmidas/services';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\nimport uniqBy from 'lodash.uniqby';\nimport { ConstructType } from '../Construct';\nimport { cloneWith } from '../clone';\nimport {\n\ttype Consumable,\n\tdatabaseEdges,\n\tidsOf,\n\ttype ServicesOf,\n\tserviceOf,\n\tservicesOf,\n} from '../construct-interface';\nimport { FunctionBuilder, type FunctionHandler } from '../functions';\nimport type { EventFor } from '../publisher';\nimport type { Topic } from '../topic/Topic';\nimport { Cron, type ScheduleExpression } from './Cron';\n\nexport class CronBuilder<\n\tTInput extends ComposableStandardSchema,\n\tTServices extends Service[],\n\tTLogger extends Logger = Logger,\n\tOutSchema extends StandardSchemaV1 | undefined = undefined,\n\tTDatabase = undefined,\n\tTDatabaseServiceName extends string = string,\n> extends FunctionBuilder<\n\tTInput,\n\tOutSchema,\n\tTServices,\n\tTLogger,\n\tundefined,\n\tstring,\n\tTDatabase,\n\tTDatabaseServiceName\n> {\n\tprivate _schedule?: ScheduleExpression;\n\n\tconstructor() {\n\t\tsuper(ConstructType.Cron);\n\t}\n\n\toverride memorySize(memorySize: number): this {\n\t\treturn cloneWith(this, { _memorySize: memorySize });\n\t}\n\n\tschedule(\n\t\t_expression: ScheduleExpression,\n\t): CronBuilder<\n\t\tTInput,\n\t\tTServices,\n\t\tTLogger,\n\t\tOutSchema,\n\t\tTDatabase,\n\t\tTDatabaseServiceName\n\t> {\n\t\treturn cloneWith(this, { _schedule: _expression });\n\t}\n\n\toverride input<T extends ComposableStandardSchema>(\n\t\tschema: T,\n\t): CronBuilder<\n\t\tT,\n\t\tTServices,\n\t\tTLogger,\n\t\tOutSchema,\n\t\tTDatabase,\n\t\tTDatabaseServiceName\n\t> {\n\t\treturn cloneWith(this, {\n\t\t\tinputSchema: schema as unknown as TInput,\n\t\t}) as unknown as CronBuilder<\n\t\t\tT,\n\t\t\tTServices,\n\t\t\tTLogger,\n\t\t\tOutSchema,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName\n\t\t>;\n\t}\n\n\toverride output<T extends StandardSchemaV1>(\n\t\tschema: T,\n\t): CronBuilder<\n\t\tTInput,\n\t\tTServices,\n\t\tTLogger,\n\t\tT,\n\t\tTDatabase,\n\t\tTDatabaseServiceName\n\t> {\n\t\treturn cloneWith(this, {\n\t\t\toutputSchema: schema as unknown as OutSchema,\n\t\t}) as unknown as CronBuilder<\n\t\t\tTInput,\n\t\t\tTServices,\n\t\t\tTLogger,\n\t\t\tT,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName\n\t\t>;\n\t}\n\n\t/**\n\t * Depend on constructs — a database, a bucket, a mail sender, a queue, a\n\t * topic.\n\t *\n\t * It records the edge and dissolves each construct's client into the\n\t * handler's service record under the construct's own id, so\n\t * `.dependsOn([uploads])` is what makes `services.uploads` exist and type.\n\t *\n\t * Constructs only. A `Service` does not match the shape, which is what keeps\n\t * env sniffing confined to `.services()` and the explicit lift.\n\t */\n\toverride dependsOn<const T extends readonly Consumable[]>(\n\t\tconstructs: T,\n\t): CronBuilder<\n\t\tTInput,\n\t\t[...TServices, ...ServicesOf<T>],\n\t\tTLogger,\n\t\tOutSchema,\n\t\tTDatabase,\n\t\tTDatabaseServiceName\n\t> {\n\t\t// Both halves of the edge, from one call and one clone: the services the\n\t\t// handler runs with, and the ids the manifest records. Recording them\n\t\t// separately is what let them drift apart.\n\t\t//\n\t\t// `servicesOf` is the half that validates, so it runs first — recording\n\t\t// ids ahead of it left a caught `NotAConstruct` with `undefined` already\n\t\t// on a `string[]`.\n\t\tconst services = servicesOf(constructs) as unknown as Service[];\n\n\t\treturn cloneWith(this, {\n\t\t\t_services: uniqBy(\n\t\t\t\t[...this._services, ...services],\n\t\t\t\t(s: Service) => s.serviceName,\n\t\t\t),\n\t\t\t_constructs: idsOf(constructs, this._constructs),\n\t\t}) as unknown as CronBuilder<\n\t\t\tTInput,\n\t\t\t[...TServices, ...ServicesOf<T>],\n\t\t\tTLogger,\n\t\t\tOutSchema,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName\n\t\t>;\n\t}\n\n\toverride services<T extends Service[]>(\n\t\tservices: T,\n\t): CronBuilder<\n\t\tTInput,\n\t\t[...TServices, ...T],\n\t\tTLogger,\n\t\tOutSchema,\n\t\tTDatabase,\n\t\tTDatabaseServiceName\n\t> {\n\t\treturn cloneWith(this, {\n\t\t\t_services: uniqBy(\n\t\t\t\t[...this._services, ...services],\n\t\t\t\t(s) => s.serviceName,\n\t\t\t) as TServices,\n\t\t}) as unknown as CronBuilder<\n\t\t\tTInput,\n\t\t\t[...TServices, ...T],\n\t\t\tTLogger,\n\t\t\tOutSchema,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName\n\t\t>;\n\t}\n\n\toverride logger<T extends Logger>(\n\t\tlogger: T,\n\t): CronBuilder<\n\t\tTInput,\n\t\tTServices,\n\t\tT,\n\t\tOutSchema,\n\t\tTDatabase,\n\t\tTDatabaseServiceName\n\t> {\n\t\treturn cloneWith(this, {\n\t\t\t_logger: logger as unknown as TLogger,\n\t\t}) as unknown as CronBuilder<\n\t\t\tTInput,\n\t\t\tTServices,\n\t\t\tT,\n\t\t\tOutSchema,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName\n\t\t>;\n\t}\n\n\t/**\n\t * Publish `event` to `topic` each time the cron has run successfully —\n\t * repeatable, to as many topics as it names. The topic becomes a dependency\n\t * as with `.dependsOn([topic])`, so `services.<topic>` is there too.\n\t */\n\toverride event<TTopic extends Topic<any, any>>(\n\t\ttopic: TTopic,\n\t\tevent: EventFor<TTopic, InferStandardSchema<OutSchema>>,\n\t): CronBuilder<\n\t\tTInput,\n\t\t[...TServices, TTopic['service']],\n\t\tTLogger,\n\t\tOutSchema,\n\t\tTDatabase,\n\t\tTDatabaseServiceName\n\t> {\n\t\treturn this.withEvent(topic, event as never) as unknown as CronBuilder<\n\t\t\tTInput,\n\t\t\t[...TServices, TTopic['service']],\n\t\t\tTLogger,\n\t\t\tOutSchema,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName\n\t\t>;\n\t}\n\n\t/**\n\t * Set the database service for this cron job.\n\t * The database will be available in the handler context as `db`.\n\t */\n\toverride database<T, TName extends string>(\n\t\tsource: Consumable<TName, T> | Service<TName, T>,\n\t): CronBuilder<TInput, TServices, TLogger, OutSchema, T, TName> {\n\t\tconst service = serviceOf(source);\n\n\t\treturn cloneWith(this, {\n\t\t\t_databaseService: service as unknown as Service<\n\t\t\t\tTDatabaseServiceName,\n\t\t\t\tTDatabase\n\t\t\t>,\n\t\t\t// The edge, as `.dependsOn()` records one — see EndpointFactory —\n\t\t\t// in place of the one a previous `.database()` added, which is how a\n\t\t\t// worker's default database is overridden rather than added to.\n\t\t\t...databaseEdges(\n\t\t\t\t{\n\t\t\t\t\tconstructs: this._constructs,\n\t\t\t\t\tedge: this._databaseEdge,\n\t\t\t\t\tservice: this._databaseService as Service | undefined,\n\t\t\t\t\tservices: this._services,\n\t\t\t\t},\n\t\t\t\tsource,\n\t\t\t),\n\t\t}) as unknown as CronBuilder<\n\t\t\tTInput,\n\t\t\tTServices,\n\t\t\tTLogger,\n\t\t\tOutSchema,\n\t\t\tT,\n\t\t\tTName\n\t\t>;\n\t}\n\n\toverride handle(\n\t\tfn: FunctionHandler<TInput, TServices, TLogger, OutSchema, TDatabase>,\n\t): Cron<\n\t\tTInput,\n\t\tTServices,\n\t\tTLogger,\n\t\tOutSchema,\n\t\tTDatabase,\n\t\tTDatabaseServiceName\n\t> {\n\t\tconst cron = new Cron(\n\t\t\tfn,\n\t\t\tthis._timeout,\n\t\t\tthis._schedule,\n\t\t\tthis.inputSchema,\n\t\t\tthis.outputSchema,\n\t\t\tthis._services,\n\t\t\tthis._logger,\n\t\t\tthis._events,\n\t\t\tthis._memorySize,\n\t\t\tthis._databaseService,\n\t\t\tthis._constructs,\n\t\t);\n\n\t\t// Which process runs it. Carried from the factory rather than inferred\n\t\t// from the directory the file happens to sit in.\n\t\tcron.owner = this._owner;\n\n\t\t// And where that process keeps the schedule, when a server is what runs\n\t\t// it. Declared once on the worker rather than repeated per cron.\n\t\tcron.scheduleStore = this._scheduleStore\n\t\t\t? serviceOf(this._scheduleStore as Consumable<string, unknown>)\n\t\t\t: undefined;\n\n\t\t// No reset. `.handle()` reads this builder and leaves it alone, so a\n\t\t// configured base — `const fn = f.logger(log).timeout(60_000)` — keeps\n\t\t// its configuration for every construct built from it. The reset that\n\t\t// used to be here wiped the base on first use, which made a base usable\n\t\t// exactly once, and quietly reverted the logger to the default.\n\n\t\treturn cron;\n\t}\n}\n"],"mappings":";;;;;;AAUA,IAAa,OAAb,cAOU,SAWR;CAyBU;;;;;;;;;;;;CAbX;CAEA,OAAO,OAAO,KAA2C;EACxD,OAAO,QACN,OACE,IAAiB,oBAAoB,QACtC,IAAI,SAAA,6BACN;CACD;CAEA,YACC,IACA,SACA,WACA,OACA,cACA,WAAsB,CAAC,GACvB,QAEA,SAAuB,CAAC,GACxB,YACA,iBAKA,aAAuB,CAAC,GACvB;EACD,MACC,IACA,SAAA,+BAEA,OACA,cACA,UACA,QACA,QACA,YACA,KAAA,GACA,iBACA,UACD;EA5BU,KAAA,YAAA;CA6BX;CAEA,IAAI,WAA2C;EAC9C,OAAO,KAAK;CACb;AACD;;;AChEA,IAAa,cAAb,cAOU,gBASR;CACD;CAEA,cAAc;EACb,MAAA,6BAAwB;CACzB;CAEA,WAAoB,YAA0B;EAC7C,OAAO,UAAU,MAAM,EAAE,aAAa,WAAW,CAAC;CACnD;CAEA,SACC,aAQC;EACD,OAAO,UAAU,MAAM,EAAE,WAAW,YAAY,CAAC;CAClD;CAEA,MACC,QAQC;EACD,OAAO,UAAU,MAAM,EACtB,aAAa,OACd,CAAC;CAQF;CAEA,OACC,QAQC;EACD,OAAO,UAAU,MAAM,EACtB,cAAc,OACf,CAAC;CAQF;;;;;;;;;;;;CAaA,UACC,YAQC;EAQD,MAAM,WAAW,WAAW,UAAU;EAEtC,OAAO,UAAU,MAAM;GACtB,YAAA,GAAWA,qBAAAA,QAAAA,CACV,CAAC,GAAG,KAAK,WAAW,GAAG,QAAQ,IAC9B,MAAe,EAAE,WACnB;GACA,aAAa,MAAM,YAAY,KAAK,WAAW;EAChD,CAAC;CAQF;CAEA,SACC,UAQC;EACD,OAAO,UAAU,MAAM,EACtB,YAAA,GAAWA,qBAAAA,QAAAA,CACV,CAAC,GAAG,KAAK,WAAW,GAAG,QAAQ,IAC9B,MAAM,EAAE,WACV,EACD,CAAC;CAQF;CAEA,OACC,QAQC;EACD,OAAO,UAAU,MAAM,EACtB,SAAS,OACV,CAAC;CAQF;;;;;;CAOA,MACC,OACA,OAQC;EACD,OAAO,KAAK,UAAU,OAAO,KAAc;CAQ5C;;;;;CAMA,SACC,QAC+D;EAC/D,MAAM,UAAU,UAAU,MAAM;EAEhC,OAAO,UAAU,MAAM;GACtB,kBAAkB;GAOlB,GAAG,cACF;IACC,YAAY,KAAK;IACjB,MAAM,KAAK;IACX,SAAS,KAAK;IACd,UAAU,KAAK;GAChB,GACA,MACD;EACD,CAAC;CAQF;CAEA,OACC,IAQC;EACD,MAAM,OAAO,IAAI,KAChB,IACA,KAAK,UACL,KAAK,WACL,KAAK,aACL,KAAK,cACL,KAAK,WACL,KAAK,SACL,KAAK,SACL,KAAK,aACL,KAAK,kBACL,KAAK,WACN;EAIA,KAAK,QAAQ,KAAK;EAIlB,KAAK,gBAAgB,KAAK,iBACvB,UAAU,KAAK,cAA6C,IAC5D,KAAA;EAQH,OAAO;CACR;AACD"}

package/dist/CronBuilder-Xx_zakuc.d.mts

@@ -0,0 +1,47 @@
+import { t as StandardSchemaV1 } from "./index-CeEtxDmK.mjs";
+import { a as EventFor, c as Topic } from "./Construct-QXnl3VqT.mjs";
+import { i as FunctionHandler } from "./Function-DuqGcbOI.mjs";
+import { c as ServicesOf, r as Consumable } from "./construct-interface-ZvYQbivO.mjs";
+import { t as FunctionBuilder } from "./index-B13kQB_U.mjs";
+import { i as ScheduleExpression, t as Cron } from "./Cron-CQJqqkhY.mjs";
+import { Service } from "@geekmidas/services";
+import { Logger } from "@geekmidas/logger";
+import { ComposableStandardSchema, InferStandardSchema } from "@geekmidas/schema";
+//#region src/crons/CronBuilder.d.ts
+declare class CronBuilder<TInput extends ComposableStandardSchema, TServices extends Service[], TLogger extends Logger = Logger, OutSchema extends StandardSchemaV1 | undefined = undefined, TDatabase = undefined, TDatabaseServiceName extends string = string> extends FunctionBuilder<TInput, OutSchema, TServices, TLogger, undefined, string, TDatabase, TDatabaseServiceName> {
+  private _schedule?;
+  constructor();
+  memorySize(memorySize: number): this;
+  schedule(_expression: ScheduleExpression): CronBuilder<TInput, TServices, TLogger, OutSchema, TDatabase, TDatabaseServiceName>;
+  input<T extends ComposableStandardSchema>(schema: T): CronBuilder<T, TServices, TLogger, OutSchema, TDatabase, TDatabaseServiceName>;
+  output<T extends StandardSchemaV1>(schema: T): CronBuilder<TInput, TServices, TLogger, T, TDatabase, TDatabaseServiceName>;
+  /**
+   * Depend on constructs — a database, a bucket, a mail sender, a queue, a
+   * topic.
+   *
+   * It records the edge and dissolves each construct's client into the
+   * handler's service record under the construct's own id, so
+   * `.dependsOn([uploads])` is what makes `services.uploads` exist and type.
+   *
+   * Constructs only. A `Service` does not match the shape, which is what keeps
+   * env sniffing confined to `.services()` and the explicit lift.
+   */
+  dependsOn<const T extends readonly Consumable[]>(constructs: T): CronBuilder<TInput, [...TServices, ...ServicesOf<T>], TLogger, OutSchema, TDatabase, TDatabaseServiceName>;
+  services<T extends Service[]>(services: T): CronBuilder<TInput, [...TServices, ...T], TLogger, OutSchema, TDatabase, TDatabaseServiceName>;
+  logger<T extends Logger>(logger: T): CronBuilder<TInput, TServices, T, OutSchema, TDatabase, TDatabaseServiceName>;
+  /**
+   * Publish `event` to `topic` each time the cron has run successfully —
+   * repeatable, to as many topics as it names. The topic becomes a dependency
+   * as with `.dependsOn([topic])`, so `services.<topic>` is there too.
+   */
+  event<TTopic extends Topic<any, any>>(topic: TTopic, event: EventFor<TTopic, InferStandardSchema<OutSchema>>): CronBuilder<TInput, [...TServices, TTopic['service']], TLogger, OutSchema, TDatabase, TDatabaseServiceName>;
+  /**
+   * Set the database service for this cron job.
+   * The database will be available in the handler context as `db`.
+   */
+  database<T, TName extends string>(source: Consumable<TName, T> | Service<TName, T>): CronBuilder<TInput, TServices, TLogger, OutSchema, T, TName>;
+  handle(fn: FunctionHandler<TInput, TServices, TLogger, OutSchema, TDatabase>): Cron<TInput, TServices, TLogger, OutSchema, TDatabase, TDatabaseServiceName>;
+}
+//#endregion
+export { CronBuilder as t };
+//# sourceMappingURL=CronBuilder-Xx_zakuc.d.mts.map

package/dist/CronBuilder-Xx_zakuc.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CronBuilder-Xx_zakuc.d.mts","names":[],"sources":["../src/crons/CronBuilder.ts"],"mappings":";;;;;;;;;;cAuBa,YACZ,eAAe,0BACf,kBAAkB,WAClB,gBAAgB,SAAS,QACzB,kBAAkB,0CAClB,uBACA,sDACS,gBACT,QACA,WACA,WACA,4BAGA,WACA;UAEQ;EAER;EAIS,WAAW;EAIpB,SACC,aAAa,qBACX,YACF,QACA,WACA,SACA,WACA,WACA;EAKQ,MAAM,UAAU,0BACxB,QAAQ,IACN,YACF,GACA,WACA,SACA,WACA,WACA;EAcQ,OAAO,UAAU,kBACzB,QAAQ,IACN,YACF,QACA,WACA,SACA,GACA,WACA;;;;;;;;;;;;EAyBQ,gBAAgB,mBAAmB,cAC3C,YAAY,IACV,YACF,YACI,cAAc,WAAW,KAC7B,SACA,WACA,WACA;EA2BQ,SAAS,UAAU,WAC3B,UAAU,IACR,YACF,YACI,cAAc,IAClB,SACA,WACA,WACA;EAiBQ,OAAO,UAAU,QACzB,QAAQ,IACN,YACF,QACA,WACA,GACA,WACA,WACA;;;;;;EAmBQ,MAAM,eAAe,iBAC7B,OAAO,QACP,OAAO,SAAS,QAAQ,oBAAoB,cAC1C,YACF,YACI,WAAW,oBACf,SACA,WACA,WACA;;;;;EAgBQ,SAAS,GAAG,sBACpB,QAAQ,WAAW,OAAO,KAAK,QAAQ,OAAO,KAC5C,YAAY,QAAQ,WAAW,SAAS,WAAW,GAAG;EA8BhD,OACR,IAAI,gBAAgB,QAAQ,WAAW,SAAS,WAAW,aACzD,KACF,QACA,WACA,SACA,WACA,WACA"}

package/dist/CronBuilder-g1lZLWyG.d.cts

@@ -0,0 +1,47 @@
+import { t as StandardSchemaV1 } from "./index-CeEtxDmK.cjs";
+import { a as EventFor, c as Topic } from "./Construct-BQALFCh2.cjs";
+import { i as FunctionHandler } from "./Function-Pu-1kKZz.cjs";
+import { c as ServicesOf, r as Consumable } from "./construct-interface-B1AfqRl4.cjs";
+import { t as FunctionBuilder } from "./index-BuzRvKOQ.cjs";
+import { i as ScheduleExpression, t as Cron } from "./Cron-DI3nKoic.cjs";
+import { Logger } from "@geekmidas/logger";
+import { ComposableStandardSchema, InferStandardSchema } from "@geekmidas/schema";
+import { Service } from "@geekmidas/services";
+//#region src/crons/CronBuilder.d.ts
+declare class CronBuilder<TInput extends ComposableStandardSchema, TServices extends Service[], TLogger extends Logger = Logger, OutSchema extends StandardSchemaV1 | undefined = undefined, TDatabase = undefined, TDatabaseServiceName extends string = string> extends FunctionBuilder<TInput, OutSchema, TServices, TLogger, undefined, string, TDatabase, TDatabaseServiceName> {
+  private _schedule?;
+  constructor();
+  memorySize(memorySize: number): this;
+  schedule(_expression: ScheduleExpression): CronBuilder<TInput, TServices, TLogger, OutSchema, TDatabase, TDatabaseServiceName>;
+  input<T extends ComposableStandardSchema>(schema: T): CronBuilder<T, TServices, TLogger, OutSchema, TDatabase, TDatabaseServiceName>;
+  output<T extends StandardSchemaV1>(schema: T): CronBuilder<TInput, TServices, TLogger, T, TDatabase, TDatabaseServiceName>;
+  /**
+   * Depend on constructs — a database, a bucket, a mail sender, a queue, a
+   * topic.
+   *
+   * It records the edge and dissolves each construct's client into the
+   * handler's service record under the construct's own id, so
+   * `.dependsOn([uploads])` is what makes `services.uploads` exist and type.
+   *
+   * Constructs only. A `Service` does not match the shape, which is what keeps
+   * env sniffing confined to `.services()` and the explicit lift.
+   */
+  dependsOn<const T extends readonly Consumable[]>(constructs: T): CronBuilder<TInput, [...TServices, ...ServicesOf<T>], TLogger, OutSchema, TDatabase, TDatabaseServiceName>;
+  services<T extends Service[]>(services: T): CronBuilder<TInput, [...TServices, ...T], TLogger, OutSchema, TDatabase, TDatabaseServiceName>;
+  logger<T extends Logger>(logger: T): CronBuilder<TInput, TServices, T, OutSchema, TDatabase, TDatabaseServiceName>;
+  /**
+   * Publish `event` to `topic` each time the cron has run successfully —
+   * repeatable, to as many topics as it names. The topic becomes a dependency
+   * as with `.dependsOn([topic])`, so `services.<topic>` is there too.
+   */
+  event<TTopic extends Topic<any, any>>(topic: TTopic, event: EventFor<TTopic, InferStandardSchema<OutSchema>>): CronBuilder<TInput, [...TServices, TTopic['service']], TLogger, OutSchema, TDatabase, TDatabaseServiceName>;
+  /**
+   * Set the database service for this cron job.
+   * The database will be available in the handler context as `db`.
+   */
+  database<T, TName extends string>(source: Consumable<TName, T> | Service<TName, T>): CronBuilder<TInput, TServices, TLogger, OutSchema, T, TName>;
+  handle(fn: FunctionHandler<TInput, TServices, TLogger, OutSchema, TDatabase>): Cron<TInput, TServices, TLogger, OutSchema, TDatabase, TDatabaseServiceName>;
+}
+//#endregion
+export { CronBuilder as t };
+//# sourceMappingURL=CronBuilder-g1lZLWyG.d.cts.map

package/dist/CronBuilder-g1lZLWyG.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CronBuilder-g1lZLWyG.d.cts","names":[],"sources":["../src/crons/CronBuilder.ts"],"mappings":";;;;;;;;;;cAuBa,YACZ,eAAe,0BACf,kBAAkB,WAClB,gBAAgB,SAAS,QACzB,kBAAkB,0CAClB,uBACA,sDACS,gBACT,QACA,WACA,WACA,4BAGA,WACA;UAEQ;EAER;EAIS,WAAW;EAIpB,SACC,aAAa,qBACX,YACF,QACA,WACA,SACA,WACA,WACA;EAKQ,MAAM,UAAU,0BACxB,QAAQ,IACN,YACF,GACA,WACA,SACA,WACA,WACA;EAcQ,OAAO,UAAU,kBACzB,QAAQ,IACN,YACF,QACA,WACA,SACA,GACA,WACA;;;;;;;;;;;;EAyBQ,gBAAgB,mBAAmB,cAC3C,YAAY,IACV,YACF,YACI,cAAc,WAAW,KAC7B,SACA,WACA,WACA;EA2BQ,SAAS,UAAU,WAC3B,UAAU,IACR,YACF,YACI,cAAc,IAClB,SACA,WACA,WACA;EAiBQ,OAAO,UAAU,QACzB,QAAQ,IACN,YACF,QACA,WACA,GACA,WACA,WACA;;;;;;EAmBQ,MAAM,eAAe,iBAC7B,OAAO,QACP,OAAO,SAAS,QAAQ,oBAAoB,cAC1C,YACF,YACI,WAAW,oBACf,SACA,WACA,WACA;;;;;EAgBQ,SAAS,GAAG,sBACpB,QAAQ,WAAW,OAAO,KAAK,QAAQ,OAAO,KAC5C,YAAY,QAAQ,WAAW,SAAS,WAAW,GAAG;EA8BhD,OACR,IAAI,gBAAgB,QAAQ,WAAW,SAAS,WAAW,aACzD,KACF,QACA,WACA,SACA,WACA,WACA"}

package/dist/{Endpoint-BjWKinFA.d.mts → Endpoint-BWyKCa2x.d.cts}

@@ -1,16 +1,19 @@
-import { Function, FunctionHandler } from "./index-_ajboYxK.mjs";
-import { HttpMethod, LowerHttpMethod } from "./types-aKksMEWL.mjs";
-import { ComponentCollector, OpenApiSchemaOptions } from "@geekmidas/schema/openapi";
+import { t as StandardSchemaV1 } from "./index-CeEtxDmK.cjs";
+import { o as TopicEvent } from "./Construct-BQALFCh2.cjs";
+import { i as FunctionHandler, n as Function } from "./Function-Pu-1kKZz.cjs";
+import { t as Authenticator } from "./construct-interface-B1AfqRl4.cjs";
+import "./index-BuzRvKOQ.cjs";
+import { n as LowerHttpMethod, t as HttpMethod } from "./types-DMuSQeLL.cjs";
+import { t as EndpointTelemetry } from "./telemetry-B48RLjyk.cjs";
+import { i as AuthSession } from "./auth-BMCJN30Y.cjs";
 import { EnvironmentParser } from "@geekmidas/envkit";
+import { Logger } from "@geekmidas/logger";
+import { InferComposableStandardSchema, InferStandardSchema, InferStandardSchemaInput } from "@geekmidas/schema";
 import { Service, ServiceRecord } from "@geekmidas/services";
 import { AuditActor, AuditStorage, AuditableAction, Auditor, ExtractAuditPayload, ExtractAuditType } from "@geekmidas/audit";
 import { RateLimitConfig } from "@geekmidas/rate-limit";
-import { EventPublisher, ExtractPublisherMessage, MappedEvent } from "@geekmidas/events";
-import { Logger } from "@geekmidas/logger";
-import { InferComposableStandardSchema, InferStandardSchema, InferStandardSchemaInput } from "@geekmidas/schema";
-import { StandardSchemaV1 } from "@standard-schema/spec";
+import { ComponentCollector, OpenApiSchemaOptions } from "@geekmidas/schema/openapi";
 import { OpenAPIV3_1 } from "openapi-types";
-
 //#region src/endpoints/Authorizer.d.ts
 /**
  * OpenAPI 3.1 compliant security scheme definition.
@@ -57,38 +60,38 @@ interface OAuthFlow {
  */
 declare const BUILT_IN_SECURITY_SCHEMES: {
   readonly jwt: {
-    readonly type: "http";
-    readonly scheme: "bearer";
-    readonly bearerFormat: "JWT";
-    readonly description: "JWT Bearer token authentication";
+    readonly type: 'http';
+    readonly scheme: 'bearer';
+    readonly bearerFormat: 'JWT';
+    readonly description: 'JWT Bearer token authentication';
   };
   readonly bearer: {
-    readonly type: "http";
-    readonly scheme: "bearer";
-    readonly description: "Bearer token authentication";
+    readonly type: 'http';
+    readonly scheme: 'bearer';
+    readonly description: 'Bearer token authentication';
   };
   readonly apiKey: {
-    readonly type: "apiKey";
-    readonly in: "header";
-    readonly name: "X-API-Key";
-    readonly description: "API key authentication via header";
+    readonly type: 'apiKey';
+    readonly in: 'header';
+    readonly name: 'X-API-Key';
+    readonly description: 'API key authentication via header';
   };
   readonly oauth2: {
-    readonly type: "oauth2";
+    readonly type: 'oauth2';
     readonly flows: {};
-    readonly description: "OAuth 2.0 authentication";
+    readonly description: 'OAuth 2.0 authentication';
   };
   readonly oidc: {
-    readonly type: "openIdConnect";
-    readonly openIdConnectUrl: "";
-    readonly description: "OpenID Connect authentication";
+    readonly type: 'openIdConnect';
+    readonly openIdConnectUrl: '';
+    readonly description: 'OpenID Connect authentication';
   };
   readonly iam: {
-    readonly type: "apiKey";
-    readonly in: "header";
-    readonly name: "Authorization";
-    readonly description: "AWS IAM Signature Version 4 authentication";
-    readonly 'x-amazon-apigateway-authtype': "awsSigv4";
+    readonly type: 'apiKey';
+    readonly in: 'header';
+    readonly name: 'Authorization';
+    readonly description: 'AWS IAM Signature Version 4 authentication';
+    readonly 'x-amazon-apigateway-authtype': 'awsSigv4';
   };
 };
 /** Names of built-in security schemes */
@@ -133,7 +136,6 @@ declare function isBuiltInSecurityScheme(name: string): name is BuiltInSecurityS
  * Get a security scheme by name (built-in or custom)
  */
 declare function getSecurityScheme(name: string, customSchemes?: Record<string, SecurityScheme>): SecurityScheme | undefined;
-//# sourceMappingURL=Authorizer.d.ts.map
 //#endregion
 //#region src/endpoints/audit.d.ts
 /**
@@ -169,9 +171,6 @@ type ActorExtractor<TServices extends Service[] = [], TSession = unknown, TLogge
   cookie: CookieFn;
   logger: TLogger;
 }) => AuditActor | Promise<AuditActor>;
-/**
- * Configuration for the auditor on an endpoint.
- */
 //#endregion
 //#region src/endpoints/rls.d.ts
 /**
@@ -225,7 +224,23 @@ declare const RLS_BYPASS: unique symbol;
  * Type for RLS bypass marker.
  */
 type RlsBypass = typeof RLS_BYPASS;
-//# sourceMappingURL=rls.d.ts.map
+//#endregion
+//#region src/endpoints/sessionAuth.d.ts
+/**
+ * The surface's authenticator, as a session callback sees it.
+ *
+ * Bound to the request being handled, so reading the session takes no
+ * argument: `session(async ({ auth }) => auth.getSession())`.
+ */
+interface SessionAuth {
+  /** This request's session, verified by the `.auth()` construct — or `null`. */
+  getSession(): Promise<AuthSession | null>;
+}
+/** `auth.getSession()` was called on a surface that names no authenticator. */
+declare class NoAuthenticator extends Error {
+  readonly surface: string | undefined;
+  constructor(surface: string | undefined);
+}
 //#endregion
 //#region src/endpoints/Endpoint.d.ts
 /**
@@ -253,7 +268,7 @@ type RlsBypass = typeof RLS_BYPASS;
  * });
  * ```
  */
-declare class Endpoint<TRoute extends string, TMethod extends HttpMethod, TInput extends EndpointSchemas = {}, OutSchema extends StandardSchemaV1 | undefined = undefined, TServices extends Service[] = [], TLogger extends Logger = Logger, TSession = unknown, TEventPublisher extends EventPublisher<any> | undefined = undefined, TEventPublisherServiceName extends string = string, TAuditStorage extends AuditStorage | undefined = undefined, TAuditStorageServiceName extends string = string, TAuditAction extends AuditableAction<string, unknown> = AuditableAction<string, unknown>, TDatabase = undefined, TDatabaseServiceName extends string = string> extends Function<TInput, TServices, TLogger, OutSchema, TEventPublisher, TEventPublisherServiceName, TAuditStorage, TAuditStorageServiceName, TDatabase, TDatabaseServiceName, TAuditAction, FunctionHandler<TInput, TServices, TLogger, OutSchema, TDatabase, TAuditStorage, TAuditAction>> {
+declare class Endpoint<TRoute extends string, TMethod extends HttpMethod, TInput extends EndpointSchemas = {}, OutSchema extends StandardSchemaV1 | undefined = undefined, TServices extends Service[] = [], TLogger extends Logger = Logger, TSession = unknown, TAuditStorage extends AuditStorage | undefined = undefined, TAuditStorageServiceName extends string = string, TAuditAction extends AuditableAction<string, unknown> = AuditableAction<string, unknown>, TDatabase = undefined, TDatabaseServiceName extends string = string> extends Function<TInput, TServices, TLogger, OutSchema, TAuditStorage, TAuditStorageServiceName, TDatabase, TDatabaseServiceName, TAuditAction, FunctionHandler<TInput, TServices, TLogger, OutSchema, TDatabase, TAuditStorage, TAuditAction>> {
   operationId?: string;
   /** The route path pattern with parameter placeholders */
   route: TRoute;
@@ -271,18 +286,30 @@ declare class Endpoint<TRoute extends string, TMethod extends HttpMethod, TInput
   description?: string;
   /** Optional tags for OpenAPI documentation */
   tags?: string[];
-  /** The HTTP success status code to return (default: 200) */
-  readonly status: SuccessStatus;
+  /** The HTTP status code to return (default: 200) */
+  readonly status: EndpointStatus;
   /**
    * Response content type for this endpoint. Defaults to `'application/json'`.
    * Non-JSON types cause adaptors to emit the body as-is with the declared
    * Content-Type header instead of JSON-serializing.
    */
   readonly responseType: string;
+  /**
+   * This route's telemetry — `.telemetry({ ignore, attributes })` — read by
+   * the build, which hands it to the request middleware.
+   */
+  telemetry?: EndpointTelemetry;
   /** Default headers to apply to all responses */
   readonly defaultHeaders: Record<string, string>;
   /** Function to extract session data from the request context */
   getSession: SessionFn<TServices, TLogger, TSession, TDatabase>;
+  /**
+   * Whether a session callback was given — `.session()` on the factory it was
+   * built from. A generated handler reads the session only when it is, so
+   * an endpoint with a session and no authorizer must say so: it used to be
+   * handed `undefined` in a production build and its session in `gkm dev`.
+   */
+  readonly hasSession: boolean;
   /** Function to determine if the request is authorized */
   authorize: AuthorizeFn<TServices, TLogger, TSession, TInput, TDatabase>;
   /** Optional rate limiting configuration */
@@ -319,7 +346,7 @@ declare class Endpoint<TRoute extends string, TMethod extends HttpMethod, TInput
    * });
    * ```
    */
-  static buildOpenApiSchema(endpoints: Endpoint<any, any, any, any, any, any>[], options?: OpenApiSchemaOptions): Promise<OpenAPIV3_1.Document<{}>>;
+  static buildOpenApiSchema(endpoints: Endpoint<any, any, any, any, any, any>[], options?: OpenApiSchemaOptions): Promise<any>;
   /**
    * Gets the full path including HTTP method and route.
    * @returns Formatted string like 'GET /users/{id}'
@@ -343,6 +370,12 @@ declare class Endpoint<TRoute extends string, TMethod extends HttpMethod, TInput
    */
   parseBody(body: unknown): Promise<InferStandardSchema<TInput['body']>>;
   static isSuccessStatus(status: number): boolean;
+  /**
+   * Whether `status` sends the client elsewhere. A redirect has no body, so
+   * its response is not checked against the output schema, and what is
+   * derived from the output — declared events and audits — is not sent.
+   */
+  static isRedirectStatus(status: number | undefined): boolean;
   /**
    * Creates a case-insensitive header lookup function from a headers object.
    *
@@ -399,7 +432,7 @@ declare class Endpoint<TRoute extends string, TMethod extends HttpMethod, TInput
    * @internal
    */
   refineInput(ctx: EndpointContext<TInput, TServices, TLogger, TSession>): InferComposableStandardSchema<TInput>;
-  handler: (ctx: EndpointContext<TInput, TServices, TLogger, TSession, TAuditAction, TDatabase, TAuditStorage>, response: ResponseBuilder) => OutSchema extends StandardSchemaV1 ? InferStandardSchemaInput<OutSchema> | ResponseWithMetadata<InferStandardSchemaInput<OutSchema>> | Promise<InferStandardSchemaInput<OutSchema>> | Promise<ResponseWithMetadata<InferStandardSchemaInput<OutSchema>>> : any | ResponseWithMetadata<any> | Promise<any> | Promise<ResponseWithMetadata<any>>;
+  handler: (ctx: EndpointContext<TInput, TServices, TLogger, TSession, TAuditAction, TDatabase, TAuditStorage>, response: ResponseBuilder) => OutSchema extends StandardSchemaV1 ? InferStandardSchemaInput<OutSchema> | ResponseWithMetadata<InferStandardSchemaInput<OutSchema>> | Promise<InferStandardSchemaInput<OutSchema> | ResponseWithMetadata<InferStandardSchemaInput<OutSchema>>> : any | ResponseWithMetadata<any> | Promise<any> | Promise<ResponseWithMetadata<any>>;
   /**
    * Type guard to check if an object is an Endpoint instance.
    *
@@ -441,53 +474,8 @@ declare class Endpoint<TRoute extends string, TMethod extends HttpMethod, TInput
    * @param options.status - Success HTTP status code (default: 200)
    * @param options.authorizer - Optional authorizer configuration
    */
-  constructor({
-    fn,
-    method,
-    route,
-    description,
-    tags,
-    input,
-    logger,
-    output: outputSchema,
-    services,
-    constructs,
-    timeout,
-    memorySize,
-    getSession,
-    authorize,
-    rateLimit,
-    status,
-    publisherService,
-    events,
-    authorizer,
-    surface,
-    auditorStorageService,
-    actorExtractor,
-    audits,
-    databaseService,
-    rlsConfig,
-    rlsBypass,
-    responseType
-  }: EndpointOptions<TRoute, TMethod, TInput, OutSchema, TServices, TLogger, TSession, OutSchema, TEventPublisher, TEventPublisherServiceName, TAuditStorage, TAuditStorageServiceName, TAuditAction, TDatabase, TDatabaseServiceName>);
+  constructor({ fn, method, route, description, tags, input, logger, output: outputSchema, services, constructs, timeout, memorySize, getSession, authorize, rateLimit, status, events, authorizer, surface, auditorStorageService, actorExtractor, audits, databaseService, rlsConfig, rlsBypass, responseType, telemetry }: EndpointOptions<TRoute, TMethod, TInput, OutSchema, TServices, TLogger, TSession, OutSchema, TAuditStorage, TAuditStorageServiceName, TAuditAction, TDatabase, TDatabaseServiceName>);
 }
-/**
- * Defines the input schema structure for an endpoint.
- *
- * @template TBody - Schema for request body validation
- * @template TSearch - Schema for query string validation
- * @template TParams - Schema for URL path parameters validation
- *
- * @example
- * ```typescript
- * type UserInput = EndpointInput<
- *   typeof createUserBodySchema,
- *   typeof userQuerySchema,
- *   typeof userParamsSchema
- * >;
- * ```
- */
-
 /**
  * The surface an endpoint was built from.
  *
@@ -516,6 +504,11 @@ interface EndpointSurface {
    * file or throws on a missing variable would do it at build time.
    */
   envParser: EnvironmentParser<{}>;
+  /**
+   * What authenticates requests to this surface — the construct named in
+   * `RestApi.auth()`, which session callbacks read from as `auth`.
+   */
+  auth?: Authenticator;
 }
 /**
  * Configuration options for creating an Endpoint instance.
@@ -528,7 +521,7 @@ interface EndpointSurface {
  * @template TLogger - Logger type
  * @template TSession - Session data type
  */
-interface EndpointOptions<TRoute extends string, TMethod extends HttpMethod, TInput extends EndpointSchemas = {}, TOutput extends StandardSchemaV1 | undefined = undefined, TServices extends Service[] = [], TLogger extends Logger = Logger, TSession = unknown, OutSchema extends StandardSchemaV1 | undefined = undefined, TEventPublisher extends EventPublisher<any> | undefined = undefined, TEventPublisherServiceName extends string = string, TAuditStorage extends AuditStorage | undefined = undefined, TAuditStorageServiceName extends string = string, TAuditAction extends AuditableAction<string, unknown> = AuditableAction<string, unknown>, TDatabase = undefined, TDatabaseServiceName extends string = string> {
+interface EndpointOptions<TRoute extends string, TMethod extends HttpMethod, TInput extends EndpointSchemas = {}, TOutput extends StandardSchemaV1 | undefined = undefined, TServices extends Service[] = [], TLogger extends Logger = Logger, TSession = unknown, OutSchema extends StandardSchemaV1 | undefined = undefined, TAuditStorage extends AuditStorage | undefined = undefined, TAuditStorageServiceName extends string = string, TAuditAction extends AuditableAction<string, unknown> = AuditableAction<string, unknown>, TDatabase = undefined, TDatabaseServiceName extends string = string> {
   /** The route path with parameter placeholders */
   route: TRoute;
   /** The HTTP method for this endpoint */
@@ -565,12 +558,9 @@ interface EndpointOptions<TRoute extends string, TMethod extends HttpMethod, TIn
   /** Optional rate limiting configuration */
   rateLimit?: RateLimitConfig;
   /** Success HTTP status code */
-  status: SuccessStatus | undefined;
-  /**
-   * Event publisher service for publishing events from this endpoint
-   */
-  publisherService?: Service<TEventPublisherServiceName, TEventPublisher>;
-  events?: MappedEvent<TEventPublisher, OutSchema>[];
+  status: EndpointStatus | undefined;
+  /** What it publishes once its handler succeeds, each to its own topic. */
+  events?: TopicEvent[];
   /** Optional authorizer configuration */
   authorizer?: Authorizer;
   /** The surface this endpoint was built from. Every endpoint has one. */
@@ -594,6 +584,8 @@ interface EndpointOptions<TRoute extends string, TMethod extends HttpMethod, TIn
    * Defaults to `'application/json'` when omitted.
    */
   responseType?: string;
+  /** This route's telemetry — `.telemetry({ ignore, attributes })`. */
+  telemetry?: EndpointTelemetry;
 }
 /**
  * Defines the possible input schema types for an endpoint.
@@ -640,6 +632,12 @@ type BaseSessionContext<TServices extends Service[] = [], TLogger extends Logger
   logger: TLogger;
   header: HeaderFn;
   cookie: CookieFn;
+  /**
+   * The surface's authenticator — the construct named in `.auth()` — bound to
+   * this request: `await auth.getSession()` is this request's session, or
+   * `null`.
+   */
+  auth: SessionAuth;
 };
 /**
  * Conditional database context for session - only present when database service is configured
@@ -706,9 +704,9 @@ type ConvertRouteParams<T extends string> = T extends `${infer Start}:${infer Pa
  * // Results in: { '/users/{id}': { get: OperationObject, parameters?: ParameterObject[] } }
  * ```
  */
-type EndpointOpenApiSchema<TRoute extends string, TMethod extends HttpMethod> = { [key in ConvertRouteParams<TRoute>]: { [key in LowerHttpMethod<TMethod>]: OpenAPIV3_1.OperationObject<{}> } & {
+type EndpointOpenApiSchema<TRoute extends string, TMethod extends HttpMethod> = { [key in ConvertRouteParams<TRoute>]: { [key in LowerHttpMethod<TMethod>]: OpenAPIV3_1.OperationObject<{}>; } & {
   parameters?: OpenAPIV3_1.ParameterObject[];
-} };
+}; };
 /**
  * Function type for retrieving HTTP header values.
  * Supports two calling patterns:
@@ -770,7 +768,7 @@ interface ResponseMetadata {
     value: string;
     options?: CookieOptions;
   }>;
-  status?: SuccessStatus;
+  status?: EndpointStatus;
 }
 /**
  * Return type for handlers that want to set response metadata
@@ -787,7 +785,21 @@ declare class ResponseBuilder {
   header(key: string, value: string): this;
   cookie(name: string, value: string, options?: CookieOptions): this;
   deleteCookie(name: string, options?: Pick<CookieOptions, 'domain' | 'path'>): this;
-  status(code: SuccessStatus): this;
+  status(code: EndpointStatus): this;
+  /**
+   * Send the client to `url` — `Location` and a 3xx, with no body. 303 by
+   * default: after a form post, the browser follows it with a GET, so a
+   * reload does not post the form again.
+   *
+   * A redirect is not checked against the endpoint's `.output()` schema, so
+   * an endpoint that renders a page can redirect instead.
+   *
+   * @example
+   * ```typescript
+   * return response.cookie('session', token).redirect('/dashboard');
+   * ```
+   */
+  redirect(url: string, status?: RedirectStatus): ResponseWithMetadata<never>;
   send<T>(data: T): ResponseWithMetadata<T>;
   getMetadata(): ResponseMetadata;
 }
@@ -872,7 +884,7 @@ type EndpointContext<Input extends EndpointSchemas | undefined = undefined, TSer
  *   };
  * ```
  */
-type EndpointHandler<TInput extends EndpointSchemas | undefined = undefined, TServices extends Service[] = [], TLogger extends Logger = Logger, OutSchema extends StandardSchemaV1 | undefined = undefined, TSession = unknown, TDatabase = undefined, TAuditStorage = undefined, TAuditAction extends AuditableAction<string, unknown> = AuditableAction<string, unknown>> = (ctx: EndpointContext<TInput, TServices, TLogger, TSession, TAuditAction, TDatabase, TAuditStorage>, response: ResponseBuilder) => OutSchema extends StandardSchemaV1 ? InferStandardSchemaInput<OutSchema> | ResponseWithMetadata<InferStandardSchemaInput<OutSchema>> | Promise<InferStandardSchemaInput<OutSchema>> | Promise<ResponseWithMetadata<InferStandardSchemaInput<OutSchema>>> : unknown | ResponseWithMetadata<unknown> | Promise<unknown> | Promise<ResponseWithMetadata<unknown>>;
+type EndpointHandler<TInput extends EndpointSchemas | undefined = undefined, TServices extends Service[] = [], TLogger extends Logger = Logger, OutSchema extends StandardSchemaV1 | undefined = undefined, TSession = unknown, TDatabase = undefined, TAuditStorage = undefined, TAuditAction extends AuditableAction<string, unknown> = AuditableAction<string, unknown>> = (ctx: EndpointContext<TInput, TServices, TLogger, TSession, TAuditAction, TDatabase, TAuditStorage>, response: ResponseBuilder) => OutSchema extends StandardSchemaV1 ? InferStandardSchemaInput<OutSchema> | ResponseWithMetadata<InferStandardSchemaInput<OutSchema>> | Promise<InferStandardSchemaInput<OutSchema> | ResponseWithMetadata<InferStandardSchemaInput<OutSchema>>> : unknown | ResponseWithMetadata<unknown> | Promise<unknown> | Promise<ResponseWithMetadata<unknown>>;
 /**
  * HTTP success status codes that can be returned by endpoints.
  */
@@ -888,9 +900,27 @@ declare enum SuccessStatus {
   /** Server successfully processed the request and is not returning any content, client should reset the document view */
   ResetContent = 205,
   /** Server is delivering only part of the resource due to a range header */
-  PartialContent = 206,
+  PartialContent = 206
+}
+/**
+ * HTTP redirect status codes an endpoint can answer with —
+ * `response.redirect(url, status)`, or `.status()` with a `Location` header.
+ */
+declare enum RedirectStatus {
+  /** The resource has moved for good; a POST may become a GET */
+  MovedPermanently = 301,
+  /** The resource is elsewhere for now; a POST may become a GET */
+  Found = 302,
+  /** See the resource elsewhere, with a GET — the answer to a form post */
+  SeeOther = 303,
+  /** The resource is elsewhere for now; the method and body are kept */
+  TemporaryRedirect = 307,
+  /** The resource has moved for good; the method and body are kept */
+  PermanentRedirect = 308
 }
+/** A status an endpoint answers with when its handler succeeds. */
+type EndpointStatus = SuccessStatus | RedirectStatus;
 type EndpointOutput<T> = T extends Endpoint<any, any, any, infer OutSchema, any, any, any, any> ? InferStandardSchema<OutSchema> : never;
 //#endregion
-export { ActorExtractor, AuthorizeFn, Authorizer, BUILT_IN_SECURITY_SCHEMES, BuiltInSecuritySchemeId, CookieFn, Endpoint, EndpointContext, EndpointHandler, EndpointOutput, EndpointSchemas, EndpointSurface, HeaderFn, MappedAudit, OAuthFlow, OAuthFlows, RLS_BYPASS, ResponseBuilder, RlsBypass, RlsConfig, RlsContext, RlsContextExtractor, SecurityScheme, SessionFn, SuccessStatus, createAuthorizer, getSecurityScheme, isBuiltInSecurityScheme };
-//# sourceMappingURL=Endpoint-BjWKinFA.d.mts.map
+export { SecurityScheme as A, ActorExtractor as C, BuiltInSecuritySchemeId as D, BUILT_IN_SECURITY_SCHEMES as E, getSecurityScheme as M, isBuiltInSecurityScheme as N, OAuthFlow as O, RlsContextExtractor as S, Authorizer as T, SessionAuth as _, EndpointContext as a, RlsConfig as b, EndpointSchemas as c, HeaderFn as d, RedirectStatus as f, NoAuthenticator as g, SuccessStatus as h, Endpoint as i, createAuthorizer as j, OAuthFlows as k, EndpointStatus as l, SessionFn as m, ConvertRouteParams as n, EndpointHandler as o, ResponseBuilder as p, CookieFn as r, EndpointOutput as s, AuthorizeFn as t, EndpointSurface as u, RLS_BYPASS as v, MappedAudit as w, RlsContext as x, RlsBypass as y };
+//# sourceMappingURL=Endpoint-BWyKCa2x.d.cts.map

package/dist/Endpoint-BWyKCa2x.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Endpoint-BWyKCa2x.d.cts","names":[],"sources":["../src/endpoints/Authorizer.ts","../src/endpoints/audit.ts","../src/endpoints/rls.ts","../src/endpoints/sessionAuth.ts","../src/endpoints/Endpoint.ts"],"mappings":"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"}