@merchi/sdk 1.42.15 → 1.42.16

package/dist/entities/discount.d.ts

@@ -0,0 +1,19 @@
+import { Entity } from '../entity.js';
+import { DiscountGroup } from './discount_group.js';
+import { User } from './user.js';
+export declare class Discount extends Entity {
+    protected static resourceName: string;
+    protected static singularName: string;
+    protected static pluralName: string;
+    archived?: Date | null;
+    id?: number;
+    lowerLimit?: number;
+    amount?: number;
+    usageLimit?: number;
+    isPercentage?: boolean;
+    code?: string;
+    assignedUsers?: User[];
+    referrer?: User | null;
+    discountGroup?: DiscountGroup | null;
+    discountedUnitCost: (unitPrice: number | undefined) => string;
+}

package/dist/entities/discount.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/entities/discount_group.d.ts

@@ -0,0 +1,20 @@
+import { Entity } from '../entity.js';
+import { Domain } from './domain.js';
+import { Product } from './product.js';
+import { Discount } from './discount.js';
+export declare class DiscountGroup extends Entity {
+    protected static resourceName: string;
+    protected static singularName: string;
+    protected static pluralName: string;
+    archived?: Date | null;
+    created?: Date | null;
+    id?: number;
+    dateStart?: Date | null;
+    dateEnd?: Date | null;
+    discountType?: number;
+    discounts?: Discount[];
+    name?: string;
+    groupRestricted?: boolean;
+    product?: Product | null;
+    domain?: Domain | null;
+}

package/dist/entities/discount_group.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/entities/domain.d.ts

