better-supabase 0.7.1 → 0.9.0

package/dist/blocks/pipelines/index.js

@@ -0,0 +1,204 @@
+import { t as AsyncResult } from "../../result-BlgnMB0H.js";
+import { n as event, t as defineEvents } from "../../event-map-Dy2vKHai.js";
+import { i as sqlTransport, r as rpcTransport, t as dbTransport } from "../../block-transport-G4t1umrR.js";
+import { A as requiredInstant, C as optionalText, D as recordOf, I as textOf, d as enumOrThrow, k as recordsOf, m as instantArg, n as applyTemporal, o as blockCall } from "../../block-helpers-CfG_MvDR.js";
+import { i as wrapTransport, n as extendBlock, r as withBlockHooks } from "../../block-hooks-BsXncUlZ.js";
+import { a as readAllFields, l as writeFields, n as blockFields, o as readFields, s as rowFields } from "../../block-fields-ffD6Gxe4.js";
+import { n as defineBlock } from "../../define-block-B6Gjs57G.js";
+import { t as rankBetweenResult } from "../../rank-result-DS8IoLup.js";
+import { i as moneyOf } from "../../money-codec-C_-K5ZUU.js";
+import { t as pipelinesSqlOptions } from "../../options-n22NK3PL.js";
+//#region src/blocks/pipelines/pipelines.ts
+const OUTCOMES = [
+	"open",
+	"success",
+	"failure"
+];
+const numberOf = (value) => typeof value === "number" ? value : void 0;
+function stageOf(value) {
+	const row = recordOf(value, "pipeline stage");
+	const systemKey = optionalText(row["system_key"]);
+	const color = optionalText(row["color"]);
+	const probability = numberOf(row["probability"]);
+	const rotting = numberOf(row["rotting_after_days"]);
+	const wipLimit = numberOf(row["wip_limit"]);
+	return {
+		id: textOf(row["id"]),
+		pipelineId: textOf(row["pipeline_id"]),
+		key: textOf(row["key"]),
+		name: textOf(row["name"]),
+		rank: textOf(row["rank"]),
+		category: textOf(row["category"]),
+		outcome: enumOrThrow(row["outcome"], OUTCOMES, "pipeline stage outcome"),
+		...systemKey === void 0 ? {} : { systemKey },
+		...color === void 0 ? {} : { color },
+		...probability === void 0 ? {} : { probability },
+		...rotting === void 0 ? {} : { rottingAfterDays: rotting },
+		...wipLimit === void 0 ? {} : { wipLimit }
+	};
+}
+function pipelineOf(value) {
+	const row = recordOf(value, "pipeline");
+	const scopeId = optionalText(row["scope_id"]);
+	return {
+		id: textOf(row["id"]),
+		organizationId: textOf(row["tenant_id"]),
+		subjectType: textOf(row["subject_type"]),
+		key: textOf(row["key"]),
+		name: textOf(row["name"]),
+		rank: textOf(row["rank"]),
+		isDefault: row["is_default"] === true,
+		stages: recordsOf(row["stages"], "pipeline stages").map(stageOf),
+		fields: rowFields(row["fields"]),
+		...scopeId === void 0 ? {} : { scopeId }
+	};
+}
+function columnOf(value) {
+	const row = recordOf(value, "pipeline_board");
+	const color = optionalText(row["color"]);
+	const probability = numberOf(row["probability"]);
+	const wipLimit = numberOf(row["wipLimit"]);
+	return {
+		stageId: textOf(row["stageId"]),
+		key: textOf(row["key"]),
+		name: textOf(row["name"]),
+		category: textOf(row["category"]),
+		outcome: enumOrThrow(row["outcome"], OUTCOMES, "pipeline stage outcome"),
+		count: numberOf(row["count"]) ?? 0,
+		overLimit: row["overLimit"] === true,
+		totals: recordsOf(row["totals"], "pipeline_board totals").map((total) => {
+			const currency = textOf(total["currency"]);
+			return {
+				currency,
+				amount: moneyOf(total["amount"], currency, "pipeline total amount"),
+				weighted: moneyOf(total["weighted"], currency, "pipeline total weighted")
+			};
+		}),
+		...color === void 0 ? {} : { color },
+		...probability === void 0 ? {} : { probability },
+		...wipLimit === void 0 ? {} : { wipLimit }
+	};
+}
+function statsOf(value) {
+	const row = recordOf(value, "pipeline_stats");
+	const winRate = numberOf(row["winRate"]);
+	return {
+		won: numberOf(row["won"]) ?? 0,
+		lost: numberOf(row["lost"]) ?? 0,
+		...winRate === void 0 ? {} : { winRate },
+		stages: recordsOf(row["stages"], "pipeline_stats stages").map((stage) => {
+			const averageSeconds = numberOf(stage["averageSeconds"]);
+			return {
+				stageId: textOf(stage["stageId"]),
+				key: textOf(stage["key"]),
+				entered: numberOf(stage["entered"]) ?? 0,
+				...averageSeconds === void 0 ? {} : { averageSeconds }
+			};
+		})
+	};
+}
+function healthOf(value) {
+	const row = recordOf(value, "pipeline_health");
+	return {
+		subjectType: textOf(row["subjectType"]),
+		subjectId: textOf(row["subjectId"]),
+		stageId: textOf(row["stageId"]),
+		enteredAt: requiredInstant(row["enteredAt"], "enteredAt"),
+		daysInStage: numberOf(row["daysInStage"]) ?? 0,
+		rotting: row["rotting"] === true
+	};
+}
+/**
+* The pipelines block: tenant-editable pipelines and stages for the subject
+* types `blocks.pipelines.options.subjects` binds, and the board,
+* stats and health reads over them. Moving a record is a plain update of
+* its stage column, or `rank.move` with the stage id as the group.
+*/
+function createPipelines(options) {
+	applyTemporal(options);
+	const call = blockCall(options.transport, options.schema, options.mappers);
+	const fields = blockFields(options.fields, "pipeline fields");
+	return withBlockHooks({
+		list: (organizationId, subjectType) => call("list_pipelines", {
+			tenant: organizationId,
+			subject_type: subjectType
+		}, (value) => recordsOf(value, "list_pipelines").map(pipelineOf)).andThen((pipelines) => readAllFields(fields, pipelines)),
+		save: (organizationId, input) => writeFields(fields, input.fields, (checked) => call("save_pipeline", {
+			tenant: organizationId,
+			pipeline: input.id ?? null,
+			subject_type: input.subjectType,
+			key: input.key,
+			name: input.name,
+			scope_id: input.scopeId ?? null,
+			is_default: input.isDefault ?? null,
+			fields: checked
+		}, pipelineOf)).andThen((pipeline) => readFields(fields, pipeline)),
+		archive: (pipelineId) => call("archive_pipeline", { pipeline: pipelineId }, (value) => value === true),
+		saveStage: (pipelineId, input) => call("save_pipeline_stage", {
+			pipeline: pipelineId,
+			stage: input.id ?? null,
+			key: input.key,
+			name: input.name,
+			category: input.category,
+			probability: input.probability ?? null,
+			rotting_after_days: input.rottingAfterDays ?? null,
+			wip_limit: input.wipLimit ?? null,
+			color: input.color ?? null
+		}, stageOf),
+		reorderStage: (stageId, neighbors) => {
+			const key = rankBetweenResult(neighbors);
+			if (!key.ok) return AsyncResult.err(key.error);
+			return call("rank_pipeline_stage", {
+				stage: stageId,
+				rank: key.data
+			}, () => key.data);
+		},
+		archiveStage: (stageId) => call("archive_pipeline_stage", { stage: stageId }, (value) => value === true),
+		setTransitions: (pipelineId, transitions) => call("set_pipeline_transitions", {
+			pipeline: pipelineId,
+			pairs: transitions.map((item) => ({
+				from: item.from,
+				to: item.to
+			}))
+		}, (value) => numberOf(value) ?? 0),
+		board: (subjectType, pipelineId, board = {}) => call("pipeline_board", {
+			subject_type: subjectType,
+			pipeline: pipelineId,
+			owner: board.owner ?? null
+		}, (value) => recordsOf(value, "pipeline_board").map(columnOf)),
+		stats: (pipelineId, window) => call("pipeline_stats", {
+			pipeline: pipelineId,
+			since: instantArg(window.since),
+			until: instantArg(window.until)
+		}, statsOf),
+		health: (pipelineId) => call("pipeline_health", { pipeline: pipelineId }, (value) => recordsOf(value, "pipeline_health").map(healthOf))
+	}, options.hooks, {
+		block: "pipelines",
+		...options.logger ? { logger: options.logger } : {}
+	});
+}
+//#endregion
+//#region src/blocks/pipelines/events.ts
+/** The `pipelines` block's event types, for its manifest and `onBlockEvent`. */
+const pipelinesEvents = defineEvents({
+	"pipeline.created": event(),
+	"pipeline.updated": event(),
+	"pipeline.archived": event(),
+	"pipeline_stage.saved": event(),
+	"pipeline_stage.archived": event(),
+	"pipeline.stage_changed": event()
+});
+//#endregion
+//#region src/blocks/pipelines/manifest.ts
+/** The `pipelines` block's manifest (ADR 0029). */
+const pipelinesBlock = defineBlock({
+	name: "pipelines",
+	sql: ["pipelines"],
+	options: { pipelines: pipelinesSqlOptions },
+	events: pipelinesEvents,
+	create: createPipelines,
+	category: "work",
+	recipes: ["deal-board"]
+});
+//#endregion
+export { createPipelines, dbTransport, extendBlock, pipelinesBlock, pipelinesEvents, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };

