@modainteract/moda-interact-shared 5.1.0 → 5.3.0

package/dist/shopify/node.d.ts

@@ -1,6 +1,306 @@
 import { b as ShopifyWhatsAppConsentSyncJobV1 } from '../whatsapp-consent-sync.schema-DEU84xTL.js';
+import { C as CredentialKeyring } from '../keyring-BLXjNChq.js';
 import 'zod';
 
+type ShopifyOfflineTokenErrorCode = "SESSION_MISSING" | "SESSION_IDENTITY_CONFLICT" | "INVALID_SESSION" | "REFRESH_TOKEN_EXPIRED" | "OAUTH_CONFIG_UNAVAILABLE" | "LOCK_TIMEOUT" | "CANCELLED" | "DEADLINE" | "REFRESH_REJECTED" | "REFRESH_RESPONSE_INVALID" | "REFRESH_OUTCOME_UNKNOWN" | "PERSISTENCE_UNAVAILABLE";
+/** Bounded refresh lifecycle metadata. Never includes provider credentials or errors. */
+type ShopifyOfflineRefreshEvent = Readonly<{
+    event: "shopify.offline_refresh.started" | "shopify.offline_refresh.committed" | "shopify.offline_refresh.failed";
+    operationId: string;
+    shopId: string | null;
+    source: "SHARED" | "SDK";
+    durationMs: number;
+    outcome: "STARTED" | "COMMITTED" | "REJECTED" | "UNKNOWN" | "CANCELLED" | "UNAVAILABLE";
+    reasonCode: ShopifyOfflineTokenErrorCode | null;
+}>;
+declare class ShopifyOfflineTokenError extends Error {
+    readonly code: ShopifyOfflineTokenErrorCode;
+    readonly retryable: boolean;
+    constructor(code: ShopifyOfflineTokenErrorCode);
+}
+type ShopifyOfflineSessionRecord = Readonly<{
+    id: string;
+    shop: string;
+    isOnline: boolean;
+    accessToken: string | null;
+    refreshToken: string | null;
+    scope: string | null;
+    expires: Date | null;
+    refreshTokenExpires: Date | null;
+}>;
+type ShopifyOfflineShopRecord = Readonly<{
+    id: string;
+    domain: string;
+    platform: string;
+    status: string;
+}>;
+type ShopifyOfflineStringFilter = string | Readonly<{
+    equals?: string;
+    in?: string[];
+    notIn?: string[];
+    lt?: string;
+    lte?: string;
+    gt?: string;
+    gte?: string;
+    contains?: string;
+    startsWith?: string;
+    endsWith?: string;
+    mode?: "default" | "insensitive";
+    not?: string | ShopifyOfflineStringFilter;
+}>;
+type ShopifyOfflineBooleanFilter = boolean | Readonly<{
+    equals?: boolean;
+    not?: boolean | ShopifyOfflineBooleanFilter;
+}>;
+type ShopifyOfflineNullableStringFilter = string | null | Readonly<{
+    equals?: string | null;
+    in?: string[] | null;
+    notIn?: string[] | null;
+    lt?: string;
+    lte?: string;
+    gt?: string;
+    gte?: string;
+    contains?: string;
+    startsWith?: string;
+    endsWith?: string;
+    mode?: "default" | "insensitive";
+    not?: string | null | ShopifyOfflineNullableStringFilter;
+}>;
+type ShopifyOfflineNullableBooleanFilter = boolean | null | Readonly<{
+    equals?: boolean | null;
+    not?: boolean | null | ShopifyOfflineNullableBooleanFilter;
+}>;
+type ShopifyOfflineDateFilter = Date | string | null | Readonly<{
+    equals?: Date | string | null;
+    in?: Date[] | string[] | null;
+    notIn?: Date[] | string[] | null;
+    lt?: Date | string;
+    lte?: Date | string;
+    gt?: Date | string;
+    gte?: Date | string;
+    not?: Date | string | null | ShopifyOfflineDateFilter;
+}>;
+type ShopifyOfflineBigIntFilter = bigint | number | null | Readonly<{
+    equals?: bigint | number | null;
+    in?: bigint[] | number[] | null;
+    notIn?: bigint[] | number[] | null;
+    lt?: bigint | number;
+    lte?: bigint | number;
+    gt?: bigint | number;
+    gte?: bigint | number;
+    not?: bigint | number | null | ShopifyOfflineBigIntFilter;
+}>;
+type ShopifyOfflineSessionScalarWhere = {
+    id?: ShopifyOfflineStringFilter;
+    shop?: ShopifyOfflineStringFilter;
+    state?: ShopifyOfflineStringFilter;
+    isOnline?: ShopifyOfflineBooleanFilter;
+    scope?: ShopifyOfflineNullableStringFilter;
+    expires?: ShopifyOfflineDateFilter;
+    accessToken?: ShopifyOfflineStringFilter;
+    userId?: ShopifyOfflineBigIntFilter;
+    firstName?: ShopifyOfflineNullableStringFilter;
+    lastName?: ShopifyOfflineNullableStringFilter;
+    email?: ShopifyOfflineNullableStringFilter;
+    accountOwner?: ShopifyOfflineBooleanFilter;
+    locale?: ShopifyOfflineNullableStringFilter;
+    collaborator?: ShopifyOfflineNullableBooleanFilter;
+    emailVerified?: ShopifyOfflineNullableBooleanFilter;
+    refreshToken?: ShopifyOfflineNullableStringFilter;
+    refreshTokenExpires?: ShopifyOfflineDateFilter;
+};
+type ShopifyOfflineSessionWhere = ShopifyOfflineSessionScalarWhere & {
+    AND?: ShopifyOfflineSessionScalarWhere | ShopifyOfflineSessionScalarWhere[];
+    OR?: ShopifyOfflineSessionScalarWhere[];
+    NOT?: ShopifyOfflineSessionScalarWhere | ShopifyOfflineSessionScalarWhere[];
+};
+type ShopifyOfflineSessionUniqueWhere = Readonly<{
+    id: string;
+}>;
+type ShopifyOfflineSessionSelect = Readonly<Partial<Record<"id" | "shop" | "state" | "isOnline" | "scope" | "expires" | "accessToken" | "userId" | "firstName" | "lastName" | "email" | "accountOwner" | "locale" | "collaborator" | "emailVerified" | "refreshToken" | "refreshTokenExpires", true>>>;
+type ShopifyOfflineSessionData = Readonly<{
+    id?: string;
+    shop?: string;
+    state?: string;
+    isOnline?: boolean;
+    scope?: string | null;
+    expires?: Date | null;
+    accessToken?: string;
+    userId?: bigint | null;
+    firstName?: string | null;
+    lastName?: string | null;
+    email?: string | null;
+    accountOwner?: boolean;
+    locale?: string | null;
+    collaborator?: boolean | null;
+    emailVerified?: boolean | null;
+    refreshToken?: string | null;
+    refreshTokenExpires?: Date | null;
+}>;
+type ShopifyOfflineSessionCreateData = ShopifyOfflineSessionData & Readonly<{
+    id: string;
+    shop: string;
+    state: string;
+    accessToken: string;
+}>;
+type ShopifyOfflineSessionDelegate = Readonly<{
+    findUnique(args: Readonly<{
+        where: ShopifyOfflineSessionUniqueWhere;
+        select?: ShopifyOfflineSessionSelect;
+    }>): Promise<ShopifyOfflineSessionRecord | null>;
+    findMany(args: Readonly<{
+        where: ShopifyOfflineSessionWhere;
+        select?: ShopifyOfflineSessionSelect;
+        take?: number;
+    }>): Promise<ShopifyOfflineSessionRecord[]>;
+    create(args: Readonly<{
+        data: ShopifyOfflineSessionCreateData;
+        select?: ShopifyOfflineSessionSelect;
+    }>): Promise<ShopifyOfflineSessionRecord>;
+    update(args: Readonly<{
+        where: ShopifyOfflineSessionUniqueWhere;
+        data: ShopifyOfflineSessionData;
+        select?: ShopifyOfflineSessionSelect;
+    }>): Promise<ShopifyOfflineSessionRecord>;
+    upsert(args: Readonly<{
+        where: ShopifyOfflineSessionUniqueWhere;
+        create: ShopifyOfflineSessionCreateData;
+        update: ShopifyOfflineSessionData;
+        select?: ShopifyOfflineSessionSelect;
+    }>): Promise<ShopifyOfflineSessionRecord>;
+    delete(args: Readonly<{
+        where: ShopifyOfflineSessionUniqueWhere;
+        select?: ShopifyOfflineSessionSelect;
+    }>): Promise<ShopifyOfflineSessionRecord>;
+    deleteMany(args: Readonly<{
+        where?: ShopifyOfflineSessionWhere;
+    }>): Promise<{
+        count: number;
+    }>;
+    updateMany(args: Readonly<{
+        where?: ShopifyOfflineSessionWhere;
+        data: ShopifyOfflineSessionData;
+    }>): Promise<{
+        count: number;
+    }>;
+}>;
+type ShopifyOfflineTransaction = Readonly<{
+    $queryRawUnsafe<T = unknown>(sql: string, ...values: unknown[]): Promise<T>;
+    $executeRawUnsafe(sql: string, ...values: unknown[]): Promise<number>;
+    session: ShopifyOfflineSessionDelegate;
+    shop: Readonly<{
+        findUnique(args: Readonly<{
+            where: Readonly<{
+                id: string;
+            }>;
+            select: Readonly<{
+                id: true;
+                domain: true;
+                platform: true;
+                status: true;
+            }>;
+        }>): Promise<ShopifyOfflineShopRecord | null>;
+    }>;
+}>;
+type ShopifyOfflineDatabase = Readonly<{
+    $transaction<T>(work: (transaction: ShopifyOfflineTransaction) => Promise<T>, options: Readonly<{
+        maxWait: 5000;
+        timeout: 20000;
+        isolationLevel: "ReadCommitted";
+    }>): Promise<T>;
+    shop: ShopifyOfflineTransaction["shop"];
+}>;
+type OfflineCredentialSnapshot = Readonly<{
+    id: string;
+    shopId: string;
+    shop: string;
+    accessToken: string;
+    scope: string | null;
+    expires: Date | null;
+    refreshTokenExpires: Date | null;
+}>;
+type LockedSessionContext = Readonly<{
+    transaction: ShopifyOfflineTransaction;
+    shopId: string;
+    shop: string;
+    sessionId: string;
+    signal: AbortSignal;
+}>;
+type SdkInstallationSessionContext = Readonly<{
+    transaction: ShopifyOfflineTransaction;
+    shopId: null;
+    shop: string;
+    sessionId: string | null;
+    signal: AbortSignal;
+}>;
+type ShopifyOfflineTokenProvider = Readonly<{
+    withSdkInstallationSessionLock<T>(integrationDomain: string, work: (context: SdkInstallationSessionContext) => Promise<T>): Promise<T>;
+    getAccessToken(shopId: string, options?: Readonly<{
+        signal?: AbortSignal;
+    }>): Promise<string>;
+    getSession(shopId: string, options?: Readonly<{
+        signal?: AbortSignal;
+    }>): Promise<OfflineCredentialSnapshot>;
+    withSessionLock<T>(shopId: string, work: (context: LockedSessionContext) => Promise<T>, options?: Readonly<{
+        signal?: AbortSignal;
+    }>): Promise<T>;
+}>;
+declare function createShopifyOfflineTokenProvider(input: Readonly<{
+    prisma: ShopifyOfflineDatabase;
+    readOAuth: () => Promise<Readonly<{
+        apiKey: string;
+        apiSecret: string;
+    }>>;
+    fetch: typeof fetch;
+    now?: () => number;
+    onEvent?: (event: ShopifyOfflineRefreshEvent) => void;
+}>): ShopifyOfflineTokenProvider;
+
+declare const CONFIGURATION_KEY: "shopify.oauth";
+type ShopifyOAuthConfigurationErrorCode = "INVALID_ENVIRONMENT" | "CONFIGURATION_UNAVAILABLE" | "CONFIGURATION_INVALID";
+/** Safe configuration boundary error; never contains a row, key, or decrypt cause. */
+declare class ShopifyOAuthConfigurationError extends Error {
+    readonly code: ShopifyOAuthConfigurationErrorCode;
+    constructor(code: ShopifyOAuthConfigurationErrorCode);
+}
+type ShopifyOAuthConfigurationRow = Readonly<{
+    environment: string;
+    key: string;
+    version: number;
+    value: unknown;
+}>;
+type ShopifyOAuthConfigurationPrisma = Readonly<{
+    platformConfiguration: Readonly<{
+        findUnique(args: Readonly<{
+            where: Readonly<{
+                environment_key: Readonly<{
+                    environment: string;
+                    key: typeof CONFIGURATION_KEY;
+                }>;
+            }>;
+            select: Readonly<{
+                environment: true;
+                key: true;
+                version: true;
+                value: true;
+            }>;
+        }>): Promise<ShopifyOAuthConfigurationRow | null>;
+    }>;
+}>;
+type ShopifyOAuthCredentials = Readonly<{
+    apiKey: string;
+    apiSecret: string;
+}>;
+/**
+ * Read and unseal the existing platform `shopify.oauth` row. Environment identity
+ * is deployment configuration supplied by the caller, never request data.
+ */
+declare function readShopifyOAuthConfiguration(input: Readonly<{
+    prisma: ShopifyOAuthConfigurationPrisma;
+    environment: string;
+    unsealKeyring: CredentialKeyring;
+}>): Promise<ShopifyOAuthCredentials>;
+
 /**
  * Legacy webhook delivery job id used by earlier receipt/outbox flows.
  * Prefer the resource-scoped helpers below for current queue publication.
@@ -22,4 +322,4 @@ declare function createShopifyDiscountSyncJobId(event: {
  */
 declare function createShopifyWhatsAppConsentSyncJobId(input: ShopifyWhatsAppConsentSyncJobV1): string;
 
