includio-cms 0.26.0 → 0.28.0

package/dist/core/server/generator/generator.js

@@ -1,6 +1,6 @@
 import { mkdirSync, readFileSync, writeFileSync, existsSync } from 'node:fs';
 import { join } from 'node:path';
-import { generateTsTypeFromFields, generateFlatTsTypeFromFields, generateInlineBlockTypeString, setGeneratorCustomFields } from './fields.js';
+import { generateTsTypeFromFields, generateFlatTsTypeFromFields, generateInlineBlockTypeString, setGeneratorCustomFields, setGeneratorShopVariantAttributes } from './fields.js';
 import { generateTsTypeFromFormFields } from './formFields.js';
 import { generateZodSchemaStringFromFormFieldsAsString } from './formFieldSchemaToString.js';
 import { toPascalCase, quoteKey } from './utils.js';
@@ -312,6 +312,7 @@ export function generateRuntime(config) {
         }
     }
     setGeneratorCustomFields(customFields);
+    setGeneratorShopVariantAttributes(config.shop?.variantAttributes ?? {});
     createCmsRuntimeDir();
     generateTypes(config);
     generateAPI(config);

package/dist/db-postgres/schema/shop/index.d.ts

@@ -7,6 +7,7 @@ export * from './orderStatusHistory.js';
 export * from './payment.js';
 export * from './stockReservation.js';
 export * from './refunds.js';
+export * from './invoice.js';
 export * from './webhookEvents.js';
 export * from './coupons.js';
 export * from './couponRedemptions.js';

package/dist/db-postgres/schema/shop/index.js

@@ -7,6 +7,7 @@ export * from './orderStatusHistory.js';
 export * from './payment.js';
 export * from './stockReservation.js';
 export * from './refunds.js';
+export * from './invoice.js';
 export * from './webhookEvents.js';
 export * from './coupons.js';
 export * from './couponRedemptions.js';

package/dist/db-postgres/schema/shop/invoice.d.ts

