@fantastic.dev/better-stripe 0.23.1 → 0.24.0

package/dist/client/connect/payoutSync.d.ts

@@ -0,0 +1,32 @@
+import type Stripe from "stripe";
+import type { Infer } from "convex/values";
+import type { Component, RunCtx } from "../helpers.js";
+import type { result } from "../../component/payoutSync/validators.js";
+import { type PayoutSyncScope } from "./payoutSyncValidation.js";
+export type PayoutSyncOptions = {
+    stripePayoutId: string;
+    scope: PayoutSyncScope;
+};
+export type PayoutSyncResult = Infer<typeof result>;
+export type PreparedPayoutSync = Awaited<ReturnType<typeof preparePayoutSync>>;
+/** Package-internal preparation for transactional host webhook dispatch. No financial record write. */
+export declare function preparePayoutSync(stripe: Stripe, component: Component, ctx: RunCtx, opts: PayoutSyncOptions): Promise<{
+    stripePayoutId: string;
+    accountId: string;
+    generation: number;
+    payout: {
+        accountId: string;
+        amount: number;
+        arrivalDate?: string | undefined;
+        currency: string;
+        failureCode?: string | undefined;
+        failureMessage?: string | undefined;
+        metadata?: Record<string, string> | undefined;
+        method?: string | undefined;
+        status: "canceled" | "failed" | "in_transit" | "paid" | "pending";
+        stripePayoutId: string;
+    };
+}>;
+/** Host must authorize scope. This only reads Stripe and synchronizes the existing financial record. */
+export declare function syncPayoutFromStripe(stripe: Stripe, component: Component, ctx: RunCtx, opts: PayoutSyncOptions): Promise<PayoutSyncResult>;
+//# sourceMappingURL=payoutSync.d.ts.map

package/dist/client/connect/payoutSync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payoutSync.d.ts","sourceRoot":"","sources":["../../../src/client/connect/payoutSync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AACjC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAIvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0CAA0C,CAAC;AACvE,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,2BAA2B,CAAC;AACnC,MAAM,MAAM,iBAAiB,GAAG;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,eAAe,CAAC;CACxB,CAAC;AACF,MAAM,MAAM,gBAAgB,GAAG,KAAK,CAAC,OAAO,MAAM,CAAC,CAAC;AACpD,MAAM,MAAM,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC,CAAC;AAgB/E,uGAAuG;AACvG,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,iBAAiB;;;;;;;;;;;;;;;;GA+BxB;AACD,wGAAwG;AACxG,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,gBAAgB,CAAC,CAgB3B"}

package/dist/client/connect/payoutSync.js

@@ -0,0 +1,48 @@
+import { runMutationOrThrow } from "../helpers.js";
+import { componentRef } from "../webhooks/helpers.js";
+import { validateIdentity } from "../../component/payoutSync/helpers.js";
+import { payoutAccount, payoutSnapshot, } from "./payoutSyncValidation.js";
+async function markUnknown(component, ctx, observation) {
+    await runMutationOrThrow(ctx, componentRef(component, "payoutSync/mutations/markUnknown"), observation);
+}
+/** Package-internal preparation for transactional host webhook dispatch. No financial record write. */
+export async function preparePayoutSync(stripe, component, ctx, opts) {
+    const identity = {
+        stripePayoutId: opts.stripePayoutId,
+        accountId: payoutAccount(opts.scope),
+    };
+    validateIdentity(identity);
+    if (!ctx.runMutation)
+        throw new Error("Payout synchronization requires runMutation.");
+    const generation = (await runMutationOrThrow(ctx, componentRef(component, "payoutSync/mutations/begin"), identity));
+    try {
+        const payout = await stripe.payouts.retrieve(identity.stripePayoutId, {}, identity.accountId === "platform"
+            ? {}
+            : { stripeAccount: identity.accountId });
+        return {
+            ...identity,
+            generation,
+            payout: payoutSnapshot(payout, identity),
+        };
+    }
+    catch (error) {
+        await markUnknown(component, ctx, { ...identity, generation });
+        throw error;
+    }
+}
+/** Host must authorize scope. This only reads Stripe and synchronizes the existing financial record. */
+export async function syncPayoutFromStripe(stripe, component, ctx, opts) {
+    const observation = await preparePayoutSync(stripe, component, ctx, opts);
+    try {
+        return (await runMutationOrThrow(ctx, componentRef(component, "payoutSync/mutations/finish"), observation));
+    }
+    catch (error) {
+        await markUnknown(component, ctx, {
+            stripePayoutId: observation.stripePayoutId,
+            accountId: observation.accountId,
+            generation: observation.generation,
+        });
+        throw error;
+    }
+}
+//# sourceMappingURL=payoutSync.js.map

package/dist/client/connect/payoutSync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payoutSync.js","sourceRoot":"","sources":["../../../src/client/connect/payoutSync.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAEzE,OAAO,EACL,aAAa,EACb,cAAc,GAEf,MAAM,2BAA2B,CAAC;AAOnC,KAAK,UAAU,WAAW,CACxB,SAAoB,EACpB,GAAW,EACX,WAIC;IAED,MAAM,kBAAkB,CACtB,GAAG,EACH,YAAY,CAAC,SAAS,EAAE,kCAAkC,CAAC,EAC3D,WAAW,CACZ,CAAC;AACJ,CAAC;AACD,uGAAuG;AACvG,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAc,EACd,SAAoB,EACpB,GAAW,EACX,IAAuB;IAEvB,MAAM,QAAQ,GAAG;QACf,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,SAAS,EAAE,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC;KACrC,CAAC;IACF,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAC3B,IAAI,CAAC,GAAG,CAAC,WAAW;QAClB,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,MAAM,UAAU,GAAG,CAAC,MAAM,kBAAkB,CAC1C,GAAG,EACH,YAAY,CAAC,SAAS,EAAE,4BAA4B,CAAC,EACrD,QAAQ,CACT,CAAW,CAAC;IACb,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,QAAQ,CAC1C,QAAQ,CAAC,cAAc,EACvB,EAAE,EACF,QAAQ,CAAC,SAAS,KAAK,UAAU;YAC/B,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,aAAa,EAAE,QAAQ,CAAC,SAAS,EAAE,CAC1C,CAAC;QACF,OAAO;YACL,GAAG,QAAQ;YACX,UAAU;YACV,MAAM,EAAE,cAAc,CAAC,MAAM,EAAE,QAAQ,CAAC;SACzC,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,WAAW,CAAC,SAAS,EAAE,GAAG,EAAE,EAAE,GAAG,QAAQ,EAAE,UAAU,EAAE,CAAC,CAAC;QAC/D,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AACD,wGAAwG;AACxG,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,MAAc,EACd,SAAoB,EACpB,GAAW,EACX,IAAuB;IAEvB,MAAM,WAAW,GAAG,MAAM,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;IAC1E,IAAI,CAAC;QACH,OAAO,CAAC,MAAM,kBAAkB,CAC9B,GAAG,EACH,YAAY,CAAC,SAAS,EAAE,6BAA6B,CAAC,EACtD,WAAW,CACZ,CAAqB,CAAC;IACzB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,WAAW,CAAC,SAAS,EAAE,GAAG,EAAE;YAChC,cAAc,EAAE,WAAW,CAAC,cAAc;YAC1C,SAAS,EAAE,WAAW,CAAC,SAAS;YAChC,UAAU,EAAE,WAAW,CAAC,UAAU;SACnC,CAAC,CAAC;QACH,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}