@01.software/sdk 0.14.0 → 0.15.0

package/dist/{payload-types-DH1fKdM3.d.cts → payload-types-Cjbr7XZZ.d.cts}

@@ -19,8 +19,12 @@ interface Config {
         'personal-access-tokens': PersonalAccessToken;
         tenants: Tenant;
         'tenant-metadata': TenantMetadatum;
+        'tenant-auth-settings': TenantAuthSetting;
+        'tenant-community-settings': TenantCommunitySetting;
         'api-usage': ApiUsage;
         'tenant-analytics-daily': TenantAnalyticsDaily;
+        'analytics-event-schemas': AnalyticsEventSchema;
+        'tenant-entitlements': TenantEntitlement;
         subscriptions: Subscription;
         'billing-history': BillingHistory;
         'tenant-logos': TenantLogo;
@@ -148,8 +152,12 @@ interface Config {
         'personal-access-tokens': PersonalAccessTokensSelect<false> | PersonalAccessTokensSelect<true>;
         tenants: TenantsSelect<false> | TenantsSelect<true>;
         'tenant-metadata': TenantMetadataSelect<false> | TenantMetadataSelect<true>;
+        'tenant-auth-settings': TenantAuthSettingsSelect<false> | TenantAuthSettingsSelect<true>;
+        'tenant-community-settings': TenantCommunitySettingsSelect<false> | TenantCommunitySettingsSelect<true>;
         'api-usage': ApiUsageSelect<false> | ApiUsageSelect<true>;
         'tenant-analytics-daily': TenantAnalyticsDailySelect<false> | TenantAnalyticsDailySelect<true>;
+        'analytics-event-schemas': AnalyticsEventSchemasSelect<false> | AnalyticsEventSchemasSelect<true>;
+        'tenant-entitlements': TenantEntitlementsSelect<false> | TenantEntitlementsSelect<true>;
         subscriptions: SubscriptionsSelect<false> | SubscriptionsSelect<true>;
         'billing-history': BillingHistorySelect<false> | BillingHistorySelect<true>;
         'tenant-logos': TenantLogosSelect<false> | TenantLogosSelect<true>;
@@ -315,6 +323,7 @@ interface CodeBlock {
  */
 interface User {
     id: string;
+    _users_members_order?: string | null;
     roles: ('super-admin' | 'user')[];
     tenants?: {
         tenant: string | Tenant;
@@ -376,34 +385,34 @@ interface Tenant {
      * Tenant owner. Only the owner can delete the tenant or transfer ownership.
      */
     owner: string | User;
-    plan: 'free' | 'starter' | 'basic' | 'pro' | 'enterprise';
-    features?: ('ecommerce' | 'customers' | 'playlists' | 'galleries' | 'links' | 'forms' | 'posts' | 'documents' | 'canvas' | 'videos' | 'live-streaming' | 'community')[] | null;
     /**
-     * Require email verification on customer registration. Verification token is delivered via webhook (operation: verification). You must configure a webhook URL first.
+     * Feature projection entries. Each item carries feature + provenance.
      */
-    requiresEmailVerification?: boolean | null;
+    features?: {
+        feature: 'ecommerce' | 'customers' | 'playlists' | 'galleries' | 'links' | 'forms' | 'posts' | 'documents' | 'canvas' | 'videos' | 'live-streaming' | 'community';
+        provenance: string;
+        id?: string | null;
+    }[] | null;
     /**
-     * When enabled, new threads require admin approval before being published.
+     * Features this tenant has opted out of. Only effective for features granted by the plan.
      */
-    requiresPostApproval?: boolean | null;
+    disabledFeatures?: ('ecommerce' | 'customers' | 'playlists' | 'galleries' | 'links' | 'forms' | 'posts' | 'documents' | 'canvas' | 'videos' | 'live-streaming' | 'community')[] | null;
     /**
      * Dev mode shows configuration tools like the field settings panel. Turn off after setup for a clean production UI.
      */
     isDevMode?: boolean | null;
     status?: ('active' | 'paused' | 'past_due' | 'canceled' | 'pending_deletion') | null;
-    trialEndsAt?: string | null;
-    deletionScheduledAt?: string | null;
     /**
-     * Allowed CORS origins for browser SDK requests. Empty = all origins allowed.
+     * Publishable Key — safe to embed in browser code. Prefix: pk01_
+     */
+    publishableKey: string;
+    /**
+     * Allowed CORS origins for browser SDK requests. Together with the publishable key, this defines browser access boundaries. Empty = all origins allowed.
      */
     cors?: {
         origin: string;
         id?: string | null;
     }[] | null;
-    /**
-     * Publishable Key — safe to embed in browser code. Prefix: pk01_
-     */
-    publishableKey: string;
     /**
      * Webhook endpoints to notify on data changes.
      */
@@ -412,6 +421,10 @@ interface Tenant {
          * e.g. Main Server, Analytics
          */
         name?: string | null;
+        /**
+         * Leave empty for legacy generic collection-change delivery. verification/password-reset are reserved for auth delivery only.
+         */
+        purpose?: ('events' | 'verification' | 'password-reset') | null;
         /**
          * The URL to send webhooks to. Must be HTTPS.
          */
@@ -431,7 +444,7 @@ interface Tenant {
         hasNextPage?: boolean;
         totalDocs?: number;
     };
-    webAnalytics?: {
+    webAnalytics: {
         enabled?: boolean | null;
         /**
          * Empty = browser analytics disabled (fail-closed)
@@ -440,6 +453,14 @@ interface Tenant {
             origin: string;
             id?: string | null;
         }[] | null;
+        /**
+         * Timezone for daily bucket calculation. Cannot be changed after analytics data is created (v1).
+         */
+        timezone: string;
+        /**
+         * Automatically set to true after the first aggregate write. Only super-admin can unlock.
+         */
+        tzLocked?: boolean | null;
     };
     updatedAt: string;
     createdAt: string;
@@ -452,6 +473,11 @@ interface Image {
     id: string;
     tenant?: (string | null) | Tenant;
     alt?: string | null;
+    caption?: string | null;
+    /**
+     * Photographer or source attribution
+     */
+    credit?: string | null;
     /**
      * Low quality image placeholder
      */
@@ -849,6 +875,11 @@ interface BrandLogo {
     id: string;
     tenant?: (string | null) | Tenant;
     alt?: string | null;
+    caption?: string | null;
+    /**
+     * Photographer or source attribution
+     */
+    credit?: string | null;
     /**
      * Low quality image placeholder
      */
@@ -932,6 +963,34 @@ interface BrandLogo {
         };
     };
 }
+/**
+ * This interface was referenced by `Config`'s JSON-Schema
+ * via the `definition` "tenant-auth-settings".
+ */
+interface TenantAuthSetting {
+    id: string;
+    tenant?: (string | null) | Tenant;
+    /**
+     * Require customer email verification before registration-dependent auth flows proceed.
+     */
+    requiresEmailVerification?: boolean | null;
+    updatedAt: string;
+    createdAt: string;
+}
+/**
+ * This interface was referenced by `Config`'s JSON-Schema
+ * via the `definition` "tenant-community-settings".
+ */
+interface TenantCommunitySetting {
+    id: string;
+    tenant?: (string | null) | Tenant;
+    /**
+     * When enabled, new customer-created threads remain pending until approved by an admin.
+     */
+    requiresPostApproval?: boolean | null;
+    updatedAt: string;
+    createdAt: string;
+}
 /**
  * This interface was referenced by `Config`'s JSON-Schema
  * via the `definition` "api-usage".
@@ -1015,8 +1074,95 @@ interface TenantAnalyticsDaily {
     eventsDropped?: {
         cardinality?: number | null;
         schema?: number | null;
+        late?: number | null;
+        origin?: number | null;
+        key?: number | null;
+        rate?: number | null;
+        disabled?: number | null;
     };
     snapshottedAt?: string | null;
+    /**
+     * 이 snapshot의 bucket이 계산된 tenant timezone
+     */
+    bucketTz: string;
+    /**
+     * aggregate의 dimension key 집합 해시 (shape mismatch 감지용). custom event 없는 날은 "pageview-only".
+     */
+    schemaShape: string;
+    /**
+     * Per-event dimension/page/referrer aggregates. Populated by snapshot cron when registered events have Redis data.
+     */
+    eventDetails?: {
+        eventName: string;
+        dimensions?: {
+            dimension: string;
+            values?: {
+                value: string;
+                count: number;
+                id?: string | null;
+            }[] | null;
+            id?: string | null;
+        }[] | null;
+        pages?: {
+            pathname: string;
+            count: number;
+            id?: string | null;
+        }[] | null;
+        referrers?: {
+            source: string;
+            count: number;
+            id?: string | null;
+        }[] | null;
+        id?: string | null;
+    }[] | null;
+    updatedAt: string;
+    createdAt: string;
+}
+/**
+ * This interface was referenced by `Config`'s JSON-Schema
+ * via the `definition` "analytics-event-schemas".
+ */
+interface AnalyticsEventSchema {
+    id: string;
+    tenant?: (string | null) | Tenant;
+    /**
+     * snake_case identifier. Must match /^[a-z][a-z0-9_]*$/
+     */
+    eventName: string;
+    enabled: boolean;
+    dimensions?: {
+        key: string;
+        type: 'enum' | 'boolean';
+        /**
+         * Comma-separated. Required when type=enum. Boolean auto-derives {true,false}. Max 20 values per key.
+         */
+        allowedValues?: string | null;
+        description?: string | null;
+        id?: string | null;
+    }[] | null;
+    createdBy?: (string | null) | User;
+    updatedBy?: (string | null) | User;
+    updatedAt: string;
+    createdAt: string;
+}
+/**
+ * This interface was referenced by `Config`'s JSON-Schema
+ * via the `definition` "tenant-entitlements".
+ */
+interface TenantEntitlement {
+    id: string;
+    tenant: string | Tenant;
+    plan: 'free' | 'starter' | 'basic' | 'pro' | 'enterprise';
+    status: 'active' | 'scheduled' | 'expired' | 'revoked';
+    sourceType: 'subscription' | 'manual' | 'support' | 'promo' | 'trial' | 'legacy_migration' | 'enterprise_contract';
+    sourceSubscription?: (string | null) | Subscription;
+    priority: number;
+    startsAt: string;
+    endsAt?: string | null;
+    reason?: string | null;
+    grantedBy?: (string | null) | User;
+    revokedAt?: string | null;
+    revokedBy?: (string | null) | User;
     updatedAt: string;
     createdAt: string;
 }
@@ -1035,7 +1181,7 @@ interface Subscription {
     amount: number;
     status: 'active' | 'past_due' | 'canceled' | 'expired' | 'suspended';
     currency: 'KRW' | 'USD';
-    provider: 'toss' | 'polar';
+    provider: 'toss';
     currentPeriodStart?: string | null;
     currentPeriodEnd?: string | null;
     trialStartAt?: string | null;
@@ -1061,14 +1207,6 @@ interface Subscription {
         number?: string | null;
         cardType?: string | null;
     };
-    /**
-     * Provider subscription ID
-     */
-    providerSubscriptionId?: string | null;
-    /**
-     * Provider customer ID
-     */
-    providerCustomerId?: string | null;
     /**
      * Additional provider metadata
      */
@@ -1107,7 +1245,7 @@ interface BillingHistory {
      * Plan at time of payment
      */
     plan: 'starter' | 'basic' | 'pro';
-    provider: 'toss' | 'polar';
+    provider: 'toss';
     currency: 'KRW' | 'USD';
     billingCycle?: ('monthly' | 'yearly') | null;
     periodStart?: string | null;
@@ -1127,16 +1265,6 @@ interface BillingHistory {
     tossResponse?: {
         [k: string]: unknown;
     } | unknown[] | string | number | boolean | null;
-    /**
-     * Polar order ID
-     */
-    polarOrderId?: string | null;
-    /**
-     * Full Polar API response
-     */
-    polarResponse?: {
-        [k: string]: unknown;
-    } | unknown[] | string | number | boolean | null;
     errorMessage?: string | null;
     /**
      * Original billing record for retry
@@ -1153,6 +1281,11 @@ interface TenantLogo {
     id: string;
     tenant?: (string | null) | Tenant;
     alt?: string | null;
+    caption?: string | null;
+    /**
+     * Photographer or source attribution
+     */
+    credit?: string | null;
     /**
      * Low quality image placeholder
      */
@@ -2216,6 +2349,14 @@ interface CustomerAddress {
     postalCode?: string | null;
     address1?: string | null;
     address2?: string | null;
+    /**
+     * Road name vs jibun address type
+     */
+    addressType?: ('road' | 'jibun') | null;
+    /**
+     * ISO 3166-1 alpha-2 country code
+     */
+    country?: string | null;
     isDefault?: boolean | null;
     /**
      * Default delivery message
@@ -2239,6 +2380,11 @@ interface OrderItem {
      * Price per unit at time of order
      */
     unitPrice: number;
+    variantTitle?: string | null;
+    sku?: string | null;
+    compareAtPrice?: number | null;
+    weight?: number | null;
+    requiresShipping?: boolean | null;
     /**
      * unitPrice × quantity
      */
@@ -2408,6 +2554,7 @@ interface ReturnItem {
     product: string | Product;
     variant?: (string | null) | ProductVariant;
     quantity: number;
+    restockAction: 'return_to_stock' | 'discard';
     productTitle?: string | null;
     updatedAt: string;
     createdAt: string;
@@ -2475,6 +2622,9 @@ interface Cart {
      */
     discountAmount?: number | null;
     totalAmount?: number | null;
+    /**
+     * Guest cart identity token. Immutable after creation.
+     */
     cartToken?: string | null;
     lastActivityAt?: string | null;
     abandonedAt?: string | null;
@@ -2626,7 +2776,7 @@ interface Post {
         };
         [k: string]: unknown;
     } | null;
-    author?: (string | null) | PostAuthor;
+    authors?: (string | PostAuthor)[] | null;
     categories?: (string | PostCategory)[] | null;
     tags?: (string | PostTag)[] | null;
     videos?: (string | Video)[] | null;
@@ -2670,7 +2820,6 @@ interface Post {
     thumbnail?: (string | null) | Image;
     images?: (string | Image)[] | null;
     publishedAt?: string | null;
-    customer?: (string | null) | Customer;
     isFeatured?: boolean | null;
     /**
      * Reading time (minutes)
@@ -2822,7 +2971,11 @@ interface Document {
      */
     changeLog?: string | null;
     /**
-     * Document that requires user agreement
+     * Audience/timing for required agreement
+     */
+    agreementScope?: ('all_users' | 'new_users' | 'on_update') | null;
+    /**
+     * Legacy compatibility field; replaced by agreementScope
      */
     requiresAgreement?: boolean | null;
     /**
@@ -3113,7 +3266,6 @@ interface Track {
      */
     sourceProvider?: string | null;
     sourceId?: string | null;
-    createdBy?: (string | null) | Customer;
     /**
      * ISRC
      */
@@ -3182,7 +3334,6 @@ interface TrackAsset {
     id: string;
     tenant?: (string | null) | Tenant;
     title?: string | null;
-    customer?: (string | null) | Customer;
     metadata?: {
         [k: string]: unknown;
     } | unknown[] | string | number | boolean | null;
@@ -3389,6 +3540,8 @@ interface Link {
     opensInNewTab?: boolean | null;
     noFollow?: boolean | null;
     expiresAt?: string | null;
+    clickCount?: number | null;
+    lastClickedAt?: string | null;
     status?: ('draft' | 'published' | 'archived') | null;
     isFeatured?: boolean | null;
     metadata?: {
@@ -4137,12 +4290,24 @@ interface PayloadLockedDocument {
     } | null) | ({
         relationTo: 'tenant-metadata';
         value: string | TenantMetadatum;
+    } | null) | ({
+        relationTo: 'tenant-auth-settings';
+        value: string | TenantAuthSetting;
+    } | null) | ({
+        relationTo: 'tenant-community-settings';
+        value: string | TenantCommunitySetting;
     } | null) | ({
         relationTo: 'api-usage';
         value: string | ApiUsage;
     } | null) | ({
         relationTo: 'tenant-analytics-daily';
         value: string | TenantAnalyticsDaily;
+    } | null) | ({
+        relationTo: 'analytics-event-schemas';
+        value: string | AnalyticsEventSchema;
+    } | null) | ({
+        relationTo: 'tenant-entitlements';
+        value: string | TenantEntitlement;
     } | null) | ({
         relationTo: 'subscriptions';
         value: string | Subscription;
@@ -4392,6 +4557,7 @@ interface PayloadMigration {
  * via the `definition` "users_select".
  */
 interface UsersSelect<T extends boolean = true> {
+    _users_members_order?: T;
     roles?: T;
     tenants?: T | {
         tenant?: T;
@@ -4452,6 +4618,8 @@ interface FieldConfigsSelect<T extends boolean = true> {
 interface ImagesSelect<T extends boolean = true> {
     tenant?: T;
     alt?: T;
+    caption?: T;
+    credit?: T;
     lqip?: T;
     palette?: T | {
         vibrant?: T;
@@ -4624,21 +4792,22 @@ interface TenantsSelect<T extends boolean = true> {
     name?: T;
     slug?: T;
     owner?: T;
-    plan?: T;
-    features?: T;
-    requiresEmailVerification?: T;
-    requiresPostApproval?: T;
+    features?: T | {
+        feature?: T;
+        provenance?: T;
+        id?: T;
+    };
+    disabledFeatures?: T;
     isDevMode?: T;
     status?: T;
-    trialEndsAt?: T;
-    deletionScheduledAt?: T;
+    publishableKey?: T;
     cors?: T | {
         origin?: T;
         id?: T;
     };
-    publishableKey?: T;
     webhooks?: T | {
         name?: T;
+        purpose?: T;
         url?: T;
         secret?: T;
         isEnabled?: T;
@@ -4651,6 +4820,8 @@ interface TenantsSelect<T extends boolean = true> {
             origin?: T;
             id?: T;
         };
+        timezone?: T;
+        tzLocked?: T;
     };
     updatedAt?: T;
     createdAt?: T;
@@ -4719,6 +4890,26 @@ interface TenantMetadataSelect<T extends boolean = true> {
     updatedAt?: T;
     createdAt?: T;
 }
+/**
+ * This interface was referenced by `Config`'s JSON-Schema
+ * via the `definition` "tenant-auth-settings_select".
+ */
+interface TenantAuthSettingsSelect<T extends boolean = true> {
+    tenant?: T;
+    requiresEmailVerification?: T;
+    updatedAt?: T;
+    createdAt?: T;
+}
+/**
+ * This interface was referenced by `Config`'s JSON-Schema
+ * via the `definition` "tenant-community-settings_select".
+ */
+interface TenantCommunitySettingsSelect<T extends boolean = true> {
+    tenant?: T;
+    requiresPostApproval?: T;
+    updatedAt?: T;
+    createdAt?: T;
+}
 /**
  * This interface was referenced by `Config`'s JSON-Schema
  * via the `definition` "api-usage_select".
@@ -4767,8 +4958,78 @@ interface TenantAnalyticsDailySelect<T extends boolean = true> {
     eventsDropped?: T | {
         cardinality?: T;
         schema?: T;
+        late?: T;
+        origin?: T;
+        key?: T;
+        rate?: T;
+        disabled?: T;
     };
     snapshottedAt?: T;
+    bucketTz?: T;
+    schemaShape?: T;
+    eventDetails?: T | {
+        eventName?: T;
+        dimensions?: T | {
+            dimension?: T;
+            values?: T | {
+                value?: T;
+                count?: T;
+                id?: T;
+            };
+            id?: T;
+        };
+        pages?: T | {
+            pathname?: T;
+            count?: T;
+            id?: T;
+        };
+        referrers?: T | {
+            source?: T;
+            count?: T;
+            id?: T;
+        };
+        id?: T;
+    };
+    updatedAt?: T;
+    createdAt?: T;
+}
+/**
+ * This interface was referenced by `Config`'s JSON-Schema
+ * via the `definition` "analytics-event-schemas_select".
+ */
+interface AnalyticsEventSchemasSelect<T extends boolean = true> {
+    tenant?: T;
+    eventName?: T;
+    enabled?: T;
+    dimensions?: T | {
+        key?: T;
+        type?: T;
+        allowedValues?: T;
+        description?: T;
+        id?: T;
+    };
+    createdBy?: T;
+    updatedBy?: T;
+    updatedAt?: T;
+    createdAt?: T;
+}
+/**
+ * This interface was referenced by `Config`'s JSON-Schema
+ * via the `definition` "tenant-entitlements_select".
+ */
+interface TenantEntitlementsSelect<T extends boolean = true> {
+    tenant?: T;
+    plan?: T;
+    status?: T;
+    sourceType?: T;
+    sourceSubscription?: T;
+    priority?: T;
+    startsAt?: T;
+    endsAt?: T;
+    reason?: T;
+    grantedBy?: T;
+    revokedAt?: T;
+    revokedBy?: T;
     updatedAt?: T;
     createdAt?: T;
 }
@@ -4797,8 +5058,6 @@ interface SubscriptionsSelect<T extends boolean = true> {
         number?: T;
         cardType?: T;
     };
-    providerSubscriptionId?: T;
-    providerCustomerId?: T;
     providerMetadata?: T;
     cancelAtPeriodEnd?: T;
     canceledAt?: T;
@@ -4834,8 +5093,6 @@ interface BillingHistorySelect<T extends boolean = true> {
     orderName?: T;
     paymentKey?: T;
     tossResponse?: T;
-    polarOrderId?: T;
-    polarResponse?: T;
     errorMessage?: T;
     retryOf?: T;
     updatedAt?: T;
@@ -4848,6 +5105,8 @@ interface BillingHistorySelect<T extends boolean = true> {
 interface TenantLogosSelect<T extends boolean = true> {
     tenant?: T;
     alt?: T;
+    caption?: T;
+    credit?: T;
     lqip?: T;
     palette?: T | {
         vibrant?: T;
@@ -5163,6 +5422,8 @@ interface BrandsSelect<T extends boolean = true> {
 interface BrandLogosSelect<T extends boolean = true> {
     tenant?: T;
     alt?: T;
+    caption?: T;
+    credit?: T;
     lqip?: T;
     palette?: T | {
         vibrant?: T;
@@ -5307,6 +5568,11 @@ interface OrderItemsSelect<T extends boolean = true> {
     variant?: T;
     quantity?: T;
     unitPrice?: T;
+    variantTitle?: T;
+    sku?: T;
+    compareAtPrice?: T;
+    weight?: T;
+    requiresShipping?: T;
     totalPrice?: T;
     productTitle?: T;
     updatedAt?: T;
@@ -5436,6 +5702,7 @@ interface ReturnItemsSelect<T extends boolean = true> {
     product?: T;
     variant?: T;
     quantity?: T;
+    restockAction?: T;
     productTitle?: T;
     updatedAt?: T;
     createdAt?: T;
@@ -5553,6 +5820,8 @@ interface CustomerAddressesSelect<T extends boolean = true> {
     postalCode?: T;
     address1?: T;
     address2?: T;
+    addressType?: T;
+    country?: T;
     isDefault?: T;
     deliveryMessage?: T;
     updatedAt?: T;
@@ -5683,7 +5952,7 @@ interface PostsSelect<T extends boolean = true> {
     subtitle?: T;
     description?: T;
     content?: T;
-    author?: T;
+    authors?: T;
     categories?: T;
     tags?: T;
     videos?: T;
@@ -5703,7 +5972,6 @@ interface PostsSelect<T extends boolean = true> {
     thumbnail?: T;
     images?: T;
     publishedAt?: T;
-    customer?: T;
     isFeatured?: T;
     readingMinutes?: T;
     excerpt?: T;
@@ -5789,6 +6057,7 @@ interface DocumentsSelect<T extends boolean = true> {
     effectiveAt?: T;
     expiresAt?: T;
     changeLog?: T;
+    agreementScope?: T;
     requiresAgreement?: T;
     keywords?: T | {
         keyword?: T;
@@ -5959,7 +6228,6 @@ interface TracksSelect<T extends boolean = true> {
     sourceUrl?: T;
     sourceProvider?: T;
     sourceId?: T;
-    createdBy?: T;
     isrc?: T;
     isExplicit?: T;
     previewUrl?: T;
@@ -5974,7 +6242,6 @@ interface TracksSelect<T extends boolean = true> {
 interface TrackAssetsSelect<T extends boolean = true> {
     tenant?: T;
     title?: T;
-    customer?: T;
     metadata?: T;
     prefix?: T;
     updatedAt?: T;
@@ -6137,6 +6404,8 @@ interface LinksSelect<T extends boolean = true> {
     opensInNewTab?: T;
     noFollow?: T;
     expiresAt?: T;
+    clickCount?: T;
+    lastClickedAt?: T;
     status?: T;
     isFeatured?: T;
     metadata?: T;