@@ -0,0 +1,254 @@
+export type ShopInvoiceStatus = 'pending' | 'issued' | 'sent' | 'failed';
+/**
+ * One invoice per order (`order_id` is unique → idempotency guard). `external_id`
+ * / `number` / `pdf_url` come from the invoicing provider once issued. The
+ * `attempts` / `next_retry_at` columns are reserved for a future automatic-retry
+ * mechanism; the current flow only retries manually from the admin.
+ */
+export declare const shopInvoicesTable: import("drizzle-orm/pg-core/table", { with: { "resolution-mode": "require" } }).PgTableWithColumns<{
+    name: "shop_invoices";
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/pg-core", { with: { "resolution-mode": "require" } }).PgColumn<{
+            name: "id";
+            tableName: "shop_invoices";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        orderId: import("drizzle-orm/pg-core", { with: { "resolution-mode": "require" } }).PgColumn<{
+            name: "order_id";
+            tableName: "shop_invoices";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        provider: import("drizzle-orm/pg-core", { with: { "resolution-mode": "require" } }).PgColumn<{
+            name: "provider";
+            tableName: "shop_invoices";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        externalId: import("drizzle-orm/pg-core", { with: { "resolution-mode": "require" } }).PgColumn<{
+            name: "external_id";
+            tableName: "shop_invoices";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        number: import("drizzle-orm/pg-core", { with: { "resolution-mode": "require" } }).PgColumn<{
+            name: "number";
+            tableName: "shop_invoices";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        pdfUrl: import("drizzle-orm/pg-core", { with: { "resolution-mode": "require" } }).PgColumn<{
+            name: "pdf_url";
+            tableName: "shop_invoices";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        kind: import("drizzle-orm/pg-core", { with: { "resolution-mode": "require" } }).PgColumn<{
+            name: "kind";
+            tableName: "shop_invoices";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        status: import("drizzle-orm/pg-core", { with: { "resolution-mode": "require" } }).PgColumn<{
+            name: "status";
+            tableName: "shop_invoices";
+            dataType: "string";
+            columnType: "PgText";
+            data: ShopInvoiceStatus;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            $type: ShopInvoiceStatus;
+        }>;
+        attempts: import("drizzle-orm/pg-core", { with: { "resolution-mode": "require" } }).PgColumn<{
+            name: "attempts";
+            tableName: "shop_invoices";
+            dataType: "number";
+            columnType: "PgInteger";
+            data: number;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        nextRetryAt: import("drizzle-orm/pg-core", { with: { "resolution-mode": "require" } }).PgColumn<{
+            name: "next_retry_at";
+            tableName: "shop_invoices";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        lastError: import("drizzle-orm/pg-core", { with: { "resolution-mode": "require" } }).PgColumn<{
+            name: "last_error";
+            tableName: "shop_invoices";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        raw: import("drizzle-orm/pg-core", { with: { "resolution-mode": "require" } }).PgColumn<{
+            name: "raw";
+            tableName: "shop_invoices";
+            dataType: "json";
+            columnType: "PgJsonb";
+            data: unknown;
+            driverParam: unknown;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        createdAt: import("drizzle-orm/pg-core", { with: { "resolution-mode": "require" } }).PgColumn<{
+            name: "created_at";
+            tableName: "shop_invoices";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        updatedAt: import("drizzle-orm/pg-core", { with: { "resolution-mode": "require" } }).PgColumn<{
+            name: "updated_at";
+            tableName: "shop_invoices";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: "pg";
+}>;

package/dist/db-postgres/schema/shop/invoice.js

@@ -0,0 +1,27 @@
+import { integer, jsonb, pgTable, text, timestamp, uuid } from 'drizzle-orm/pg-core';
+import { shopOrdersTable } from './order.js';
+/**
+ * One invoice per order (`order_id` is unique → idempotency guard). `external_id`
+ * / `number` / `pdf_url` come from the invoicing provider once issued. The
+ * `attempts` / `next_retry_at` columns are reserved for a future automatic-retry
+ * mechanism; the current flow only retries manually from the admin.
+ */
+export const shopInvoicesTable = pgTable('shop_invoices', {
+    id: uuid('id').primaryKey().defaultRandom(),
+    orderId: uuid('order_id')
+        .notNull()
+        .unique()
+        .references(() => shopOrdersTable.id, { onDelete: 'cascade' }),
+    provider: text('provider').notNull(),
+    externalId: text('external_id'),
+    number: text('number'),
+    pdfUrl: text('pdf_url'),
+    kind: text('kind').notNull().default('vat'),
+    status: text('status').$type().notNull().default('pending'),
+    attempts: integer('attempts').notNull().default(0),
+    nextRetryAt: timestamp('next_retry_at', { withTimezone: true }),
+    lastError: text('last_error'),
+    raw: jsonb('raw'),
+    createdAt: timestamp('created_at', { withTimezone: true }).defaultNow().notNull(),
+    updatedAt: timestamp('updated_at', { withTimezone: true }).defaultNow().notNull()
+});

package/dist/db-postgres/schema/shop/order.d.ts

@@ -1,4 +1,4 @@
-import type { OrderStatus } from '../../../shop/types.js';
+import type { OrderStatus, PartialPayment } from '../../../shop/types.js';
 export declare const shopOrdersTable: import("drizzle-orm/pg-core/table", { with: { "resolution-mode": "require" } }).PgTableWithColumns<{
     name: "shop_orders";
     schema: undefined;
@@ -124,6 +124,40 @@ export declare const shopOrdersTable: import("drizzle-orm/pg-core/table", { with
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
+        customerNip: import("drizzle-orm/pg-core", { with: { "resolution-mode": "require" } }).PgColumn<{
+            name: "customer_nip";
+            tableName: "shop_orders";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        customerCompanyName: import("drizzle-orm/pg-core", { with: { "resolution-mode": "require" } }).PgColumn<{
+            name: "customer_company_name";
+            tableName: "shop_orders";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
         shippingAddress: import("drizzle-orm/pg-core", { with: { "resolution-mode": "require" } }).PgColumn<{
             name: "shipping_address";
             tableName: "shop_orders";
@@ -143,6 +177,42 @@ export declare const shopOrdersTable: import("drizzle-orm/pg-core/table", { with
         }, {}, {
             $type: Record<string, string>;
         }>;
+        billingAddress: import("drizzle-orm/pg-core", { with: { "resolution-mode": "require" } }).PgColumn<{
+            name: "billing_address";
+            tableName: "shop_orders";
+            dataType: "json";
+            columnType: "PgJsonb";
+            data: Record<string, string>;
+            driverParam: unknown;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            $type: Record<string, string>;
+        }>;
+        invoiceRequested: import("drizzle-orm/pg-core", { with: { "resolution-mode": "require" } }).PgColumn<{
+            name: "invoice_requested";
+            tableName: "shop_orders";
+            dataType: "boolean";
+            columnType: "PgBoolean";
+            data: boolean;
+            driverParam: boolean;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
         totalNet: import("drizzle-orm/pg-core", { with: { "resolution-mode": "require" } }).PgColumn<{
             name: "total_net";
             tableName: "shop_orders";
@@ -459,6 +529,42 @@ export declare const shopOrdersTable: import("drizzle-orm/pg-core/table", { with
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
+        partialPayment: import("drizzle-orm/pg-core", { with: { "resolution-mode": "require" } }).PgColumn<{
+            name: "partial_payment";
+            tableName: "shop_orders";
+            dataType: "json";
+            columnType: "PgJsonb";
+            data: PartialPayment | null;
+            driverParam: unknown;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            $type: PartialPayment | null;
+        }>;
+        balanceOwed: import("drizzle-orm/pg-core", { with: { "resolution-mode": "require" } }).PgColumn<{
+            name: "balance_owed";
+            tableName: "shop_orders";
+            dataType: "boolean";
+            columnType: "PgBoolean";
+            data: boolean;
+            driverParam: boolean;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
         createdAt: import("drizzle-orm/pg-core", { with: { "resolution-mode": "require" } }).PgColumn<{
             name: "created_at";
             tableName: "shop_orders";

package/dist/db-postgres/schema/shop/order.js

@@ -1,4 +1,4 @@
-import { integer, jsonb, pgTable, text, timestamp, uuid } from 'drizzle-orm/pg-core';
+import { boolean, integer, jsonb, pgTable, text, timestamp, uuid } from 'drizzle-orm/pg-core';
 import { shopShippingMethodsTable } from './shippingMethod.js';
 export const shopOrdersTable = pgTable('shop_orders', {
     id: uuid('id').primaryKey().defaultRandom(),
@@ -8,7 +8,11 @@ export const shopOrdersTable = pgTable('shop_orders', {
     customerEmail: text('customer_email').notNull(),
     customerName: text('customer_name'),
     customerPhone: text('customer_phone'),
+    customerNip: text('customer_nip'),
+    customerCompanyName: text('customer_company_name'),
     shippingAddress: jsonb('shipping_address').$type(),
+    billingAddress: jsonb('billing_address').$type(),
+    invoiceRequested: boolean('invoice_requested').default(false).notNull(),
     totalNet: integer('total_net').notNull(),
     totalGross: integer('total_gross').notNull(),
     vatAmount: integer('vat_amount').notNull(),
@@ -29,6 +33,8 @@ export const shopOrdersTable = pgTable('shop_orders', {
     notes: text('notes'),
     language: text('language'),
     accessToken: uuid('access_token').defaultRandom().notNull(),
+    partialPayment: jsonb('partial_payment').$type(),
+    balanceOwed: boolean('balance_owed').default(false).notNull(),
     createdAt: timestamp('created_at', { withTimezone: true }).defaultNow().notNull(),
     updatedAt: timestamp('updated_at', { withTimezone: true }).defaultNow().notNull()
 });

package/dist/db-postgres/schema/shop/payment.d.ts

@@ -1,4 +1,7 @@
 export type ShopPaymentStatus = 'pending' | 'paid' | 'failed' | 'refunded' | 'cancelled';
+/** `kind` distinguishes full / deposit / balance payment rows under paymentPolicy A-lite. */
+export declare const shopPaymentKindEnum: import("drizzle-orm/pg-core", { with: { "resolution-mode": "require" } }).PgEnum<["full", "deposit", "balance"]>;
+export type ShopPaymentKind = 'full' | 'deposit' | 'balance';
 export declare const shopPaymentsTable: import("drizzle-orm/pg-core/table", { with: { "resolution-mode": "require" } }).PgTableWithColumns<{
     name: "shop_payments";
     schema: undefined;
@@ -90,6 +93,23 @@ export declare const shopPaymentsTable: import("drizzle-orm/pg-core/table", { wi
         }, {}, {
             $type: ShopPaymentStatus;
         }>;
+        kind: import("drizzle-orm/pg-core", { with: { "resolution-mode": "require" } }).PgColumn<{
+            name: "kind";
+            tableName: "shop_payments";
+            dataType: "string";
+            columnType: "PgEnumColumn";
+            data: "full" | "deposit" | "balance";
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: ["full", "deposit", "balance"];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
         amount: import("drizzle-orm/pg-core", { with: { "resolution-mode": "require" } }).PgColumn<{
             name: "amount";
             tableName: "shop_payments";

package/dist/db-postgres/schema/shop/payment.js

@@ -1,5 +1,7 @@
-import { integer, jsonb, pgTable, text, timestamp, uuid } from 'drizzle-orm/pg-core';
+import { integer, jsonb, pgEnum, pgTable, text, timestamp, uuid } from 'drizzle-orm/pg-core';
 import { shopOrdersTable } from './order.js';
+/** `kind` distinguishes full / deposit / balance payment rows under paymentPolicy A-lite. */
+export const shopPaymentKindEnum = pgEnum('shop_payment_kind', ['full', 'deposit', 'balance']);
 export const shopPaymentsTable = pgTable('shop_payments', {
     id: uuid('id').primaryKey().defaultRandom(),
     orderId: uuid('order_id')
@@ -8,6 +10,7 @@ export const shopPaymentsTable = pgTable('shop_payments', {
     provider: text('provider').notNull(),
     providerRef: text('provider_ref'),
     status: text('status').$type().notNull().default('pending'),
+    kind: shopPaymentKindEnum('kind').notNull().default('full'),
     amount: integer('amount').notNull(),
     currency: text('currency').notNull(),
     raw: jsonb('raw'),

package/dist/db-postgres/schema/shop/product.d.ts

@@ -1,3 +1,4 @@
+import type { PaymentPolicy } from '../../../shop/types.js';
 export declare const shopProductsTable: import("drizzle-orm/pg-core/table", { with: { "resolution-mode": "require" } }).PgTableWithColumns<{
     name: "shop_products";
     schema: undefined;
@@ -121,6 +122,25 @@ export declare const shopProductsTable: import("drizzle-orm/pg-core/table", { wi
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
+        paymentPolicy: import("drizzle-orm/pg-core", { with: { "resolution-mode": "require" } }).PgColumn<{
+            name: "payment_policy";
+            tableName: "shop_products";
+            dataType: "json";
+            columnType: "PgJsonb";
+            data: PaymentPolicy | null;
+            driverParam: unknown;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            $type: PaymentPolicy | null;
+        }>;
         createdAt: import("drizzle-orm/pg-core", { with: { "resolution-mode": "require" } }).PgColumn<{
             name: "created_at";
             tableName: "shop_products";

package/dist/db-postgres/schema/shop/product.js

@@ -1,4 +1,4 @@
-import { boolean, integer, numeric, pgTable, timestamp, uuid } from 'drizzle-orm/pg-core';
+import { boolean, integer, jsonb, numeric, pgTable, timestamp, uuid } from 'drizzle-orm/pg-core';
 import { entriesTable } from '../entry.js';
 export const shopProductsTable = pgTable('shop_products', {
     id: uuid('id').primaryKey().defaultRandom(),
@@ -13,6 +13,8 @@ export const shopProductsTable = pgTable('shop_products', {
     sortOrder: integer('sort_order'),
     // Null = alert disabled. When stock decrement crosses threshold, fire-and-forget admin email.
     lowStockThreshold: integer('low_stock_threshold'),
+    // Per-product payment policy. Null = full payment (legacy).
+    paymentPolicy: jsonb('payment_policy').$type(),
     createdAt: timestamp('created_at', { withTimezone: true }).defaultNow().notNull(),
     updatedAt: timestamp('updated_at', { withTimezone: true }).defaultNow().notNull()
 });

package/dist/db-postgres/schema/shop/productVariant.d.ts

@@ -1,3 +1,4 @@
+import type { VariantAttribute } from '../../../shop/types.js';
 export declare const shopProductVariantsTable: import("drizzle-orm/pg-core/table", { with: { "resolution-mode": "require" } }).PgTableWithColumns<{
     name: "shop_product_variants";
     schema: undefined;
@@ -111,7 +112,7 @@ export declare const shopProductVariantsTable: import("drizzle-orm/pg-core/table
             tableName: "shop_product_variants";
             dataType: "json";
             columnType: "PgJsonb";
-            data: Record<string, string>;
+            data: Record<string, unknown>;
             driverParam: unknown;
             notNull: false;
             hasDefault: false;
@@ -123,7 +124,7 @@ export declare const shopProductVariantsTable: import("drizzle-orm/pg-core/table
             identity: undefined;
             generated: undefined;
         }, {}, {
-            $type: Record<string, string>;
+            $type: Record<string, unknown>;
         }>;
         sortOrder: import("drizzle-orm/pg-core", { with: { "resolution-mode": "require" } }).PgColumn<{
             name: "sort_order";
@@ -162,3 +163,12 @@ export declare const shopProductVariantsTable: import("drizzle-orm/pg-core/table
     };
     dialect: "pg";
 }>;
+/**
+ * Build `CREATE INDEX IF NOT EXISTS … USING gin ((attributes->'<key>'))` DDL
+ * statements — one per attribute marked `indexable: true`. Drizzle's static
+ * schema can't capture user-defined variantAttributes, so apply these at shop
+ * bootstrap (or via the migration in `src/lib/updates/0.27.0`).
+ * Index name pattern: `shop_variant_attr_<key>_gin_idx`.
+ * @internal
+ */
+export declare function createVariantAttributeIndexes(attrs: Record<string, VariantAttribute>): string[];

package/dist/db-postgres/schema/shop/productVariant.js

@@ -14,3 +14,25 @@ export const shopProductVariantsTable = pgTable('shop_product_variants', {
     sortOrder: integer('sort_order'),
     createdAt: timestamp('created_at', { withTimezone: true }).defaultNow().notNull()
 });
+const SAFE_KEY = /^[a-zA-Z][a-zA-Z0-9_]*$/;
+/**
+ * Build `CREATE INDEX IF NOT EXISTS … USING gin ((attributes->'<key>'))` DDL
+ * statements — one per attribute marked `indexable: true`. Drizzle's static
+ * schema can't capture user-defined variantAttributes, so apply these at shop
+ * bootstrap (or via the migration in `src/lib/updates/0.27.0`).
+ * Index name pattern: `shop_variant_attr_<key>_gin_idx`.
+ * @internal
+ */
+export function createVariantAttributeIndexes(attrs) {
+    const stmts = [];
+    for (const [key, attr] of Object.entries(attrs)) {
+        if (!attr.indexable)
+            continue;
+        if (!SAFE_KEY.test(key)) {
+            throw new Error(`variantAttribute key "${key}" is not a safe SQL identifier (allowed: [A-Za-z][A-Za-z0-9_]*).`);
+        }
+        stmts.push(`CREATE INDEX IF NOT EXISTS shop_variant_attr_${key}_gin_idx ` +
+            `ON shop_product_variants USING gin ((attributes->'${key}'))`);
+    }
+    return stmts;
+}