@palbase/backend 0.9.0 → 0.10.0

package/dist/{endpoint-_1Qq8AFz.d.cts → endpoint-6LeBP-eb.d.cts}

@@ -106,16 +106,29 @@ interface TypedDB<S extends SchemaDef> {
     tables: {
         [K in keyof S["tables"]]: TypedTable<S["tables"][K]>;
     };
+    transaction<T>(fn: (tx: TypedTx<S>) => Promise<T>): Promise<T>;
+}
+/** Transaction-scoped typed facade: same typed tables, no nested transaction. */
+interface TypedTx<S extends SchemaDef> {
+    tables: {
+        [K in keyof S["tables"]]: TypedTable<S["tables"][K]>;
+    };
 }
 /**
  * Wraps a raw `DBClient` with the type-safe `TypedDB<S>` facade derived from
  * the provided schema. No behavior change — all calls delegate to `raw` with
  * the table name as a plain string.
  *
- * The `satisfies` check verifies the built object is structurally compatible
- * before we present it as `TypedDB<S>`. The final `as TypedDB<S>` is a
- * single structural narrowing from the dynamically-built type to the precise
- * mapped type (TS cannot infer through `Object.keys` iteration).
+ * `buildTables` is the reusable factory that wraps any op-bearing client
+ * (`TxClient` — the surface shared by `DBClient` and the transaction-scoped
+ * client) into the typed tables map. It is used both for the top-level db
+ * (wrapping `raw`) and inside `transaction`, where it wraps the raw `TxClient`
+ * the runtime yields so the callback sees the same typed `.tables` API.
+ *
+ * `transaction` delegates straight to `raw.transaction`; the two narrow
+ * `as TypedTx<S>` / `as TypedDB<S>` casts are single structural narrowings
+ * from the dynamically-built tables object to the precise mapped type (TS
+ * cannot infer through `Object.keys` iteration) — see module-level doc comment.
  */
 declare function makeTypedDB<S extends SchemaDef>(schema: S, raw: DBClient): TypedDB<S>;
 
