better-supabase 0.8.0 → 0.9.0

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

@@ -1,18 +1,19 @@
-import { t as AsyncResult, w as ErrorMapper } from "../../result-BchM1XZn.js";
-import { a as dbTransport, i as RpcClient, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-inD4fFq-.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-lmkbOtPB.js";
-import { r as BlockTemporalOptions } from "../../block-helpers-C0Xj8War.js";
-import { a as BlockTransportMiddleware, d as extendBlock, f as withBlockHooks, n as BlockHooks, p as wrapTransport } from "../../block-hooks-DaOVC7SC.js";
-import { n as FieldsOf } from "../../block-fields-D1pfrcIY.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
+//#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,9 +1,11 @@
-import { a as ok, t as AsyncResult } from "../../result-DEqHCMKP.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-bAKh-dGc.js";
-import { i as blockCall, n as applyTemporal } from "../../block-helpers-Cy3pB96I.js";
-import { i as wrapTransport, n as extendBlock, r as withBlockHooks } from "../../block-hooks-BPNMIlLl.js";
-import { t as blockFields } from "../../block-fields-CroxUuF2.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
@@ -26,4 +28,15 @@ function createProfiles(options) {
 	});
 }
 //#endregion
-export { createProfiles, dbTransport, 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-BchM1XZn.js";
-import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-inD4fFq-.js";
-import { r as BlockTemporalOptions } from "../../block-helpers-C0Xj8War.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, dbTransport, 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 };

package/dist/blocks/push/index.js

@@ -1,5 +1,11 @@
-import { i as sqlTransport, r as rpcTransport, t as dbTransport } from "../../block-transport-bAKh-dGc.js";
-import { C as recordOrEmpty, E as run, i as blockCall, j as textOf, n as applyTemporal, w as recordsOf } from "../../block-helpers-Cy3pB96I.js";
+import { t as expoPushToken } from "../../push-token-D6REHMMw.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 { I as textOf, O as recordOrEmpty, j as run, k as recordsOf, n as applyTemporal, o as blockCall } from "../../block-helpers-CfG_MvDR.js";
+import { r as withBlockHooks } from "../../block-hooks-BsXncUlZ.js";
+import { a as readAllFields, l as writeFields, n as blockFields, s as rowFields } from "../../block-fields-ffD6Gxe4.js";
+import { n as defineBlock } from "../../define-block-B6Gjs57G.js";
+import { t as pushSqlOptions } from "../../options-CrC78Tee.js";
 //#region src/blocks/push/push.ts
 const PLATFORMS = /* @__PURE__ */ new Set([
 	"ios",
@@ -26,25 +32,31 @@ function targetsOf(value) {
 			userId: textOf(row["userId"]),
 			token: textOf(row["token"]),
 			platform,
-			provider
+			provider,
+			fields: rowFields(row["fields"])
 		}] : [];
 	});
 }
-function createPushDevices(options) {
+function createPush(options) {
 	applyTemporal(options);
 	const call = blockCall(options.transport, options.schema, options.mappers);
-	return {
-		register: (device) => call("register_push_device", {
+	const fields = blockFields(options.fields, "push device fields");
+	return withBlockHooks({
+		register: (device) => writeFields(fields, device.fields, (checked) => call("register_push_device", {
 			token: device.token,
 			platform: device.platform,
 			provider: device.provider ?? "expo",
 			device_name: device.deviceName,
-			app_version: device.appVersion
-		}, textOf),
+			app_version: device.appVersion,
+			fields: checked
+		}, textOf)),
 		unregister: (token) => call("unregister_push_device", { token }, (value) => value === true),
-		tokensFor: (userIds) => call("push_tokens_for", { users: [...userIds] }, targetsOf),
+		tokensFor: (userIds) => call("push_tokens_for", { users: [...userIds] }, targetsOf).andThen((targets) => readAllFields(fields, targets)),
 		prune: (tokens) => call("prune_push_tokens", { tokens: [...tokens] }, (value) => typeof value === "number" ? value : Number(value ?? 0))
-	};
+	}, options.hooks, {
+		block: "push",
+		...options.logger ? { logger: options.logger } : {}
+	});
 }
 /**
 * Gets the Expo push token, asking for permission first, and registers the
@@ -54,7 +66,7 @@ function createPushDevices(options) {
 * ```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();
@@ -64,10 +76,8 @@ function registerDevice(options) {
 	return run(async () => {
 		const { notifications, platform } = options;
 		if (!isPlatform(platform)) return null;
-		let { status } = await notifications.getPermissionsAsync();
-		if (status !== "granted" && (options.request ?? true)) ({status} = await notifications.requestPermissionsAsync());
-		if (status !== "granted") return null;
-		const { data: token } = await notifications.getExpoPushTokenAsync(options.projectId === void 0 ? {} : { projectId: options.projectId });
+		const token = await expoPushToken(notifications, { projectId: options.projectId }).token({ request: options.request ?? true });
+		if (token === null) return null;
 		return {
 			deviceId: await options.devices.register({
 				token,
@@ -255,4 +265,23 @@ function expoPushChannel(options) {
 	};
 }
 //#endregion
-export { createPushDevices, dbTransport, expoPush, expoPushChannel, registerDevice, rpcTransport, sqlTransport, unregisterOnSignOut };
+//#region src/blocks/push/events.ts
+/** The `push` block's event types, for its manifest and `onBlockEvent`. */
+const pushEvents = defineEvents({
+	"push.device_registered": event(),
+	"push.device_unregistered": event()
+});
+//#endregion
+//#region src/blocks/push/manifest.ts
+/** The `push` block's manifest (ADR 0029). */
+const pushBlock = defineBlock({
+	name: "push",
+	sql: ["push"],
+	options: { push: pushSqlOptions },
+	events: pushEvents,
+	create: createPush,
+	category: "messaging",
+	recipes: ["push-opt-in"]
+});
+//#endregion
+export { createPush, dbTransport, expoPush, expoPushChannel, pushBlock, pushEvents, registerDevice, rpcTransport, sqlTransport, unregisterOnSignOut };