-export { createPendingRecoveryCandidateJobId, createShopifyCheckoutJobId, createShopifyDiscountSyncJobId, createShopifyOrderJobId, createShopifyWebhookJobId, createShopifyWhatsAppConsentSyncJobId };
+export { type LockedSessionContext, type OfflineCredentialSnapshot, type SdkInstallationSessionContext, ShopifyOAuthConfigurationError, type ShopifyOAuthConfigurationErrorCode, type ShopifyOAuthConfigurationPrisma, type ShopifyOAuthConfigurationRow, type ShopifyOAuthCredentials, type ShopifyOfflineBigIntFilter, type ShopifyOfflineBooleanFilter, type ShopifyOfflineDatabase, type ShopifyOfflineDateFilter, type ShopifyOfflineNullableBooleanFilter, type ShopifyOfflineNullableStringFilter, type ShopifyOfflineRefreshEvent, type ShopifyOfflineSessionCreateData, type ShopifyOfflineSessionData, type ShopifyOfflineSessionDelegate, type ShopifyOfflineSessionRecord, type ShopifyOfflineSessionScalarWhere, type ShopifyOfflineSessionSelect, type ShopifyOfflineSessionUniqueWhere, type ShopifyOfflineSessionWhere, type ShopifyOfflineShopRecord, type ShopifyOfflineStringFilter, ShopifyOfflineTokenError, type ShopifyOfflineTokenErrorCode, type ShopifyOfflineTokenProvider, type ShopifyOfflineTransaction, createPendingRecoveryCandidateJobId, createShopifyCheckoutJobId, createShopifyDiscountSyncJobId, createShopifyOfflineTokenProvider, createShopifyOrderJobId, createShopifyWebhookJobId, createShopifyWhatsAppConsentSyncJobId, readShopifyOAuthConfiguration };