@endora-commerce/contracts 0.100.0

package/dist/seo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seo.js","sourceRoot":"","sources":["../src/seo.ts"],"names":[],"mappings":"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"}

package/dist/settings.d.ts

@@ -0,0 +1,453 @@
+import { z } from 'zod';
+export declare const SettingValueTypeSchema: z.ZodEnum<{
+    string: "string";
+    number: "number";
+    boolean: "boolean";
+    json: "json";
+    string_list: "string_list";
+    secret: "secret";
+    credential_ref: "credential_ref";
+}>;
+export type SettingValueType = z.infer<typeof SettingValueTypeSchema>;
+/**
+ * Returns the Zod schema corresponding to a setting's declared `valueType`.
+ * Callers supplying their own narrower schema to `SettingsService.get<T>()`
+ * still get the looser per-type validation through this helper at write time.
+ *
+ * `secret` accepts a plain string on write (the backend encrypts before
+ * persisting — feature 043 / FR-021); read endpoints never return it.
+ */
+export declare function valueSchemaForType(t: SettingValueType): z.ZodType<unknown>;
+/**
+ * Setting code shape. Exported because feature 073's module activation block
+ * (`ModuleActivationSchema` in `modules.ts`) declares the code of an ordinary
+ * Setting row and must validate it identically.
+ */
+export declare const settingCodeRe: RegExp;
+export declare const GroupManifestEntrySchema: z.ZodObject<{
+    code: z.ZodString;
+    name: z.ZodString;
+    salesChannelCodes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    isSystemProtected: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type GroupManifestEntry = z.infer<typeof GroupManifestEntrySchema>;
+export declare const SettingManifestEntrySchema: z.ZodObject<{
+    code: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    groupCode: z.ZodOptional<z.ZodString>;
+    valueType: z.ZodEnum<{
+        string: "string";
+        number: "number";
+        boolean: "boolean";
+        json: "json";
+        string_list: "string_list";
+        secret: "secret";
+        credential_ref: "credential_ref";
+    }>;
+    defaultValue: z.ZodUnknown;
+    previousDefaultValues: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+    salesChannelCodes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    enumOptions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    configurationType: z.ZodOptional<z.ZodString>;
+    hidden: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type SettingManifestEntry = z.infer<typeof SettingManifestEntrySchema>;
+export declare const ModuleSettingsManifestSchema: z.ZodObject<{
+    moduleCode: z.ZodString;
+    groups: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        name: z.ZodString;
+        salesChannelCodes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        isSystemProtected: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>>;
+    settings: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        groupCode: z.ZodOptional<z.ZodString>;
+        valueType: z.ZodEnum<{
+            string: "string";
+            number: "number";
+            boolean: "boolean";
+            json: "json";
+            string_list: "string_list";
+            secret: "secret";
+            credential_ref: "credential_ref";
+        }>;
+        defaultValue: z.ZodUnknown;
+        previousDefaultValues: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+        salesChannelCodes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        enumOptions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        configurationType: z.ZodOptional<z.ZodString>;
+        hidden: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type ModuleSettingsManifest = z.infer<typeof ModuleSettingsManifestSchema>;
+/**
+ * Identity-with-validation helper for module authors. Modules export a single
+ * constant with `defineModuleSettingsManifest({...})`; this gives them full
+ * TypeScript inference and the reconciler can ingest the value directly.
+ */
+export declare function defineModuleSettingsManifest(m: ModuleSettingsManifest): ModuleSettingsManifest;
+export declare const SettingValueByChannelSchema: z.ZodObject<{
+    salesChannelId: z.ZodUUID;
+    salesChannelCode: z.ZodString;
+    value: z.ZodUnknown;
+    isSet: z.ZodOptional<z.ZodBoolean>;
+    updatedAt: z.ZodISODateTime;
+}, z.core.$strip>;
+export declare const SettingDtoSchema: z.ZodObject<{
+    id: z.ZodUUID;
+    code: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodNullable<z.ZodString>;
+    valueType: z.ZodEnum<{
+        string: "string";
+        number: "number";
+        boolean: "boolean";
+        json: "json";
+        string_list: "string_list";
+        secret: "secret";
+        credential_ref: "credential_ref";
+    }>;
+    ownerModule: z.ZodString;
+    salesChannelCodes: z.ZodArray<z.ZodString>;
+    enumOptions: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+    configurationType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    defaultValue: z.ZodUnknown;
+    globalValue: z.ZodNullable<z.ZodUnknown>;
+    globalValueIsSet: z.ZodOptional<z.ZodBoolean>;
+    valuesByChannel: z.ZodArray<z.ZodObject<{
+        salesChannelId: z.ZodUUID;
+        salesChannelCode: z.ZodString;
+        value: z.ZodUnknown;
+        isSet: z.ZodOptional<z.ZodBoolean>;
+        updatedAt: z.ZodISODateTime;
+    }, z.core.$strip>>;
+    version: z.ZodISODateTime;
+    editable: z.ZodOptional<z.ZodBoolean>;
+    activationControl: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type SettingDto = z.infer<typeof SettingDtoSchema>;
+export declare const SettingGroupDtoSchema: z.ZodObject<{
+    id: z.ZodUUID;
+    code: z.ZodString;
+    name: z.ZodString;
+    isSystemProtected: z.ZodBoolean;
+    ownerModule: z.ZodString;
+    salesChannelCodes: z.ZodArray<z.ZodString>;
+    settings: z.ZodArray<z.ZodObject<{
+        id: z.ZodUUID;
+        code: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodNullable<z.ZodString>;
+        valueType: z.ZodEnum<{
+            string: "string";
+            number: "number";
+            boolean: "boolean";
+            json: "json";
+            string_list: "string_list";
+            secret: "secret";
+            credential_ref: "credential_ref";
+        }>;
+        ownerModule: z.ZodString;
+        salesChannelCodes: z.ZodArray<z.ZodString>;
+        enumOptions: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        configurationType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        defaultValue: z.ZodUnknown;
+        globalValue: z.ZodNullable<z.ZodUnknown>;
+        globalValueIsSet: z.ZodOptional<z.ZodBoolean>;
+        valuesByChannel: z.ZodArray<z.ZodObject<{
+            salesChannelId: z.ZodUUID;
+            salesChannelCode: z.ZodString;
+            value: z.ZodUnknown;
+            isSet: z.ZodOptional<z.ZodBoolean>;
+            updatedAt: z.ZodISODateTime;
+        }, z.core.$strip>>;
+        version: z.ZodISODateTime;
+        editable: z.ZodOptional<z.ZodBoolean>;
+        activationControl: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type SettingGroupDto = z.infer<typeof SettingGroupDtoSchema>;
+export declare const SettingsListResponseSchema: z.ZodObject<{
+    groups: z.ZodArray<z.ZodObject<{
+        id: z.ZodUUID;
+        code: z.ZodString;
+        name: z.ZodString;
+        isSystemProtected: z.ZodBoolean;
+        ownerModule: z.ZodString;
+        salesChannelCodes: z.ZodArray<z.ZodString>;
+        settings: z.ZodArray<z.ZodObject<{
+            id: z.ZodUUID;
+            code: z.ZodString;
+            name: z.ZodString;
+            description: z.ZodNullable<z.ZodString>;
+            valueType: z.ZodEnum<{
+                string: "string";
+                number: "number";
+                boolean: "boolean";
+                json: "json";
+                string_list: "string_list";
+                secret: "secret";
+                credential_ref: "credential_ref";
+            }>;
+            ownerModule: z.ZodString;
+            salesChannelCodes: z.ZodArray<z.ZodString>;
+            enumOptions: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+            configurationType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            defaultValue: z.ZodUnknown;
+            globalValue: z.ZodNullable<z.ZodUnknown>;
+            globalValueIsSet: z.ZodOptional<z.ZodBoolean>;
+            valuesByChannel: z.ZodArray<z.ZodObject<{
+                salesChannelId: z.ZodUUID;
+                salesChannelCode: z.ZodString;
+                value: z.ZodUnknown;
+                isSet: z.ZodOptional<z.ZodBoolean>;
+                updatedAt: z.ZodISODateTime;
+            }, z.core.$strip>>;
+            version: z.ZodISODateTime;
+            editable: z.ZodOptional<z.ZodBoolean>;
+            activationControl: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const SettingsListQuerySchema: z.ZodObject<{
+    groupCode: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const SetValueAllRequestSchema: z.ZodObject<{
+    scope: z.ZodLiteral<"all">;
+    value: z.ZodUnknown;
+}, z.core.$strip>;
+export declare const SetValueSubsetRequestSchema: z.ZodObject<{
+    scope: z.ZodLiteral<"subset">;
+    salesChannelCodes: z.ZodArray<z.ZodString>;
+    value: z.ZodUnknown;
+}, z.core.$strip>;
+export declare const SetValueRequestSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    scope: z.ZodLiteral<"all">;
+    value: z.ZodUnknown;
+}, z.core.$strip>, z.ZodObject<{
+    scope: z.ZodLiteral<"subset">;
+    salesChannelCodes: z.ZodArray<z.ZodString>;
+    value: z.ZodUnknown;
+}, z.core.$strip>], "scope">;
+export type SetValueRequest = z.infer<typeof SetValueRequestSchema>;
+export declare const ResetValueQuerySchema: z.ZodObject<{
+    salesChannelCodes: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const GroupCreateRequestSchema: z.ZodObject<{
+    code: z.ZodString;
+    name: z.ZodString;
+    salesChannelCodes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export declare const GroupUpdateRequestSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    salesChannelCodes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export declare const SettingDetailResponseSchema: z.ZodObject<{
+    id: z.ZodUUID;
+    code: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodNullable<z.ZodString>;
+    valueType: z.ZodEnum<{
+        string: "string";
+        number: "number";
+        boolean: "boolean";
+        json: "json";
+        string_list: "string_list";
+        secret: "secret";
+        credential_ref: "credential_ref";
+    }>;
+    ownerModule: z.ZodString;
+    salesChannelCodes: z.ZodArray<z.ZodString>;
+    enumOptions: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+    configurationType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    defaultValue: z.ZodUnknown;
+    globalValue: z.ZodNullable<z.ZodUnknown>;
+    globalValueIsSet: z.ZodOptional<z.ZodBoolean>;
+    valuesByChannel: z.ZodArray<z.ZodObject<{
+        salesChannelId: z.ZodUUID;
+        salesChannelCode: z.ZodString;
+        value: z.ZodUnknown;
+        isSet: z.ZodOptional<z.ZodBoolean>;
+        updatedAt: z.ZodISODateTime;
+    }, z.core.$strip>>;
+    version: z.ZodISODateTime;
+    editable: z.ZodOptional<z.ZodBoolean>;
+    activationControl: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+/**
+ * Public shop / company contact information resolved for the active sales
+ * channel. Backs the storefront footer, the 404 "need help?" block and the
+ * contact form. Every field is a string; an unset (or not-yet-registered)
+ * setting resolves to an empty string so the storefront can decide what to
+ * render. The contact-form recipient list is intentionally omitted — it is
+ * an internal routing concern, not public information.
+ */
+export declare const ShopInfoSchema: z.ZodObject<{
+    name: z.ZodString;
+    address: z.ZodString;
+    contactEmail: z.ZodString;
+    supportEmail: z.ZodString;
+    phone: z.ZodString;
+}, z.core.$strip>;
+export type ShopInfo = z.infer<typeof ShopInfoSchema>;
+export declare const ShopInfoResponseSchema: z.ZodObject<{
+    data: z.ZodObject<{
+        name: z.ZodString;
+        address: z.ZodString;
+        contactEmail: z.ZodString;
+        supportEmail: z.ZodString;
+        phone: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type ShopInfoResponse = z.infer<typeof ShopInfoResponseSchema>;
+/**
+ * A clearable cache namespace surfaced in the admin "Clear cache" page. `key`
+ * is the stable identifier the client sends back to clear it; `label` and
+ * `description` are human-readable (English defaults — the admin localises via
+ * the `settings.cache.namespace.<key>.*` i18n keys).
+ */
+export declare const CacheNamespaceDtoSchema: z.ZodObject<{
+    key: z.ZodString;
+    label: z.ZodString;
+    description: z.ZodString;
+}, z.core.$strip>;
+export type CacheNamespaceDto = z.infer<typeof CacheNamespaceDtoSchema>;
+export declare const CacheNamespacesResponseSchema: z.ZodObject<{
+    data: z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        label: z.ZodString;
+        description: z.ZodString;
+    }, z.core.$strip>>;
+    cacheEnabled: z.ZodBoolean;
+}, z.core.$strip>;
+export type CacheNamespacesResponse = z.infer<typeof CacheNamespacesResponseSchema>;
+export declare const ClearCacheRequestSchema: z.ZodObject<{
+    namespaces: z.ZodUnion<readonly [z.ZodLiteral<"all">, z.ZodArray<z.ZodString>]>;
+}, z.core.$strip>;
+export type ClearCacheRequest = z.infer<typeof ClearCacheRequestSchema>;
+export declare const ClearedCacheNamespaceSchema: z.ZodObject<{
+    key: z.ZodString;
+    deletedKeysCount: z.ZodNumber;
+}, z.core.$strip>;
+export declare const ClearCacheResultSchema: z.ZodObject<{
+    data: z.ZodObject<{
+        cleared: z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            deletedKeysCount: z.ZodNumber;
+        }, z.core.$strip>>;
+        totalDeletedKeys: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type ClearCacheResult = z.infer<typeof ClearCacheResultSchema>;
+/**
+ * Resolved storefront home-page configuration for the active sales channel.
+ * `cmsPageSlug` is the CMS page slug an operator chose as the home page, or
+ * null when none is configured (the storefront then renders its built-in
+ * landing page).
+ */
+export declare const HomepageConfigSchema: z.ZodObject<{
+    cmsPageSlug: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type HomepageConfig = z.infer<typeof HomepageConfigSchema>;
+export declare const HomepageConfigResponseSchema: z.ZodObject<{
+    data: z.ZodObject<{
+        cmsPageSlug: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type HomepageConfigResponse = z.infer<typeof HomepageConfigResponseSchema>;
+/** Who made a settings write, for the audit entry. */
+export interface SettingsAdminAuditContext {
+    actorAdminUserId: string | null;
+    requestId?: string | null;
+}
+/**
+ * What a write did. `affectedChannelIds` is what the caller re-reads, and
+ * `newVersion` is the optimistic-lock token for the next write.
+ *
+ * `setting` is deliberately **not** here. The service returns the `Setting`
+ * entity on it, no cross-module caller reads it, and publishing an ORM row
+ * would be exactly the substitution this feature exists to remove.
+ */
+export interface SettingsSetValueResult {
+    affectedChannelIds: string[];
+    newVersion: string;
+}
+/**
+ * Container name: `settingsAdminService`. Owner: `settings`.
+ *
+ * Two writes, and the difference between them is the whole channel-scoping
+ * story (Constitution XII): a value set for all channels and a value set for a
+ * named subset are different operations with different audit entries, not one
+ * operation with an optional argument.
+ *
+ * `expectedVersion` is `null` for a first write and the previous
+ * `newVersion` afterwards; a mismatch is a 409, on this side of the port.
+ *
+ * When `settings` is off the write fails closed. There is no degrade to
+ * design: a configuration screen that reported success while storing nothing
+ * is worse than one that refuses.
+ *
+ * Whether `settings` has an off state at all is its manifest's `activation` to
+ * say, not this line's: a module declaring `nonDeactivatable` never enters one.
+ */
+export interface SettingsAdminPort {
+    setValueForAllChannels(code: string, rawValue: unknown, expectedVersion: string | null, actor: SettingsAdminAuditContext): Promise<SettingsSetValueResult>;
+    setValueForSubset(code: string, channelCodes: string[], rawValue: unknown, expectedVersion: string | null, actor: SettingsAdminAuditContext): Promise<SettingsSetValueResult>;
+}
+/**
+ * The division of labour, and it is the whole reason this seam exists:
+ *
+ * > `settings` answers "what would every channel's value be after this write".
+ * > The module that declared the setting answers "is that legal".
+ *
+ * `settings` owns three-tier resolution (per-channel row → `globalValue` →
+ * manifest `defaultValue`) and must keep owning it — a validator that
+ * re-derived it would drift from it. The owning module owns the semantics, and
+ * `settings` must never learn them.
+ */
+export interface SettingWriteChannelProjection {
+    readonly salesChannelId: string;
+    readonly salesChannelCode: string;
+    readonly salesChannelName: string;
+    /** This channel's effective value **after** the proposed write would commit. */
+    readonly value: unknown;
+}
+export interface SettingWriteValidationInput {
+    readonly code: string;
+    /** The module that declared the setting. */
+    readonly ownerModuleId: string;
+    /** Every sales channel in the platform, active or not, with its post-write value. */
+    readonly projection: readonly SettingWriteChannelProjection[];
+    /** Channel ids the write targets; empty for a platform-wide (`scope: 'all'`) write. */
+    readonly targetedChannelIds: readonly string[];
+}
+export interface SettingWriteValidator {
+    /** The module contributing the validator — used for the presence filter. */
+    readonly contributorModuleId: string;
+    /**
+     * Exact setting codes this validator answers for. No wildcards, deliberately:
+     * a prefix or glob makes it impossible to tell from the registry which module
+     * answers for a given code, which is the question the presence filter and
+     * every future debugging session ask.
+     */
+    readonly codes: readonly string[];
+    /** Throws an `HttpError` to refuse. Resolving is acceptance. */
+    validate(input: SettingWriteValidationInput): Promise<void>;
+}
+/**
+ * Container name: `settingWriteValidatorRegistry`. Owner: `settings`.
+ *
+ * An ordinary registration rather than a gated port, because it is a
+ * contribution seam: a module pushes a validator into it once, from a boot
+ * hook, and reads nothing back.
+ */
+export interface SettingWriteValidatorRegistryPort {
+    register(validator: SettingWriteValidator): void;
+    /** Validators for `code`, filtered by contributor presence. */
+    forCode(code: string): readonly SettingWriteValidator[];
+}
+//# sourceMappingURL=settings.d.ts.map

package/dist/settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"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"}