package/dist/blocks/profiles/index.d.ts

@@ -1,18 +1,19 @@
-import { t as AsyncResult, w as ErrorMapper } from "../../result-D7y2fT87.js";
-import { i as sqlTransport, n as RpcClient, r as rpcTransport, t as BlockTransport } from "../../block-transport-DvaoPuZ9.js";
+import { t as AsyncResult, w as ErrorMapper } from "../../result-Cj3yWhjH.js";
 import { n as Logger } from "../../logger-DWVYUmwi.js";
-import { t as StandardSchemaV1 } from "../../standard-CYsm7xpT.js";
-import { r as BlockTemporalOptions } from "../../block-helpers-CKtbFcRv.js";
-import { a as BlockTransportMiddleware, d as extendBlock, f as withBlockHooks, n as BlockHooks, p as wrapTransport } from "../../block-hooks-plbZ0AbJ.js";
-import { n as FieldsOf } from "../../block-fields-SJ6fEf3o.js";
+import { t as StandardSchemaV1 } from "../../standard-C3_AAF3g.js";
+import { a as dbTransport, i as RpcClient, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-DaGGXjIw.js";
+import { r as BlockTemporalOptions } from "../../block-helpers-C86hPEjI.js";
+import { a as BlockTransportMiddleware, d as extendBlock, f as withBlockHooks, n as BlockHooks, p as wrapTransport } from "../../block-hooks-BLPWD3Jt.js";
+import { r as FieldsOf } from "../../block-fields-5UA84ZUg.js";
+import { s as BlockOf } from "../../define-block-CLZMEFeK.js";
 //#region src/blocks/profiles/profiles.d.ts
 interface ProfilesOptions<S extends StandardSchemaV1 | undefined = undefined> extends BlockTemporalOptions {
   readonly transport: BlockTransport;
-  /** `sql.modules.profiles.schema`, or the API schema of its wrappers. */
+  /** The module schema, or its API schema: `defineBlocks` passes it from `blocks.generated.ts`. */
   readonly schema?: string;
   /**
    * A Standard Schema for the profile columns the app adds
-   * (`sql.modules.profiles.options.extraColumns`), keyed by database name.
+   * (`blocks.profiles.options.extraColumns`), keyed by database name.
    * It types and parses them on `mine()`, and validates them on
    * `updateMine`, which returns a `validation` error for a bad value. The
    * parsed fields are merged over the row, so the other columns stay.
@@ -37,4 +38,8 @@ interface Profiles<F extends object = Record<never, never>> {
  */
 export declare function createProfiles<S extends StandardSchemaV1 | undefined = undefined>(options: ProfilesOptions<S>): Profiles<FieldsOf<S>>;
 //#endregion
-export { type BlockHooks, type BlockTransport, type BlockTransportMiddleware, type Profile, type Profiles, type ProfilesOptions, type RpcClient, extendBlock, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };
+//#region src/blocks/profiles/manifest.d.ts
+/** The `profiles` block's manifest (ADR 0029). */
+export declare const profilesBlock: BlockOf<"profiles", typeof createProfiles>;
+//#endregion
+export { type BlockHooks, type BlockTransport, type BlockTransportMiddleware, type Profile, type Profiles, type ProfilesOptions, type RpcClient, dbTransport, extendBlock, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };

package/dist/blocks/profiles/index.js

@@ -1,8 +1,11 @@
-import { a as ok, t as AsyncResult } from "../../result-DzUbqgdW.js";
-import { n as rpcTransport, r as sqlTransport } from "../../block-transport-BLr-ZgLc.js";
-import { d as isRecord, i as blockCall, n as applyTemporal } from "../../block-helpers-DWHxHsEQ.js";
-import { i as wrapTransport, n as extendBlock, r as withBlockHooks } from "../../block-hooks-BmjMyXTa.js";
-import { t as blockFields } from "../../block-fields-GFkxl4dP.js";
+import { a as ok, t as AsyncResult } from "../../result-BlgnMB0H.js";
+import { n as isRecord } from "../../guards-6F2bCtQR.js";
+import { i as sqlTransport, r as rpcTransport, t as dbTransport } from "../../block-transport-G4t1umrR.js";
+import { n as applyTemporal, o as blockCall } from "../../block-helpers-CfG_MvDR.js";
+import { i as wrapTransport, n as extendBlock, r as withBlockHooks } from "../../block-hooks-BsXncUlZ.js";
+import { n as blockFields } from "../../block-fields-ffD6Gxe4.js";
+import { n as defineBlock } from "../../define-block-B6Gjs57G.js";
+import { t as profilesSqlOptions } from "../../options-DNKyN5uq.js";
 //#region src/blocks/profiles/profiles.ts
 /**
 * The `profiles` SQL module as typed calls. `mine` and `updateMine` are the
@@ -25,4 +28,15 @@ function createProfiles(options) {
 	});
 }
 //#endregion
-export { createProfiles, extendBlock, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };
+//#region src/blocks/profiles/manifest.ts
+/** The `profiles` block's manifest (ADR 0029). */
+const profilesBlock = defineBlock({
+	name: "profiles",
+	sql: ["profiles"],
+	options: { profiles: profilesSqlOptions },
+	create: createProfiles,
+	category: "tenancy",
+	recipes: ["profile-form"]
+});
+//#endregion
+export { createProfiles, dbTransport, extendBlock, profilesBlock, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };

package/dist/blocks/promotions/index.d.ts

@@ -0,0 +1,125 @@
+/// <reference lib="esnext.temporal" />
+import { t as AsyncResult } from "../../result-Cj3yWhjH.js";
+import { M as CommerceEventData, wt as Events } from "../../events-CTreRrgP.js";
+import { n as Logger } from "../../logger-DWVYUmwi.js";
+import { t as StandardSchemaV1 } from "../../standard-C3_AAF3g.js";
+import { a as dbTransport, i as RpcClient, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-DaGGXjIw.js";
+import { n as BlockOptions } from "../../block-helpers-C86hPEjI.js";
+import { a as BlockTransportMiddleware, d as extendBlock, f as withBlockHooks, n as BlockHooks, p as wrapTransport } from "../../block-hooks-BLPWD3Jt.js";
+import { i as RowFields, r as FieldsOf } from "../../block-fields-5UA84ZUg.js";
+import { s as BlockOf } from "../../define-block-CLZMEFeK.js";
+import { n as Money } from "../../money-DFpWzQvk.js";
+import { g as PROMOTION_KINDS } from "../../codecs-Bm46sVxr.js";
+//#region src/blocks/promotions/promotions.d.ts
+type PromotionKind = (typeof PROMOTION_KINDS)[number];
+export declare const PROMOTION_SCOPES: readonly ["order", "products", "categories", "collections"];
+type PromotionScope = (typeof PROMOTION_SCOPES)[number];
+/** What a promotion takes off. */
+type PromotionDiscount = {
+  readonly kind: "percentage";
+  /** Above 0 and at most 100, with up to two decimals, such as `"12.5"`. */
+  readonly percent: string;
+} | {
+  readonly kind: "fixed";
+  readonly amount: Money;
+} | {
+  readonly kind: "free_shipping";
+};
+interface PromotionsOptions<S extends StandardSchemaV1 | undefined = undefined> extends BlockOptions {
+  /**
+   * A Standard Schema for the extra columns of the promotions table
+   * (`blocks.promotions.options.extraColumns`): writes are validated, reads
+   * parsed.
+   */
+  readonly fields?: S;
+  /** `withBlockHooks` hooks around any promotions method. */
+  readonly hooks?: NoInfer<BlockHooks<Promotions<FieldsOf<S>>>>;
+  /** Receives the errors `after` hooks throw. Default: `console`. */
+  readonly logger?: Logger;
+}
+interface PromotionInput<F extends object = Record<never, never>> {
+  /** Updates this promotion; creates one when left out. */
+  readonly id?: string;
+  readonly name: string;
+  readonly description?: string;
+  readonly discount: PromotionDiscount;
+  /** The cart subtotal before discounts that the promotion needs. */
+  readonly minSubtotal?: Money;
+  /** Default `order`, the whole cart. */
+  readonly scope?: PromotionScope;
+  /** Product, category or collection ids for the other scopes. A category includes its children. */
+  readonly targets?: readonly string[];
+  readonly startsAt?: Temporal.Instant;
+  readonly endsAt?: Temporal.Instant;
+  /** Redemptions across every customer. */
+  readonly usageLimit?: number;
+  /** Redemptions per customer, counted by user id and by email. */
+  readonly perCustomerLimit?: number;
+  /** Combines with other stackable promotions. Default `false`. */
+  readonly stackable?: boolean;
+  /** Higher applies first. Default `0`. */
+  readonly priority?: number;
+  /** Applies to every cart it fits without a code. Default `false`. */
+  readonly automatic?: boolean;
+  /** Default `true`. */
+  readonly active?: boolean;
+  /** Values for the app's extra columns (`options.extraColumns`); left out keeps the stored ones. */
+  readonly fields?: Partial<F> & Readonly<Record<string, unknown>>;
+}
+/** A saved promotion: its id and the app's extra columns. */
+interface SavedPromotion<F extends object = Record<never, never>> {
+  readonly id: string;
+  /** The app's extra columns (`options.extraColumns`), by column name. */
+  readonly fields: RowFields<F>;
+}
+interface CodeLimit {
+  /** Redemptions of each code. */
+  readonly usageLimit?: number;
+}
+/** Explicit codes, or `count` generated ones. */
+type CodesInput = (CodeLimit & {
+  readonly codes: readonly string[];
+}) | (CodeLimit & {
+  readonly count: number;
+  /** Put before 8 random characters, such as `BF-`. */
+  readonly prefix?: string;
+});
+interface PromotionCode {
+  readonly id: string;
+  readonly code: string;
+}
+interface AppliedCode {
+  readonly codeId: string;
+  readonly code: string;
+  readonly promotionId: string;
+}
+interface Promotions<F extends object = Record<never, never>> {
+  /** Refused with `PROMOTIONS_INVALID` when the discount, limits or targets don't fit. */
+  savePromotion(organizationId: string, input: PromotionInput<F>): AsyncResult<SavedPromotion<F>>;
+  setPromotionActive(promotionId: string, active: boolean): AsyncResult<boolean>;
+  /** Refused with `PROMOTIONS_IN_USE` once an order redeemed it; deactivate it instead. */
+  deletePromotion(promotionId: string): AsyncResult<boolean>;
+  /** Codes are stored upper case. Refused with `PROMOTIONS_CODE_TAKEN` for a code the organization has. */
+  createCodes(promotionId: string, input: CodesInput): AsyncResult<readonly PromotionCode[]>;
+  deleteCode(codeId: string): AsyncResult<boolean>;
+  /** Adds a code to the shopper's cart; `priceCart` then shows the discount. */
+  applyCode(cartId: string, code: string): AsyncResult<AppliedCode>;
+  /** Resolves to `false` when the cart didn't hold the code. */
+  removeCode(cartId: string, code: string): AsyncResult<boolean>;
+}
+/** Coupons, codes, usage limits and stacking rules over the `promotions` SQL module; `orders` prices them into carts. */
+export declare function createPromotions<S extends StandardSchemaV1 | undefined = undefined>(options: PromotionsOptions<S>): Promotions<FieldsOf<S>>;
+//#endregion
+//#region src/blocks/promotions/events.d.ts
+/** The events of the `promotions` block: type to data. */
+type PromotionsEvents = {
+  readonly "promotion.redeemed": CommerceEventData;
+};
+/** The `promotions` block's event types, for its manifest and `onBlockEvent`. */
+export declare const promotionsEvents: Events<PromotionsEvents>;
+//#endregion
+//#region src/blocks/promotions/manifest.d.ts
+/** The `promotions` block's manifest (ADR 0029). */
+export declare const promotionsBlock: BlockOf<"promotions", typeof createPromotions, PromotionsEvents>;
+//#endregion
+export { type AppliedCode, type BlockHooks, type BlockTransport, type BlockTransportMiddleware, type CodesInput, PROMOTION_KINDS, type PromotionCode, type PromotionDiscount, type PromotionInput, type PromotionKind, type PromotionScope, type Promotions, type PromotionsEvents, type PromotionsOptions, type RpcClient, type SavedPromotion, dbTransport, extendBlock, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };

package/dist/blocks/promotions/index.js

@@ -0,0 +1,123 @@
+import { n as dbError } from "../../errors-8i6tSICm.js";
+import { t as AsyncResult } from "../../result-BlgnMB0H.js";
+import { n as isRecord } from "../../guards-6F2bCtQR.js";
+import { n as event, t as defineEvents } from "../../event-map-Dy2vKHai.js";
+import { i as sqlTransport, r as rpcTransport, t as dbTransport } from "../../block-transport-G4t1umrR.js";
+import { D as recordOf, I as textOf, m as instantArg, n as applyTemporal, o as blockCall } from "../../block-helpers-CfG_MvDR.js";
+import { i as wrapTransport, n as extendBlock, r as withBlockHooks } from "../../block-hooks-BsXncUlZ.js";
+import { l as writeFields, n as blockFields, o as readFields, s as rowFields } from "../../block-fields-ffD6Gxe4.js";
+import { n as defineBlock } from "../../define-block-B6Gjs57G.js";
+import { r as PROMOTION_KINDS } from "../../codecs-YAekuQ08.js";
+import { t as promotionsSqlOptions } from "../../options-BZsoPJGX.js";
+//#region src/blocks/promotions/promotions.ts
+const PROMOTION_SCOPES = [
+	"order",
+	"products",
+	"categories",
+	"collections"
+];
+const isTrue = (value) => value === true;
+function promotionData(input) {
+	const { discount, minSubtotal } = input;
+	const currency = discount.kind === "fixed" ? discount.amount.currency : minSubtotal?.currency;
+	if (discount.kind === "fixed" && minSubtotal !== void 0 && minSubtotal.currency !== discount.amount.currency) return `the minimum subtotal is in ${minSubtotal.currency}, the discount in ${discount.amount.currency}`;
+	return {
+		name: input.name,
+		description: input.description ?? null,
+		kind: discount.kind,
+		percent: discount.kind === "percentage" ? discount.percent : null,
+		amount: discount.kind === "fixed" ? discount.amount.amount.toString() : null,
+		currency: currency ?? null,
+		minSubtotal: minSubtotal?.amount.toString() ?? null,
+		scope: input.scope ?? "order",
+		targets: input.targets ?? [],
+		startsAt: instantArg(input.startsAt) ?? null,
+		endsAt: instantArg(input.endsAt) ?? null,
+		usageLimit: input.usageLimit ?? null,
+		perCustomerLimit: input.perCustomerLimit ?? null,
+		stackable: input.stackable ?? false,
+		priority: input.priority ?? 0,
+		automatic: input.automatic ?? false,
+		active: input.active ?? true
+	};
+}
+function codesOf(value) {
+	if (!Array.isArray(value)) return [];
+	return value.filter(isRecord).map((entry) => ({
+		id: textOf(entry["id"]),
+		code: textOf(entry["code"])
+	}));
+}
+/** Coupons, codes, usage limits and stacking rules over the `promotions` SQL module; `orders` prices them into carts. */
+function createPromotions(options) {
+	applyTemporal(options);
+	const call = blockCall(options.transport, options.schema, options.mappers);
+	const fields = blockFields(options.fields, "promotion fields");
+	return withBlockHooks({
+		savePromotion: (organizationId, input) => {
+			const data = promotionData(input);
+			if (typeof data === "string") return AsyncResult.err(dbError("invalid_request", data, { hint: "PROMOTIONS_INVALID" }));
+			return writeFields(fields, input.fields, (checked) => call("save_promotion", {
+				tenant: organizationId,
+				promotion: input.id ?? null,
+				data,
+				fields: checked
+			}, (value) => {
+				const row = recordOf(value, "save_promotion");
+				return {
+					id: textOf(row["id"]),
+					fields: rowFields(row["fields"])
+				};
+			})).andThen((saved) => readFields(fields, saved));
+		},
+		setPromotionActive: (promotionId, active) => call("set_promotion_active", {
+			promotion: promotionId,
+			active
+		}, isTrue),
+		deletePromotion: (promotionId) => call("delete_promotion", { promotion: promotionId }, isTrue),
+		createCodes: (promotionId, input) => call("create_promotion_codes", {
+			promotion: promotionId,
+			codes: "codes" in input ? input.codes : null,
+			count: "count" in input ? input.count : null,
+			prefix: "count" in input ? input.prefix ?? null : null,
+			usage_limit: input.usageLimit ?? null
+		}, codesOf),
+		deleteCode: (codeId) => call("delete_promotion_code", { code: codeId }, isTrue),
+		applyCode: (cartId, code) => call("apply_promotion_code", {
+			cart: cartId,
+			code
+		}, (value) => {
+			const row = recordOf(value, "apply_promotion_code");
+			return {
+				codeId: textOf(row["codeId"]),
+				code: textOf(row["code"]),
+				promotionId: textOf(row["promotionId"])
+			};
+		}),
+		removeCode: (cartId, code) => call("remove_promotion_code", {
+			cart: cartId,
+			code
+		}, isTrue)
+	}, options.hooks, {
+		block: "promotions",
+		...options.logger ? { logger: options.logger } : {}
+	});
+}
+//#endregion
+//#region src/blocks/promotions/events.ts
+/** The `promotions` block's event types, for its manifest and `onBlockEvent`. */
+const promotionsEvents = defineEvents({ "promotion.redeemed": event() });
+//#endregion
+//#region src/blocks/promotions/manifest.ts
+/** The `promotions` block's manifest (ADR 0029). */
+const promotionsBlock = defineBlock({
+	name: "promotions",
+	sql: ["promotions"],
+	options: { promotions: promotionsSqlOptions },
+	events: promotionsEvents,
+	create: createPromotions,
+	category: "commerce",
+	recipes: ["promotion-code-field"]
+});
+//#endregion
+export { PROMOTION_KINDS, PROMOTION_SCOPES, createPromotions, dbTransport, extendBlock, promotionsBlock, promotionsEvents, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };

package/dist/blocks/push/index.d.ts

@@ -1,58 +1,65 @@
-import { t as AsyncResult, w as ErrorMapper } from "../../result-D7y2fT87.js";
-import { i as sqlTransport, r as rpcTransport, t as BlockTransport } from "../../block-transport-DvaoPuZ9.js";
-import { r as BlockTemporalOptions } from "../../block-helpers-CKtbFcRv.js";
-import { n as NotificationMessage, t as NotificationChannel } from "../../channel-_2Mx1Oyu.js";
+import { t as AsyncResult, w as ErrorMapper } from "../../result-Cj3yWhjH.js";
+import { Q as PushDeviceEventData, wt as Events } from "../../events-CTreRrgP.js";
+import { n as Logger } from "../../logger-DWVYUmwi.js";
+import { t as StandardSchemaV1 } from "../../standard-C3_AAF3g.js";
+import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-DaGGXjIw.js";
+import { r as BlockTemporalOptions } from "../../block-helpers-C86hPEjI.js";
+import { n as BlockHooks } from "../../block-hooks-BLPWD3Jt.js";
+import { i as RowFields, r as FieldsOf } from "../../block-fields-5UA84ZUg.js";
+import { s as BlockOf } from "../../define-block-CLZMEFeK.js";
+import { n as NotificationMessage, t as NotificationChannel } from "../../channel-D-LHCY11.js";
+import { t as ExpoNotificationsLike } from "../../push-token-asrmi7-6.js";
 //#region src/blocks/push/push.d.ts
 type PushPlatform = "ios" | "android" | "web";
 type PushProvider = "expo" | "fcm" | "apns" | "webpush";
-interface PushDeviceInput {
+/** A device to register. `F` types the extra columns the `fields` schema describes. */
+interface PushDeviceInput<F extends object = Record<never, never>> {
   readonly token: string;
   readonly platform: PushPlatform;
   /** Defaults to `expo`. */
   readonly provider?: PushProvider;
   readonly deviceName?: string;
   readonly appVersion?: string;
+  /** Values for the app's extra columns (`options.extraColumns`); left out keeps the stored ones. */
+  readonly fields?: Partial<F> & Readonly<Record<string, unknown>>;
 }
 /** One device a user gets pushes on. */
-interface PushTarget {
+interface PushTarget<F extends object = Record<never, never>> {
   readonly userId: string;
   readonly token: string;
   readonly platform: PushPlatform;
   readonly provider: PushProvider;
+  /** The app's extra columns (`options.extraColumns`), by column name. */
+  readonly fields: RowFields<F>;
 }
-interface PushDevicesOptions extends BlockTemporalOptions {
+interface PushDevicesOptions<S extends StandardSchemaV1 | undefined = undefined> extends BlockTemporalOptions {
   /** `sqlTransport(postgres.asUser(claims))`, `rpcTransport(supabase)`, or over `postgres.admin` for the sender. */
   readonly transport: BlockTransport;
-  /** `sql.modules.push.schema`. Defaults to `better_supabase`. */
+  /** The module schema, or its API schema: `defineBlocks` passes it from `blocks.generated.ts`. Default `better_supabase`. */
   readonly schema?: string;
   readonly mappers?: readonly ErrorMapper[];
+  /**
+   * A Standard Schema for the extra columns of the devices table
+   * (`blocks.push.options.extraColumns`): writes are validated, reads parsed.
+   */
+  readonly fields?: S;
+  /** `withBlockHooks` hooks around the client's methods. */
+  readonly hooks?: NoInfer<BlockHooks<PushDevices<FieldsOf<S>>>>;
+  /** Receives the errors `after` hooks throw. Default: `console`. */
+  readonly logger?: Logger;
 }
 /** The `push` SQL module as typed calls. */
-interface PushDevices {
+interface PushDevices<F extends object = Record<never, never>> {
   /** Registers the caller's device, or refreshes it; resolves with the device id. */
-  readonly register: (device: PushDeviceInput) => AsyncResult<string>;
+  readonly register: (device: PushDeviceInput<F>) => AsyncResult<string>;
   /** Removes the caller's device; `false` when the caller had none with `token`. */
   readonly unregister: (token: string) => AsyncResult<boolean>;
   /** Service role: every device of `userIds`, newest first per user. */
-  readonly tokensFor: (userIds: readonly string[]) => AsyncResult<readonly PushTarget[]>;
+  readonly tokensFor: (userIds: readonly string[]) => AsyncResult<readonly PushTarget<F>[]>;
   /** Service role: deletes the devices with `tokens`; resolves with how many. */
   readonly prune: (tokens: readonly string[]) => AsyncResult<number>;
 }
-export declare function createPushDevices(options: PushDevicesOptions): PushDevices;
-/** The part of `expo-notifications` `registerDevice` uses. */
-interface ExpoNotificationsLike {
-  getPermissionsAsync(): Promise<{
-    readonly status: string;
-  }>;
-  requestPermissionsAsync(): Promise<{
-    readonly status: string;
-  }>;
-  getExpoPushTokenAsync(options?: {
-    readonly projectId?: string;
-  }): Promise<{
-    readonly data: string;
-  }>;
-}
+export declare function createPush<S extends StandardSchemaV1 | undefined = undefined>(options: PushDevicesOptions<S>): PushDevices<FieldsOf<S>>;
 interface RegisterDeviceOptions {
   readonly notifications: ExpoNotificationsLike;
   readonly devices: PushDevices;
@@ -77,7 +84,7 @@ interface RegisteredDevice {
  * ```ts
  * const device = await registerDevice({
  *   notifications: Notifications,
- *   devices: createPushDevices({ transport: rpcTransport(supabase) }),
+ *   devices: createPush({ transport: rpcTransport(supabase) }),
  *   platform: Platform.OS,
  *   projectId: Constants.easConfig?.projectId,
  * }).orThrow();
@@ -182,4 +189,17 @@ interface ExpoPushChannelOptions {
  */
 export declare function expoPushChannel(options: ExpoPushChannelOptions): NotificationChannel;
 //#endregion
-export { type BlockTransport, type ExpoNotificationsLike, type ExpoPush, type ExpoPushChannelOptions, type ExpoPushMessage, type ExpoPushOptions, type ExpoPushTicket, type ExpoReceiptResult, type PushDeviceInput, type PushDevices, type PushDevicesOptions, type PushPlatform, type PushProvider, type PushTarget, type RegisterDeviceOptions, type RegisteredDevice, rpcTransport, sqlTransport };
+//#region src/blocks/push/events.d.ts
+/** The events of the `push` block: type to data. */
+type PushEvents = {
+  readonly "push.device_registered": PushDeviceEventData;
+  readonly "push.device_unregistered": PushDeviceEventData;
+};
+/** The `push` block's event types, for its manifest and `onBlockEvent`. */
+export declare const pushEvents: Events<PushEvents>;
+//#endregion
+//#region src/blocks/push/manifest.d.ts
+/** The `push` block's manifest (ADR 0029). */
+export declare const pushBlock: BlockOf<"push", typeof createPush, PushEvents>;
+//#endregion
+export { type BlockTransport, type ExpoNotificationsLike, type ExpoPush, type ExpoPushChannelOptions, type ExpoPushMessage, type ExpoPushOptions, type ExpoPushTicket, type ExpoReceiptResult, type PushDeviceInput, type PushDevices, type PushDevicesOptions, type PushEvents, type PushPlatform, type PushProvider, type PushTarget, type RegisterDeviceOptions, type RegisteredDevice, dbTransport, rpcTransport, sqlTransport };