@@ -0,0 +1,629 @@
+import { Cart } from './cart.js';
+import { Category } from './category.js';
+import { Company } from './company.js';
+import { DomainInvitation } from './domain_invitation.js';
+import { DomainTag } from './domain_tag.js';
+import { EnrolledDomain } from './enrolled_domain.js';
+import { Entity } from '../entity.js';
+import type { AgentTokenAnalyticsTimeseries, DomainAnalyticsResponse } from './agent_token_analytics.js';
+import { MerchiFile } from './file.js';
+import { InternalTag } from './internal_tag.js';
+import { Invoice } from './invoice.js';
+import { Job } from './job.js';
+import { User } from './user.js';
+import { Notification } from './notification.js';
+import { Product } from './product.js';
+import { Reminder } from './reminder.js';
+import { Session } from './session.js';
+import { SupplyDomain } from './supply_domain.js';
+import { DomainChatSettings } from './domain_chat_settings.js';
+import { Theme } from './theme.js';
+import { DomainType } from '../constants/domain_types.js';
+import { ShipmentMethod } from './shipment_method.js';
+export type StorefrontChangeRequestStatus = 'created' | 'running' | 'preview_ready' | 'approved' | 'rejected';
+export interface StorefrontChecksSummary {
+    overall?: 'passing' | 'failing' | 'pending' | 'unknown';
+    statusState?: string;
+    counts?: {
+        total?: number;
+        passed?: number;
+        failed?: number;
+        pending?: number;
+        neutral?: number;
+    };
+    updatedAt?: string;
+}
+export interface StorefrontExecutionEvent {
+    timestamp: string;
+    stage: string;
+    level?: 'info' | 'error' | string;
+    message: string;
+    metadata?: Record<string, any>;
+}
+export interface StorefrontRequestContextImage {
+    name: string;
+    mimeType?: string | null;
+    dataUrl: string;
+}
+export interface StorefrontV2ChangeRequestPayload {
+    prompt: string;
+    contextFilePaths?: string[];
+    contextImages?: StorefrontRequestContextImage[];
+    branchName?: string;
+    startNewBranch?: boolean;
+    clarificationAnswers?: Record<string, string | string[]>;
+    generationBriefSummary?: string;
+    generationBoilerplateFit?: string;
+    clarificationSkipped?: boolean;
+}
+export interface StorefrontV2ChangeRequestRunPayload {
+    status?: 'running' | 'preview_ready';
+    branchName?: string;
+    commitSha?: string;
+    previewUrl?: string;
+    summary?: string;
+    pullRequestNumber?: number;
+    checksSummary?: StorefrontChecksSummary;
+    checksUpdatedAt?: string;
+    errorDetails?: string;
+}
+export interface StorefrontV2ChangeRequestRejectPayload {
+    errorDetails?: string;
+}
+export interface StorefrontV2ChangeRequest {
+    id: number;
+    domainId: number;
+    storefrontV2Id: number;
+    requestedByUserId?: number | null;
+    status: StorefrontChangeRequestStatus;
+    prompt: string;
+    branchName?: string | null;
+    commitSha?: string | null;
+    pullRequestNumber?: number | null;
+    previewUrl?: string | null;
+    summary?: string | null;
+    checksSummary?: StorefrontChecksSummary | null;
+    checksUpdatedAt?: string | null;
+    errorDetails?: string | null;
+    executionEvents?: StorefrontExecutionEvent[] | null;
+    creationDate?: string | null;
+    updatedAt?: string | null;
+}
+export interface StorefrontGoogleIntegrations {
+    ga4MeasurementId?: string;
+    ga4PropertyId?: string;
+    googleAdsId?: string;
+    googleAdsConversionLabel?: string;
+    googleAdsQuoteConversionLabel?: string;
+}
+export type StorefrontV2InfrastructureMode = 'platform' | 'byo';
+/** Public BYO connection status (never includes encrypted tokens). */
+export interface StorefrontV2ByoStatus {
+    infrastructureMode: StorefrontV2InfrastructureMode;
+    githubAppConfigured: boolean;
+    vercelOauthConfigured: boolean;
+    githubConnected: boolean;
+    vercelConnected: boolean;
+    githubAccountLogin?: string | null;
+    githubInstallationId?: string | null;
+    vercelTeamId?: string | null;
+}
+export interface StorefrontV2Config {
+    id?: number;
+    domainId?: number;
+    status?: 'provisioning' | 'ready' | 'failed' | 'archived' | string;
+    starterTemplate?: string | null;
+    urlStructure?: string | null;
+    defaultBranch?: string | null;
+    activePreviewBranchName?: string | null;
+    activePreviewStartedAt?: string | null;
+    activePreviewLastRequestId?: number | null;
+    repoProvider?: string | null;
+    repoOwner?: string | null;
+    repoName?: string | null;
+    vercelProjectId?: string | null;
+    vercelTeamId?: string | null;
+    infrastructureMode?: StorefrontV2InfrastructureMode | string | null;
+    githubInstallationId?: string | null;
+    githubAccountLogin?: string | null;
+    byo?: StorefrontV2ByoStatus | null;
+    lastSuccessfulCommitSha?: string | null;
+    googleIntegrations?: StorefrontGoogleIntegrations | null;
+    approvedStarterTemplates?: string[];
+    providerMode?: 'real' | 'deterministic' | 'unknown' | string;
+    isProvisioned?: boolean;
+    creationDate?: string | null;
+    updatedAt?: string | null;
+}
+export interface StorefrontV2GetResponse {
+    storefrontV2?: StorefrontV2Config;
+    isProvisioned?: boolean;
+    provisioned?: boolean;
+    providerMode?: string;
+    approvedStarterTemplates?: string[];
+}
+export interface StorefrontV2ProvisionPayload {
+    starterTemplate?: string;
+    urlStructure?: string;
+}
+export interface StorefrontV2StarterTemplateUrlStructureResult {
+    starterTemplate: string;
+    urlStructure: string;
+}
+export interface StorefrontV2SiteContextInput {
+    url?: string;
+    sourceUrl?: string;
+}
+export interface StorefrontV2GenerationBriefQuestionOption {
+    id: string;
+    label: string;
+}
+export interface StorefrontV2GenerationBriefQuestion {
+    id: string;
+    topicId: string;
+    prompt: string;
+    type: 'single' | 'multi' | 'text';
+    options?: StorefrontV2GenerationBriefQuestionOption[];
+    required?: boolean;
+}
+export interface StorefrontV2GenerationBriefGapTopic {
+    id: string;
+    category: string;
+    severity: 'high' | 'medium' | 'low' | string;
+    evidence: string;
+    suggestedOptions?: string[];
+}
+export interface StorefrontV2GenerationBrief {
+    planSummary: string;
+    boilerplateFit: string;
+    gapTopics: StorefrontV2GenerationBriefGapTopic[];
+    questions: StorefrontV2GenerationBriefQuestion[];
+    questionCount: number;
+}
+export interface StorefrontV2GenerationBriefPayload {
+    siteContext: StorefrontV2SiteContext;
+    urlStructure?: string;
+    starterTemplate?: string;
+}
+export interface StorefrontV2ResetResult {
+    status: string;
+    isProvisioned: boolean;
+    providerMode?: 'real' | 'deterministic' | 'unknown' | string;
+    approvedStarterTemplates?: string[];
+}
+export interface StorefrontV2RepositoryTreeEntry {
+    name: string;
+    path: string;
+    type: 'directory' | 'file';
+}
+export interface StorefrontV2RepositoryTree {
+    path: string;
+    ref: string;
+    entries: StorefrontV2RepositoryTreeEntry[];
+}
+export interface StorefrontV2RepositoryBranches {
+    defaultBranch: string;
+    activeBranchName?: string | null;
+    branches: string[];
+}
+export interface StorefrontV2RepositoryFile {
+    path: string;
+    ref: string;
+    sha?: string;
+    content: string;
+}
+export interface StorefrontV2RepositoryFileUpdate {
+    path: string;
+    branch: string;
+    commitSha: string;
+}
+export interface StorefrontV2RepositoryFileUpdatePayload {
+    path: string;
+    content: string;
+    message?: string;
+    branch?: string;
+}
+export interface StorefrontV2Deployment {
+    id: string;
+    environment: 'preview' | 'production' | string;
+    status: string;
+    commitSha?: string | null;
+    url?: string | null;
+}
+export interface StorefrontV2DeploymentLog {
+    timestamp: string;
+    level: string;
+    message: string;
+}
+export interface StorefrontV2RollbackResult {
+    status: string;
+    targetCommitSha: string;
+    deployment?: {
+        deploymentId: string;
+        status?: string;
+    };
+}
+export interface StorefrontV2ProductPublishResult {
+    action: 'deploy' | 'recache' | string;
+    productName?: string | null;
+    productId?: number | null;
+    lastDeployed?: number | null;
+    status?: string;
+    productUrl?: string;
+    deploymentId?: string;
+    previewUrl?: string;
+    branchName?: string;
+    message?: string;
+    httpStatus?: number;
+}
+export interface StorefrontV2ProductStatus {
+    activated: boolean;
+    outOfSync?: boolean;
+    lastUpdated?: number | null;
+    lastDeployed?: number | null;
+}
+export interface StorefrontV2CategoryPublishResult {
+    action: 'deploy' | 'recache' | string;
+    categoryName?: string | null;
+    status?: string;
+    categoryUrl?: string;
+    deploymentId?: string;
+    previewUrl?: string;
+    branchName?: string;
+    message?: string;
+    httpStatus?: number;
+}
+export interface StorefrontV2ProductPublishPayload {
+    productName?: string;
+    productUrl?: string;
+    productId?: number;
+    branchName?: string;
+}
+export interface StorefrontV2CategoryPublishPayload {
+    categoryName?: string;
+    categoryUrl?: string;
+    branchName?: string;
+}
+export interface StorefrontV2EmulationRoute {
+    name?: string;
+    path: string;
+    pageType?: string;
+    targetFile?: string;
+}
+export interface StorefrontV2EmulationSpec {
+    routeContract?: {
+        recommendedUrlStructure?: string;
+        dynamicParams?: string[];
+        routes?: StorefrontV2EmulationRoute[];
+    };
+    componentMapping?: Array<{
+        section?: string;
+        sourceSignals?: string[];
+        boilerplateTargets?: string[];
+        implementationNotes?: string;
+    }>;
+}
+export interface StorefrontV2PageAnalysisItem {
+    url: string;
+    title?: string | null;
+    description?: string | null;
+    h1?: string | null;
+    headings?: string[];
+    contentPreview?: string | null;
+}
+export interface StorefrontV2SiteContext {
+    sourceUrl: string;
+    style?: {
+        title?: string | null;
+        description?: string | null;
+        colors?: string[];
+        fontFamilies?: string[];
+    } | null;
+    sitemap?: string[];
+    navigation?: Array<{
+        label?: string;
+        url: string;
+    }>;
+    categories?: string[];
+    products?: string[];
+    scrapedCategories?: string[];
+    scrapedProducts?: string[];
+    domainCatalog?: {
+        categories?: Array<{
+            id?: number;
+            name?: string;
+            slug?: string;
+        }>;
+        products?: Array<{
+            id?: number;
+            name?: string;
+            slug?: string;
+            categories?: Array<{
+                id?: number;
+                name?: string;
+                slug?: string;
+            }>;
+        }>;
+    } | null;
+    catalogMapping?: {
+        categories?: Array<{
+            domainCategoryId?: number;
+            domainCategoryName?: string;
+            domainCategorySlug?: string;
+            scrapedCategoryLabel?: string | null;
+            matchedScrapedUrl?: string | null;
+            matchSource?: string | null;
+        }>;
+        products?: Array<{
+            domainProductId?: number;
+            domainProductName?: string;
+            domainProductSlug?: string;
+            domainCategoryIds?: number[];
+            domainCategoryNames?: string[];
+            scrapedProductLabel?: string | null;
+            matchedScrapedUrl?: string | null;
+            matchSource?: string | null;
+        }>;
+    } | null;
+    tracking?: Array<{
+        provider?: string;
+        value?: string;
+    }>;
+    wireframe?: string[];
+    stylesheets?: Array<{
+        url: string;
+        content: string;
+    }>;
+    pageAnalysis?: StorefrontV2PageAnalysisItem[];
+    emulationSpec?: StorefrontV2EmulationSpec | null;
+    analysisMarkdown?: string | null;
+    analysisFilePath?: string | null;
+    analysisJsonFilePath?: string | null;
+    analysisScreenshotPaths?: string[];
+    analysisScreenshots?: Array<{
+        name?: string;
+        pageUrl?: string;
+        path?: string;
+        viewport?: string;
+        width?: number;
+        height?: number;
+        screenshotUrl?: string;
+        mimeType?: string;
+        dataUrl?: string;
+    }>;
+    analysisBranch?: string | null;
+    analysisCommitSha?: string | null;
+    analysisJsonCommitSha?: string | null;
+}
+export declare class Domain extends Entity {
+    protected static resourceName: string;
+    protected static singularName: string;
+    protected static pluralName: string;
+    archived?: Date | null;
+    created?: Date | null;
+    id?: number;
+    domain?: string;
+    country?: string;
+    currency?: string;
+    callToActions?: string;
+    callToActionDetails?: any[];
+    isMaster?: boolean;
+    deploymentOnline?: boolean;
+    deploymentInProgress?: boolean;
+    deploymentSucceeded?: boolean;
+    deploymentMessage?: string;
+    deploymentKey?: string;
+    internalUseNotes?: string;
+    internalUseAiContext?: string;
+    aiContext?: string;
+    domainType?: DomainType;
+    subDomain?: string;
+    emailDomain?: string;
+    smsName?: string;
+    whatsappPhoneNumberId?: string;
+    showDomainPublicly?: boolean;
+    publicAccessRestricted?: boolean;
+    showDomainToAccessibleEntitiesOnly?: boolean;
+    enableEmailNotifications?: boolean;
+    enableSmsNotifications?: boolean;
+    enableWhatsappNotifications?: boolean;
+    mailgunRecords?: any[];
+    enableNotifications?: boolean;
+    assignToAgent?: boolean;
+    jobAgentPolicy?: {
+        toneInstructions?: string;
+        outreach?: {
+            clientMessaging?: 'auto' | 'team_draft_only';
+            sendEmail?: boolean;
+            sendSms?: boolean;
+            proactiveChase?: boolean;
+        };
+        playbooks?: {
+            deadlineAsk?: boolean;
+            emailIntake?: boolean;
+            drafting?: boolean;
+            designerAssign?: boolean;
+            productionTender?: boolean;
+            shipment?: boolean;
+            invoice?: boolean;
+        };
+    } | null;
+    merchiAgentUser?: User | null;
+    trackingCodeGoogleConversion?: string | null;
+    trackingCodeGoogleGlobal?: string | null;
+    apiSecret?: string | null;
+    apiAllowedOrigins?: string[] | null;
+    webflowApiKey?: string | null;
+    telegramChatId?: string;
+    shopifyShopUrl?: string | null;
+    shopifyIsActive?: boolean;
+    qrShopQrCode?: string | null;
+    unltdAiApiOrganizationId?: string;
+    unltdAiApiSecretKey?: string;
+    scalablePressApiKey?: string;
+    googleMerchantApiKey?: string;
+    googleMerchantId?: string;
+    googleProductReviewsFeedEnabled?: boolean;
+    googleProductReviewsFeedToken?: string | null;
+    googleProductReviewsFeedUrl?: string | null;
+    socialBitchute?: string | null;
+    socialDiscord?: string | null;
+    socialFacebook?: string | null;
+    socialGoogle?: string | null;
+    socialInstagram?: string | null;
+    socialLinkedin?: string | null;
+    socialRumble?: string | null;
+    socialTelegram?: string | null;
+    socialTiktok?: string | null;
+    socialX?: string | null;
+    socialYoutube?: string | null;
+    ownedBy?: Company;
+    company?: Company;
+    logo?: MerchiFile | null;
+    favicon?: MerchiFile | null;
+    shipmentMethods?: ShipmentMethod[];
+    activeTheme?: Theme;
+    internalTags?: InternalTag[];
+    tags?: DomainTag[];
+    canSupply?: Domain[];
+    suppliedBy?: Domain[];
+    accessibleClients?: User[];
+    accessibleClientCompanies?: Company[];
+    sessions?: Session[];
+    categories?: Category[];
+    notifications?: Notification[];
+    reminders?: Reminder[];
+    products?: Product[];
+    supplyProducts?: SupplyDomain[];
+    jobs?: Job[];
+    jobsAssignees?: User[];
+    carts?: Cart[];
+    enrollments?: EnrolledDomain[];
+    invoices?: Invoice[];
+    domainInvitations?: DomainInvitation[];
+    domainChatSettings?: DomainChatSettings | null;
+    themes?: Theme[];
+    defaultTaxType: () => import("./country_tax.js").CountryTax | null;
+    getActiveTheme: () => Theme;
+    private getDomainId;
+    private storefrontV2DomainResource;
+    private storefrontV2Request;
+    getStorefrontV2: () => Promise<StorefrontV2GetResponse>;
+    provisionStorefrontV2: (payload?: StorefrontV2ProvisionPayload) => Promise<{
+        storefrontV2: StorefrontV2Config;
+    }>;
+    resolveStarterTemplateUrlStructure: (payload: {
+        starterTemplate: string;
+    }) => Promise<StorefrontV2StarterTemplateUrlStructureResult>;
+    extractStorefrontV2SiteContext: (payload: StorefrontV2SiteContextInput) => Promise<{
+        siteContext: StorefrontV2SiteContext;
+    }>;
+    createStorefrontV2GenerationBrief: (payload: StorefrontV2GenerationBriefPayload) => Promise<{
+        generationBrief: StorefrontV2GenerationBrief;
+    }>;
+    resetStorefrontV2: () => Promise<StorefrontV2ResetResult>;
+    getStorefrontV2GoogleIntegrations: () => Promise<{
+        googleIntegrations: StorefrontGoogleIntegrations;
+    }>;
+    saveStorefrontV2GoogleIntegrations: (payload: StorefrontGoogleIntegrations | {
+        googleIntegrations: StorefrontGoogleIntegrations;
+    }) => Promise<{
+        googleIntegrations: StorefrontGoogleIntegrations;
+    }>;
+    getStorefrontV2GaStatus: () => Promise<{
+        gaStatus: Record<string, any>;
+    }>;
+    verifyStorefrontV2GaInstallation: () => Promise<{
+        gaVerification: Record<string, any>;
+    }>;
+    analyzeStorefrontV2Ga: (payload?: {
+        days?: number;
+    }) => Promise<{
+        gaAnalysis: Record<string, any>;
+    }>;
+    applyStorefrontV2GaRecommendations: (payload: {
+        recommendationIds: string[];
+        recommendations?: Array<Record<string, any>>;
+        narrative?: string;
+        days?: number;
+        startNewBranch?: boolean;
+        branchName?: string;
+    }) => Promise<{
+        storefrontChangeRequest: StorefrontV2ChangeRequest;
+    }>;
+    getStorefrontV2GscStatus: () => Promise<{
+        gscStatus: Record<string, any>;
+    }>;
+    analyzeStorefrontV2Gsc: (payload?: {
+        days?: number;
+    }) => Promise<{
+        gscAnalysis: Record<string, any>;
+    }>;
+    applyStorefrontV2GscRecommendations: (payload: {
+        recommendationIds: string[];
+        recommendations?: Array<Record<string, any>>;
+        narrative?: string;
+        days?: number;
+        startNewBranch?: boolean;
+        branchName?: string;
+    }) => Promise<{
+        storefrontChangeRequest: StorefrontV2ChangeRequest;
+    }>;
+    createStorefrontChangeRequest: (payload?: StorefrontV2ChangeRequestPayload) => Promise<{
+        storefrontChangeRequest: StorefrontV2ChangeRequest;
+    }>;
+    getStorefrontChangeRequest: (requestId: number | string) => Promise<{
+        storefrontChangeRequest: StorefrontV2ChangeRequest;
+    }>;
+    getStorefrontChangeRequestEvents: (requestId: number | string) => Promise<{
+        requestId: number;
+        events: StorefrontExecutionEvent[];
+    }>;
+    runStorefrontChangeRequest: (requestId: number | string, payload?: StorefrontV2ChangeRequestRunPayload) => Promise<{
+        storefrontChangeRequest: StorefrontV2ChangeRequest;
+    }>;
+    approveStorefrontChangeRequest: (requestId: number | string, payload?: Record<string, any>) => Promise<{
+        storefrontChangeRequest: StorefrontV2ChangeRequest;
+    }>;
+    rejectStorefrontChangeRequest: (requestId: number | string, payload?: StorefrontV2ChangeRequestRejectPayload) => Promise<{
+        storefrontChangeRequest: StorefrontV2ChangeRequest;
+    }>;
+    getStorefrontV2Deployments: () => Promise<{
+        deployments: StorefrontV2Deployment[];
+    }>;
+    getStorefrontV2DeploymentLogs: (deploymentId: number | string) => Promise<{
+        deploymentId: string;
+        logs: StorefrontV2DeploymentLog[];
+    }>;
+    rollbackStorefrontV2: () => Promise<{
+        rollback: StorefrontV2RollbackResult;
+    }>;
+    getStorefrontV2RepositoryTree: (input?: {
+        path?: string;
+        ref?: string;
+    }) => Promise<{
+        repositoryTree: StorefrontV2RepositoryTree;
+    }>;
+    getStorefrontV2RepositoryBranches: () => Promise<{
+        repositoryBranches: StorefrontV2RepositoryBranches;
+    }>;
+    getStorefrontV2RepositoryFile: (path: string, input?: {
+        ref?: string;
+    }) => Promise<{
+        repositoryFile: StorefrontV2RepositoryFile;
+    }>;
+    updateStorefrontV2RepositoryFile: (payload: StorefrontV2RepositoryFileUpdatePayload) => Promise<{
+        repositoryFileUpdate: StorefrontV2RepositoryFileUpdate;
+    }>;
+    getStorefrontV2ProductStatus: (productId: number) => Promise<{
+        storefrontProductStatus: StorefrontV2ProductStatus;
+    }>;
+    publishStorefrontV2Product: (payload?: StorefrontV2ProductPublishPayload) => Promise<{
+        productPublish: StorefrontV2ProductPublishResult;
+    }>;
+    publishStorefrontV2Category: (payload?: StorefrontV2CategoryPublishPayload) => Promise<{
+        categoryPublish: StorefrontV2CategoryPublishResult;
+    }>;
+    getAnalytics: () => Promise<DomainAnalyticsResponse>;
+    getAgentTokenAnalytics: (queryParams?: Record<string, string | undefined>) => Promise<AgentTokenAnalyticsTimeseries>;
+}

package/dist/entities/domain.test.d.ts

@@ -0,0 +1 @@
+export {};