@@ -331,7 +344,18 @@ interface PalbasePushSendResponse {
 interface PalbaseEmailSendParams {
     to: string | string[];
     subject?: string;
+    /**
+     * @deprecated The server reads `template_slug`, not `template` — this
+     * field is forwarded as-is and ignored by palnotify. Use `templateSlug`
+     * instead. Retained for source-compat with older callers.
+     */
     template?: string;
+    /**
+     * Server email-template slug. The notifications client maps this to the
+     * wire field `template_slug` (mutually exclusive with `subject` + body
+     * fields when not overriding template output).
+     */
+    templateSlug?: string;
     variables?: Record<string, unknown>;
     html?: string;
     text?: string;
@@ -350,7 +374,18 @@ interface PalbaseEmailSendResponse {
 /** SMS send params. */
 interface PalbaseSmsSendParams {
     to: string | string[];
-    body: string;
+    /**
+     * SMS body text. Either `body` OR `templateSlug` must be supplied —
+     * the two are mutually exclusive at the server.
+     */
+    body?: string;
+    /**
+     * Server SMS-template slug. The notifications client maps this to the
+     * wire field `template_slug`. When provided, palnotify renders the
+     * template with `variables` and uses the result as the SMS body.
+     */
+    templateSlug?: string;
+    variables?: Record<string, unknown>;
     category?: string;
 }
 /** SMS send response. */
@@ -422,6 +457,56 @@ interface PalbaseRegisterDeviceParams {
     app_version?: string;
     locale?: string;
 }
+/** Email template view (camelCase). */
+interface PalbaseEmailTemplate {
+    id: string;
+    projectId: string;
+    slug: string;
+    subject: string;
+    htmlBody: string;
+    textBody?: string;
+    variables: string[];
+    isDefault: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+/** Payload for templates.email.create. */
+interface PalbaseCreateEmailTemplateInput {
+    slug: string;
+    subject: string;
+    htmlBody: string;
+    textBody?: string;
+    variables?: string[];
+}
+/** Payload for templates.email.update — patch semantics. */
+interface PalbaseUpdateEmailTemplateInput {
+    subject?: string;
+    htmlBody?: string;
+    textBody?: string;
+    variables?: string[];
+}
+/** SMS template view (camelCase). No subject / html / text distinction. */
+interface PalbaseSMSTemplate {
+    id: string;
+    projectId: string;
+    slug: string;
+    body: string;
+    variables: string[];
+    isDefault: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+/** Payload for templates.sms.create. */
+interface PalbaseCreateSMSTemplateInput {
+    slug: string;
+    body: string;
+    variables?: string[];
+}
+/** Payload for templates.sms.update — patch semantics. */
+interface PalbaseUpdateSMSTemplateInput {
+    body?: string;
+    variables?: string[];
+}
 /** Analytics event properties. */
 type PalbaseAnalyticsProperties = Record<string, unknown>;
 /** Analytics identify traits. */
@@ -952,6 +1037,47 @@ interface PalbasePreferencesClient {
     /** Update notification preferences. */
     update(params: PalbasePreferences): Promise<PalbaseResult<PalbasePreferences>>;
 }
+/**
+ * Email-template CRUD sub-client (service-role gated server-side).
+ */
+interface PalbaseEmailTemplatesClient {
+    /** List all email templates. */
+    list(): Promise<PalbaseResult<PalbaseEmailTemplate[]>>;
+    /** Get one email template by ID. */
+    get(id: string): Promise<PalbaseResult<PalbaseEmailTemplate>>;
+    /** Create an email template. */
+    create(input: PalbaseCreateEmailTemplateInput): Promise<PalbaseResult<PalbaseEmailTemplate>>;
+    /** Update an email template (patch semantics). */
+    update(id: string, input: PalbaseUpdateEmailTemplateInput): Promise<PalbaseResult<PalbaseEmailTemplate>>;
+    /** Delete an email template. */
+    delete(id: string): Promise<PalbaseResult<void>>;
+}
+/**
+ * SMS-template CRUD sub-client (service-role gated server-side).
+ */
+interface PalbaseSMSTemplatesClient {
+    /** List all SMS templates. */
+    list(): Promise<PalbaseResult<PalbaseSMSTemplate[]>>;
+    /** Get one SMS template by ID. */
+    get(id: string): Promise<PalbaseResult<PalbaseSMSTemplate>>;
+    /** Create an SMS template. */
+    create(input: PalbaseCreateSMSTemplateInput): Promise<PalbaseResult<PalbaseSMSTemplate>>;
+    /** Update an SMS template (patch semantics). */
+    update(id: string, input: PalbaseUpdateSMSTemplateInput): Promise<PalbaseResult<PalbaseSMSTemplate>>;
+    /** Delete an SMS template. */
+    delete(id: string): Promise<PalbaseResult<void>>;
+}
+/**
+ * Templates sub-client — parallel CRUD for email and SMS templates.
+ * Service-role gated server-side; both surfaces map TS camelCase to
+ * wire snake_case in the runtime client.
+ */
+interface PalbaseTemplatesClient {
+    /** Email template CRUD. */
+    email: PalbaseEmailTemplatesClient;
+    /** SMS template CRUD. */
+    sms: PalbaseSMSTemplatesClient;
+}
 /**
  * Notifications client available on `ctx.notifications`.
  * Service-role: all send operations require privileged access.
@@ -968,6 +1094,8 @@ interface PalbaseNotificationsClient {
     inbox: PalbaseInboxClient;
     /** Notification preferences manager. */
     preferences: PalbasePreferencesClient;
+    /** Email + SMS template CRUD (service-role). */
+    templates: PalbaseTemplatesClient;
     /** Register a device for push notifications. */
     registerDevice(params: PalbaseRegisterDeviceParams): Promise<PalbaseResult<PalbaseDeviceTokenView>>;
     /** Remove a device registration. */
@@ -1080,6 +1208,8 @@ interface RateLimitConfig {
     /** Window duration in seconds. */
     window: number;
 }
+/** The transaction-scoped client passed to `db.transaction(fn)` — same DB ops, no nested transaction. */
+type TxClient = Omit<DBClient, "transaction">;
 /** Database client interface injected into endpoint context. */
 interface DBClient {
     /** Run a read-only SQL query (executes in a READ ONLY transaction). */
@@ -1089,6 +1219,12 @@ interface DBClient {
     delete(table: string, id: string): Promise<void>;
     findById(table: string, id: string): Promise<Record<string, unknown> | null>;
     findMany(table: string, query?: Record<string, unknown>): Promise<Record<string, unknown>[]>;
+    /**
+     * Run an interactive transaction. The callback receives a `tx` with the same
+     * DB ops as this client; returning normally commits, throwing rolls back.
+     * Nested transactions are not supported.
+     */
+    transaction<T>(fn: (tx: TxClient) => Promise<T>): Promise<T>;
 }
 /** Logger interface injected into endpoint context. */
 interface Logger {
@@ -1296,4 +1432,4 @@ interface EndpointConfig<TInputSchema extends ZodSchema = ZodSchema, TOutputSche
  */
 declare function defineEndpoint<TInputSchema extends ZodSchema, TOutputSchema extends ZodSchema, TSchema extends SchemaDef | undefined = undefined, const TAuth extends AuthSpec | undefined = undefined>(config: EndpointConfig<TInputSchema, TOutputSchema, TSchema, TAuth>): EndpointConfig<TInputSchema, TOutputSchema, TSchema, TAuth>;
 
-export { type PalbaseIdentifyTraits as $, type AuthConfig as A, type PalbaseDocumentRef as B, type CacheClient as C, type DBClient as D, type EndpointContext as E, type FileContext as F, type PalbaseDocumentSnapshot as G, type HttpMethod as H, type InsertShape as I, type PalbaseEmailClient as J, type PalbaseEmailSendParams as K, type Logger as L, type Middleware as M, type PalbaseEmailSendResponse as N, type PalbaseEventNamesResult as O, type PalbaseModuleClients as P, type QueueClient as Q, type PalbaseEventsQueryInput as R, type PalbaseEventsResult as S, type PalbaseFileObject as T, type PalbaseFlag as U, type PalbaseFlagContext as V, type PalbaseFlagVariant as W, type PalbaseFlagsClient as X, type PalbaseFunctionsClient as Y, type PalbaseFunnelQueryInput as Z, type PalbaseFunnelResult as _, type EndpointConfig as a, type PalbaseInboxClient as a0, type PalbaseInboxListOptions as a1, type PalbaseInboxListResult as a2, type PalbaseInboxMessage as a3, type PalbaseInboxSendParams as a4, type PalbaseInboxSendResponse as a5, type PalbaseInitialLink as a6, type PalbaseInvokeOptions as a7, type PalbaseLink as a8, type PalbaseLinkAnalytics as a9, type PalbaseSmsClient as aA, type PalbaseSmsSendParams as aB, type PalbaseSmsSendResponse as aC, type PalbaseStorageClient as aD, type PalbaseTransformOptions as aE, type PalbaseUpdateLinkParams as aF, type PalbaseUploadOptions as aG, type PalbaseUser as aH, type PalbaseUserDetailResult as aI, type PalbaseUsersQueryInput as aJ, type PalbaseUsersResult as aK, type PalbaseVerifyRequestSignatureParams as aL, type PalbaseWhereOperator as aM, type RateLimitConfig as aN, type RowShape as aO, type TypedDB as aP, type TypedTable as aQ, type User as aR, defineEndpoint as aS, defineMiddleware as aT, makeTypedDB as aU, type PalbaseLinkDetails as aa, type PalbaseLinksClient as ab, type PalbaseListLinksOptions as ac, type PalbaseListLinksResult as ad, type PalbaseListOptions as ae, type PalbaseMatchParams as af, type PalbaseMultiChannelResponse as ag, type PalbaseNotificationsClient as ah, type PalbaseOverviewResult as ai, type PalbasePreferences as aj, type PalbasePreferencesClient as ak, type PalbasePublicUrlResponse as al, type PalbasePushClient as am, type PalbasePushSendParams as an, type PalbasePushSendResponse as ao, type PalbaseQrCodeOptions as ap, type PalbaseQuerySnapshot as aq, type PalbaseRealtimeChannel as ar, type PalbaseRealtimeClient as as, type PalbaseRealtimeMessage as at, type PalbaseRegisterDeviceParams as au, type PalbaseResult as av, type PalbaseRetentionQueryInput as aw, type PalbaseRetentionResult as ax, type PalbaseSession as ay, type PalbaseSignedUrlResponse as az, type MiddlewareContext as b, type MiddlewareHandler as c, type PalbaseAnalyticsClient as d, type PalbaseAnalyticsManagementNamespace as e, type PalbaseAnalyticsProperties as f, type PalbaseAnalyticsQueryNamespace as g, type PalbaseAttestAndroidParams as h, type PalbaseAttestAndroidResult as i, type PalbaseAttestiOSParams as j, type PalbaseAttestiOSResult as k, type PalbaseAuthClient as l, type PalbaseBindDeviceParams as m, type PalbaseBucketClient as n, type PalbaseCmsClient as o, type PalbaseCmsFindOneOptions as p, type PalbaseCmsFindOptions as q, type PalbaseCohortQueryInput as r, type PalbaseCohortResult as s, type PalbaseCollectionRef as t, type PalbaseCountQueryInput as u, type PalbaseCountResult as v, type PalbaseCreateLinkParams as w, type PalbaseDeviceInfo as x, type PalbaseDeviceTokenView as y, type PalbaseDocsClient as z };
+export { type PalbaseIdentifyTraits as $, type AuthConfig as A, type PalbaseDocumentRef as B, type CacheClient as C, type DBClient as D, type EndpointContext as E, type FileContext as F, type PalbaseDocumentSnapshot as G, type HttpMethod as H, type InsertShape as I, type PalbaseEmailClient as J, type PalbaseEmailSendParams as K, type Logger as L, type Middleware as M, type PalbaseEmailSendResponse as N, type PalbaseEventNamesResult as O, type PalbaseModuleClients as P, type QueueClient as Q, type PalbaseEventsQueryInput as R, type PalbaseEventsResult as S, type PalbaseFileObject as T, type PalbaseFlag as U, type PalbaseFlagContext as V, type PalbaseFlagVariant as W, type PalbaseFlagsClient as X, type PalbaseFunctionsClient as Y, type PalbaseFunnelQueryInput as Z, type PalbaseFunnelResult as _, type EndpointConfig as a, type PalbaseInboxClient as a0, type PalbaseInboxListOptions as a1, type PalbaseInboxListResult as a2, type PalbaseInboxMessage as a3, type PalbaseInboxSendParams as a4, type PalbaseInboxSendResponse as a5, type PalbaseInitialLink as a6, type PalbaseInvokeOptions as a7, type PalbaseLink as a8, type PalbaseLinkAnalytics as a9, type PalbaseSmsClient as aA, type PalbaseSmsSendParams as aB, type PalbaseSmsSendResponse as aC, type PalbaseStorageClient as aD, type PalbaseTransformOptions as aE, type PalbaseUpdateLinkParams as aF, type PalbaseUploadOptions as aG, type PalbaseUser as aH, type PalbaseUserDetailResult as aI, type PalbaseUsersQueryInput as aJ, type PalbaseUsersResult as aK, type PalbaseVerifyRequestSignatureParams as aL, type PalbaseWhereOperator as aM, type RateLimitConfig as aN, type RowShape as aO, type TxClient as aP, type TypedDB as aQ, type TypedTable as aR, type TypedTx as aS, type User as aT, defineEndpoint as aU, defineMiddleware as aV, makeTypedDB as aW, type PalbaseLinkDetails as aa, type PalbaseLinksClient as ab, type PalbaseListLinksOptions as ac, type PalbaseListLinksResult as ad, type PalbaseListOptions as ae, type PalbaseMatchParams as af, type PalbaseMultiChannelResponse as ag, type PalbaseNotificationsClient as ah, type PalbaseOverviewResult as ai, type PalbasePreferences as aj, type PalbasePreferencesClient as ak, type PalbasePublicUrlResponse as al, type PalbasePushClient as am, type PalbasePushSendParams as an, type PalbasePushSendResponse as ao, type PalbaseQrCodeOptions as ap, type PalbaseQuerySnapshot as aq, type PalbaseRealtimeChannel as ar, type PalbaseRealtimeClient as as, type PalbaseRealtimeMessage as at, type PalbaseRegisterDeviceParams as au, type PalbaseResult as av, type PalbaseRetentionQueryInput as aw, type PalbaseRetentionResult as ax, type PalbaseSession as ay, type PalbaseSignedUrlResponse as az, type MiddlewareContext as b, type MiddlewareHandler as c, type PalbaseAnalyticsClient as d, type PalbaseAnalyticsManagementNamespace as e, type PalbaseAnalyticsProperties as f, type PalbaseAnalyticsQueryNamespace as g, type PalbaseAttestAndroidParams as h, type PalbaseAttestAndroidResult as i, type PalbaseAttestiOSParams as j, type PalbaseAttestiOSResult as k, type PalbaseAuthClient as l, type PalbaseBindDeviceParams as m, type PalbaseBucketClient as n, type PalbaseCmsClient as o, type PalbaseCmsFindOneOptions as p, type PalbaseCmsFindOptions as q, type PalbaseCohortQueryInput as r, type PalbaseCohortResult as s, type PalbaseCollectionRef as t, type PalbaseCountQueryInput as u, type PalbaseCountResult as v, type PalbaseCreateLinkParams as w, type PalbaseDeviceInfo as x, type PalbaseDeviceTokenView as y, type PalbaseDocsClient as z };

package/dist/{endpoint-DysSe3SI.d.ts → endpoint-BbbU1hE1.d.ts}

@@ -106,16 +106,29 @@ interface TypedDB<S extends SchemaDef> {
     tables: {
         [K in keyof S["tables"]]: TypedTable<S["tables"][K]>;
     };
+    transaction<T>(fn: (tx: TypedTx<S>) => Promise<T>): Promise<T>;
+}
+/** Transaction-scoped typed facade: same typed tables, no nested transaction. */
+interface TypedTx<S extends SchemaDef> {
+    tables: {
+        [K in keyof S["tables"]]: TypedTable<S["tables"][K]>;
+    };
 }
 /**
  * Wraps a raw `DBClient` with the type-safe `TypedDB<S>` facade derived from
  * the provided schema. No behavior change — all calls delegate to `raw` with
  * the table name as a plain string.
  *
- * The `satisfies` check verifies the built object is structurally compatible
- * before we present it as `TypedDB<S>`. The final `as TypedDB<S>` is a
- * single structural narrowing from the dynamically-built type to the precise
- * mapped type (TS cannot infer through `Object.keys` iteration).
+ * `buildTables` is the reusable factory that wraps any op-bearing client
+ * (`TxClient` — the surface shared by `DBClient` and the transaction-scoped
+ * client) into the typed tables map. It is used both for the top-level db
+ * (wrapping `raw`) and inside `transaction`, where it wraps the raw `TxClient`
+ * the runtime yields so the callback sees the same typed `.tables` API.
+ *
+ * `transaction` delegates straight to `raw.transaction`; the two narrow
+ * `as TypedTx<S>` / `as TypedDB<S>` casts are single structural narrowings
+ * from the dynamically-built tables object to the precise mapped type (TS
+ * cannot infer through `Object.keys` iteration) — see module-level doc comment.
  */
 declare function makeTypedDB<S extends SchemaDef>(schema: S, raw: DBClient): TypedDB<S>;
 
@@ -331,7 +344,18 @@ interface PalbasePushSendResponse {
 interface PalbaseEmailSendParams {
     to: string | string[];
     subject?: string;
+    /**
+     * @deprecated The server reads `template_slug`, not `template` — this
+     * field is forwarded as-is and ignored by palnotify. Use `templateSlug`
+     * instead. Retained for source-compat with older callers.
+     */
     template?: string;
+    /**
+     * Server email-template slug. The notifications client maps this to the
+     * wire field `template_slug` (mutually exclusive with `subject` + body
+     * fields when not overriding template output).
+     */
+    templateSlug?: string;
     variables?: Record<string, unknown>;
     html?: string;
     text?: string;
@@ -350,7 +374,18 @@ interface PalbaseEmailSendResponse {
 /** SMS send params. */
 interface PalbaseSmsSendParams {
     to: string | string[];
-    body: string;
+    /**
+     * SMS body text. Either `body` OR `templateSlug` must be supplied —
+     * the two are mutually exclusive at the server.
+     */
+    body?: string;
+    /**
+     * Server SMS-template slug. The notifications client maps this to the
+     * wire field `template_slug`. When provided, palnotify renders the
+     * template with `variables` and uses the result as the SMS body.
+     */
+    templateSlug?: string;
+    variables?: Record<string, unknown>;
     category?: string;
 }
 /** SMS send response. */
@@ -422,6 +457,56 @@ interface PalbaseRegisterDeviceParams {
     app_version?: string;
     locale?: string;
 }
+/** Email template view (camelCase). */
+interface PalbaseEmailTemplate {
+    id: string;
+    projectId: string;
+    slug: string;
+    subject: string;
+    htmlBody: string;
+    textBody?: string;
+    variables: string[];
+    isDefault: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+/** Payload for templates.email.create. */
+interface PalbaseCreateEmailTemplateInput {
+    slug: string;
+    subject: string;
+    htmlBody: string;
+    textBody?: string;
+    variables?: string[];
+}
+/** Payload for templates.email.update — patch semantics. */
+interface PalbaseUpdateEmailTemplateInput {
+    subject?: string;
+    htmlBody?: string;
+    textBody?: string;
+    variables?: string[];
+}
+/** SMS template view (camelCase). No subject / html / text distinction. */
+interface PalbaseSMSTemplate {
+    id: string;
+    projectId: string;
+    slug: string;
+    body: string;
+    variables: string[];
+    isDefault: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+/** Payload for templates.sms.create. */
+interface PalbaseCreateSMSTemplateInput {
+    slug: string;
+    body: string;
+    variables?: string[];
+}
+/** Payload for templates.sms.update — patch semantics. */
+interface PalbaseUpdateSMSTemplateInput {
+    body?: string;
+    variables?: string[];
+}
 /** Analytics event properties. */
 type PalbaseAnalyticsProperties = Record<string, unknown>;
 /** Analytics identify traits. */
@@ -952,6 +1037,47 @@ interface PalbasePreferencesClient {
     /** Update notification preferences. */
     update(params: PalbasePreferences): Promise<PalbaseResult<PalbasePreferences>>;
 }
+/**
+ * Email-template CRUD sub-client (service-role gated server-side).
+ */
+interface PalbaseEmailTemplatesClient {
+    /** List all email templates. */
+    list(): Promise<PalbaseResult<PalbaseEmailTemplate[]>>;
+    /** Get one email template by ID. */
+    get(id: string): Promise<PalbaseResult<PalbaseEmailTemplate>>;
+    /** Create an email template. */
+    create(input: PalbaseCreateEmailTemplateInput): Promise<PalbaseResult<PalbaseEmailTemplate>>;
+    /** Update an email template (patch semantics). */
+    update(id: string, input: PalbaseUpdateEmailTemplateInput): Promise<PalbaseResult<PalbaseEmailTemplate>>;
+    /** Delete an email template. */
+    delete(id: string): Promise<PalbaseResult<void>>;
+}
+/**
+ * SMS-template CRUD sub-client (service-role gated server-side).
+ */
+interface PalbaseSMSTemplatesClient {
+    /** List all SMS templates. */
+    list(): Promise<PalbaseResult<PalbaseSMSTemplate[]>>;
+    /** Get one SMS template by ID. */
+    get(id: string): Promise<PalbaseResult<PalbaseSMSTemplate>>;
+    /** Create an SMS template. */
+    create(input: PalbaseCreateSMSTemplateInput): Promise<PalbaseResult<PalbaseSMSTemplate>>;
+    /** Update an SMS template (patch semantics). */
+    update(id: string, input: PalbaseUpdateSMSTemplateInput): Promise<PalbaseResult<PalbaseSMSTemplate>>;
+    /** Delete an SMS template. */
+    delete(id: string): Promise<PalbaseResult<void>>;
+}
+/**
+ * Templates sub-client — parallel CRUD for email and SMS templates.
+ * Service-role gated server-side; both surfaces map TS camelCase to
+ * wire snake_case in the runtime client.
+ */
+interface PalbaseTemplatesClient {
+    /** Email template CRUD. */
+    email: PalbaseEmailTemplatesClient;
+    /** SMS template CRUD. */
+    sms: PalbaseSMSTemplatesClient;
+}
 /**
  * Notifications client available on `ctx.notifications`.
  * Service-role: all send operations require privileged access.
@@ -968,6 +1094,8 @@ interface PalbaseNotificationsClient {
     inbox: PalbaseInboxClient;
     /** Notification preferences manager. */
     preferences: PalbasePreferencesClient;
+    /** Email + SMS template CRUD (service-role). */
+    templates: PalbaseTemplatesClient;
     /** Register a device for push notifications. */
     registerDevice(params: PalbaseRegisterDeviceParams): Promise<PalbaseResult<PalbaseDeviceTokenView>>;
     /** Remove a device registration. */
@@ -1080,6 +1208,8 @@ interface RateLimitConfig {
     /** Window duration in seconds. */
     window: number;
 }
+/** The transaction-scoped client passed to `db.transaction(fn)` — same DB ops, no nested transaction. */
+type TxClient = Omit<DBClient, "transaction">;
 /** Database client interface injected into endpoint context. */
 interface DBClient {
     /** Run a read-only SQL query (executes in a READ ONLY transaction). */
@@ -1089,6 +1219,12 @@ interface DBClient {
     delete(table: string, id: string): Promise<void>;
     findById(table: string, id: string): Promise<Record<string, unknown> | null>;
     findMany(table: string, query?: Record<string, unknown>): Promise<Record<string, unknown>[]>;
+    /**
+     * Run an interactive transaction. The callback receives a `tx` with the same
+     * DB ops as this client; returning normally commits, throwing rolls back.
+     * Nested transactions are not supported.
+     */
+    transaction<T>(fn: (tx: TxClient) => Promise<T>): Promise<T>;
 }
 /** Logger interface injected into endpoint context. */
 interface Logger {
@@ -1296,4 +1432,4 @@ interface EndpointConfig<TInputSchema extends ZodSchema = ZodSchema, TOutputSche
  */
 declare function defineEndpoint<TInputSchema extends ZodSchema, TOutputSchema extends ZodSchema, TSchema extends SchemaDef | undefined = undefined, const TAuth extends AuthSpec | undefined = undefined>(config: EndpointConfig<TInputSchema, TOutputSchema, TSchema, TAuth>): EndpointConfig<TInputSchema, TOutputSchema, TSchema, TAuth>;
 
-export { type PalbaseIdentifyTraits as $, type AuthConfig as A, type PalbaseDocumentRef as B, type CacheClient as C, type DBClient as D, type EndpointContext as E, type FileContext as F, type PalbaseDocumentSnapshot as G, type HttpMethod as H, type InsertShape as I, type PalbaseEmailClient as J, type PalbaseEmailSendParams as K, type Logger as L, type Middleware as M, type PalbaseEmailSendResponse as N, type PalbaseEventNamesResult as O, type PalbaseModuleClients as P, type QueueClient as Q, type PalbaseEventsQueryInput as R, type PalbaseEventsResult as S, type PalbaseFileObject as T, type PalbaseFlag as U, type PalbaseFlagContext as V, type PalbaseFlagVariant as W, type PalbaseFlagsClient as X, type PalbaseFunctionsClient as Y, type PalbaseFunnelQueryInput as Z, type PalbaseFunnelResult as _, type EndpointConfig as a, type PalbaseInboxClient as a0, type PalbaseInboxListOptions as a1, type PalbaseInboxListResult as a2, type PalbaseInboxMessage as a3, type PalbaseInboxSendParams as a4, type PalbaseInboxSendResponse as a5, type PalbaseInitialLink as a6, type PalbaseInvokeOptions as a7, type PalbaseLink as a8, type PalbaseLinkAnalytics as a9, type PalbaseSmsClient as aA, type PalbaseSmsSendParams as aB, type PalbaseSmsSendResponse as aC, type PalbaseStorageClient as aD, type PalbaseTransformOptions as aE, type PalbaseUpdateLinkParams as aF, type PalbaseUploadOptions as aG, type PalbaseUser as aH, type PalbaseUserDetailResult as aI, type PalbaseUsersQueryInput as aJ, type PalbaseUsersResult as aK, type PalbaseVerifyRequestSignatureParams as aL, type PalbaseWhereOperator as aM, type RateLimitConfig as aN, type RowShape as aO, type TypedDB as aP, type TypedTable as aQ, type User as aR, defineEndpoint as aS, defineMiddleware as aT, makeTypedDB as aU, type PalbaseLinkDetails as aa, type PalbaseLinksClient as ab, type PalbaseListLinksOptions as ac, type PalbaseListLinksResult as ad, type PalbaseListOptions as ae, type PalbaseMatchParams as af, type PalbaseMultiChannelResponse as ag, type PalbaseNotificationsClient as ah, type PalbaseOverviewResult as ai, type PalbasePreferences as aj, type PalbasePreferencesClient as ak, type PalbasePublicUrlResponse as al, type PalbasePushClient as am, type PalbasePushSendParams as an, type PalbasePushSendResponse as ao, type PalbaseQrCodeOptions as ap, type PalbaseQuerySnapshot as aq, type PalbaseRealtimeChannel as ar, type PalbaseRealtimeClient as as, type PalbaseRealtimeMessage as at, type PalbaseRegisterDeviceParams as au, type PalbaseResult as av, type PalbaseRetentionQueryInput as aw, type PalbaseRetentionResult as ax, type PalbaseSession as ay, type PalbaseSignedUrlResponse as az, type MiddlewareContext as b, type MiddlewareHandler as c, type PalbaseAnalyticsClient as d, type PalbaseAnalyticsManagementNamespace as e, type PalbaseAnalyticsProperties as f, type PalbaseAnalyticsQueryNamespace as g, type PalbaseAttestAndroidParams as h, type PalbaseAttestAndroidResult as i, type PalbaseAttestiOSParams as j, type PalbaseAttestiOSResult as k, type PalbaseAuthClient as l, type PalbaseBindDeviceParams as m, type PalbaseBucketClient as n, type PalbaseCmsClient as o, type PalbaseCmsFindOneOptions as p, type PalbaseCmsFindOptions as q, type PalbaseCohortQueryInput as r, type PalbaseCohortResult as s, type PalbaseCollectionRef as t, type PalbaseCountQueryInput as u, type PalbaseCountResult as v, type PalbaseCreateLinkParams as w, type PalbaseDeviceInfo as x, type PalbaseDeviceTokenView as y, type PalbaseDocsClient as z };
+export { type PalbaseIdentifyTraits as $, type AuthConfig as A, type PalbaseDocumentRef as B, type CacheClient as C, type DBClient as D, type EndpointContext as E, type FileContext as F, type PalbaseDocumentSnapshot as G, type HttpMethod as H, type InsertShape as I, type PalbaseEmailClient as J, type PalbaseEmailSendParams as K, type Logger as L, type Middleware as M, type PalbaseEmailSendResponse as N, type PalbaseEventNamesResult as O, type PalbaseModuleClients as P, type QueueClient as Q, type PalbaseEventsQueryInput as R, type PalbaseEventsResult as S, type PalbaseFileObject as T, type PalbaseFlag as U, type PalbaseFlagContext as V, type PalbaseFlagVariant as W, type PalbaseFlagsClient as X, type PalbaseFunctionsClient as Y, type PalbaseFunnelQueryInput as Z, type PalbaseFunnelResult as _, type EndpointConfig as a, type PalbaseInboxClient as a0, type PalbaseInboxListOptions as a1, type PalbaseInboxListResult as a2, type PalbaseInboxMessage as a3, type PalbaseInboxSendParams as a4, type PalbaseInboxSendResponse as a5, type PalbaseInitialLink as a6, type PalbaseInvokeOptions as a7, type PalbaseLink as a8, type PalbaseLinkAnalytics as a9, type PalbaseSmsClient as aA, type PalbaseSmsSendParams as aB, type PalbaseSmsSendResponse as aC, type PalbaseStorageClient as aD, type PalbaseTransformOptions as aE, type PalbaseUpdateLinkParams as aF, type PalbaseUploadOptions as aG, type PalbaseUser as aH, type PalbaseUserDetailResult as aI, type PalbaseUsersQueryInput as aJ, type PalbaseUsersResult as aK, type PalbaseVerifyRequestSignatureParams as aL, type PalbaseWhereOperator as aM, type RateLimitConfig as aN, type RowShape as aO, type TxClient as aP, type TypedDB as aQ, type TypedTable as aR, type TypedTx as aS, type User as aT, defineEndpoint as aU, defineMiddleware as aV, makeTypedDB as aW, type PalbaseLinkDetails as aa, type PalbaseLinksClient as ab, type PalbaseListLinksOptions as ac, type PalbaseListLinksResult as ad, type PalbaseListOptions as ae, type PalbaseMatchParams as af, type PalbaseMultiChannelResponse as ag, type PalbaseNotificationsClient as ah, type PalbaseOverviewResult as ai, type PalbasePreferences as aj, type PalbasePreferencesClient as ak, type PalbasePublicUrlResponse as al, type PalbasePushClient as am, type PalbasePushSendParams as an, type PalbasePushSendResponse as ao, type PalbaseQrCodeOptions as ap, type PalbaseQuerySnapshot as aq, type PalbaseRealtimeChannel as ar, type PalbaseRealtimeClient as as, type PalbaseRealtimeMessage as at, type PalbaseRegisterDeviceParams as au, type PalbaseResult as av, type PalbaseRetentionQueryInput as aw, type PalbaseRetentionResult as ax, type PalbaseSession as ay, type PalbaseSignedUrlResponse as az, type MiddlewareContext as b, type MiddlewareHandler as c, type PalbaseAnalyticsClient as d, type PalbaseAnalyticsManagementNamespace as e, type PalbaseAnalyticsProperties as f, type PalbaseAnalyticsQueryNamespace as g, type PalbaseAttestAndroidParams as h, type PalbaseAttestAndroidResult as i, type PalbaseAttestiOSParams as j, type PalbaseAttestiOSResult as k, type PalbaseAuthClient as l, type PalbaseBindDeviceParams as m, type PalbaseBucketClient as n, type PalbaseCmsClient as o, type PalbaseCmsFindOneOptions as p, type PalbaseCmsFindOptions as q, type PalbaseCohortQueryInput as r, type PalbaseCohortResult as s, type PalbaseCollectionRef as t, type PalbaseCountQueryInput as u, type PalbaseCountResult as v, type PalbaseCreateLinkParams as w, type PalbaseDeviceInfo as x, type PalbaseDeviceTokenView as y, type PalbaseDocsClient as z };

package/dist/index.cjs

@@ -143,14 +143,21 @@ function makeTypedTable(name, raw) {
   };
 }
 function makeTypedDB(schema, raw) {
-  const tables = {};
-  for (const key of Object.keys(schema.tables)) {
-    const tableDef = schema.tables[key];
-    if (tableDef !== void 0) {
-      tables[key] = makeTypedTable(tableDef.name, raw);
+  function buildTables(client) {
+    const tables = {};
+    for (const key of Object.keys(schema.tables)) {
+      const tableDef = schema.tables[key];
+      if (tableDef !== void 0) {
+        tables[key] = makeTypedTable(tableDef.name, client);
+      }
     }
+    return tables;
   }
-  return { tables };
+  const result = {
+    tables: buildTables(raw),
+    transaction: (fn) => raw.transaction((rawTx) => fn({ tables: buildTables(rawTx) }))
+  };
+  return result;
 }
 
 // src/middleware.ts