@go-mondo/identity-sdk 0.0.2-beta.4 → 0.0.2-beta.41

package/dist/esm/authentication/sessions/schema.js

@@ -0,0 +1,92 @@
+import * as z from 'zod/v4';
+import { CreatedAtPropertyPayloadSchema, CreatedAtPropertySchema, DeactivatedAtPropertyPayloadSchema, DeactivatedAtPropertySchema, DeletedAtPropertyPayloadSchema, DeletedAtPropertySchema, RequiredDatePayloadSchema, RequiredDateSchema, UpdatedAtPropertyPayloadSchema, UpdatedAtPropertySchema, } from '../../common/schema/dates.js';
+import { KSUIDSchema } from '../../common/schema/id.js';
+import { MetadataMapPropertySchema, MetadataPayloadPropertySchema, } from '../../common/schema/metadata.js';
+import { UserIdSchema } from '../../customer/schema.js';
+import { StrategyIdSchema, StrategyTypeSchema, } from '../strategies/schema/base.js';
+import { Model } from '../utils.js';
+export const SessionStatus = {
+    INITIATED: 'initiated', // Session was created, but no activity has been taken
+    AUTHENTICATED: 'authenticated', // Session is authenticated
+    PENDING: 'pending', // Session is in the process of authenticating
+};
+export const SessionIdSchema = KSUIDSchema(Model.Session.UIDPrefix);
+export const SessionIdPropertySchema = z.object({
+    id: SessionIdSchema,
+});
+export const SessionStatusSchema = z.enum([
+    SessionStatus.INITIATED,
+    SessionStatus.AUTHENTICATED,
+    SessionStatus.PENDING,
+]);
+export const SessionAuthenticationFactorSchema = z.object({
+    id: StrategyIdSchema,
+    type: StrategyTypeSchema,
+    settings: z.record(z.string(), z.unknown()).optional(),
+    state: z.string().optional(),
+});
+const AuthenticationFactorHistoryArraySchema = z.array(StrategyIdSchema);
+const AuthenticationFactorHistorySetSchema = z.instanceof((Set));
+const SessionAuthenticationFactorHistoryInput = z.union([
+    z.undefined(),
+    AuthenticationFactorHistoryArraySchema,
+    AuthenticationFactorHistorySetSchema,
+]);
+const SessionAuthenticationFactorHistoryArraySchema = SessionAuthenticationFactorHistoryInput.pipe(z.transform((s) => (s instanceof Set ? Array.from(s) : s)?.length ? s : undefined));
+// type SessionAuthenticationFactorArrayHistory = z.output<
+//   typeof SessionAuthenticationFactorHistoryArraySchema
+// >;
+const SessionAuthenticationFactorHistorySetSchema = SessionAuthenticationFactorHistoryInput.pipe(z.transform((s) => (s instanceof Set ? s : new Set(s))));
+// type SessionAuthenticationFactorSetHistory = z.output<
+//   typeof SessionAuthenticationFactorHistorySetSchema
+// >;
+const BaseSchema = z.object({
+    ...SessionIdPropertySchema.shape,
+    status: SessionStatusSchema,
+    user: z.union([UserIdSchema, z.undefined()]).optional(),
+    userAgent: z.string().optional(),
+    sourceIp: z.union([z.ipv4(), z.ipv6(), z.undefined()]).optional(),
+    factors: z
+        .union([z.array(SessionAuthenticationFactorSchema), z.undefined()])
+        .optional(),
+    factorHistory: SessionAuthenticationFactorHistoryArraySchema.optional(),
+});
+export const SessionSchema = z.object({
+    ...BaseSchema.shape,
+    expiresAt: RequiredDateSchema,
+    ...CreatedAtPropertySchema.shape,
+    ...UpdatedAtPropertySchema.shape,
+    factorHistory: SessionAuthenticationFactorHistorySetSchema,
+    redirectTo: z
+        .union([z.string(), z.instanceof(URL)])
+        .pipe(z.transform((v) => (!v || v instanceof URL ? v : new URL(v))))
+        .optional(),
+    ...DeletedAtPropertySchema.shape,
+    ...DeactivatedAtPropertySchema.shape,
+    ...MetadataMapPropertySchema.shape,
+});
+export const SessionPayloadSchema = z.object({
+    ...BaseSchema.shape,
+    expiresAt: RequiredDatePayloadSchema,
+    ...CreatedAtPropertyPayloadSchema.shape,
+    ...UpdatedAtPropertyPayloadSchema.shape,
+    redirectTo: z
+        .union([z.string(), z.instanceof(URL)])
+        .transform((v) => (v instanceof URL ? v.toString() : v))
+        .optional(),
+    ...DeletedAtPropertyPayloadSchema.shape,
+    ...DeactivatedAtPropertyPayloadSchema.shape,
+    ...MetadataPayloadPropertySchema.shape,
+});
+export const SessionAssociationReferenceSchema = z.object({
+    ...SessionPayloadSchema.pick({
+        id: true,
+        status: true,
+        user: true,
+        userAgent: true,
+        sourceIp: true,
+        createdAt: true,
+        expiresAt: true,
+    }).shape,
+    model: z.literal('Session'),
+});

package/dist/esm/authentication/settings/resources.d.ts

@@ -0,0 +1,12 @@
+import type { MondoIdentity } from '../../common/resources/init.js';
+import { type Settings, type UpsertSettingsInput } from './schema.js';
+export declare class SettingsResources {
+    private readonly instance;
+    constructor(instance: MondoIdentity);
+    static buildPath(): string;
+    getItem(): Promise<Settings>;
+    upsertItem(item: UpsertSettingsInput): Promise<Settings>;
+}
+export declare function getSettings(instance: MondoIdentity): Promise<Settings>;
+export declare function upsertSettings(instance: MondoIdentity, item: UpsertSettingsInput): Promise<Settings>;
+//# sourceMappingURL=resources.d.ts.map

package/dist/esm/authentication/settings/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../../../src/authentication/settings/resources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAMpE,OAAO,EACL,KAAK,QAAQ,EAEb,KAAK,mBAAmB,EAEzB,MAAM,aAAa,CAAC;AAIrB,qBAAa,iBAAiB;IACT,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,aAAa;IAE3D,MAAM,CAAC,SAAS,IAAI,MAAM;IAInB,OAAO,IAAI,OAAO,CAAC,QAAQ,CAAC;IAI5B,UAAU,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,QAAQ,CAAC;CAGhE;AAED,wBAAsB,WAAW,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,QAAQ,CAAC,CAO5E;AAED,wBAAsB,cAAc,CAClC,QAAQ,EAAE,aAAa,EACvB,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,QAAQ,CAAC,CAQnB"}

package/dist/esm/authentication/settings/resources.js

@@ -0,0 +1,25 @@
+import { getItemWithAuthorization, postItemWithAuthorization, } from '../../common/resources/operations.js';
+import { PATH } from '../resources.js';
+import { SettingsSchema, UpsertSettingsPayloadSchema, } from './schema.js';
+const RESOURCE = 'settings';
+export class SettingsResources {
+    instance;
+    constructor(instance) {
+        this.instance = instance;
+    }
+    static buildPath() {
+        return [PATH, RESOURCE].filter(Boolean).join('/');
+    }
+    getItem() {
+        return getSettings(this.instance);
+    }
+    upsertItem(item) {
+        return upsertSettings(this.instance, item);
+    }
+}
+export async function getSettings(instance) {
+    return SettingsSchema.parse(await getItemWithAuthorization(new URL(SettingsResources.buildPath(), instance.config.host), instance.authorizer));
+}
+export async function upsertSettings(instance, item) {
+    return SettingsSchema.parse(await postItemWithAuthorization(new URL(SettingsResources.buildPath(), instance.config.host), instance.authorizer, UpsertSettingsPayloadSchema.parse(item)));
+}

package/dist/esm/authentication/settings/schema.d.ts

@@ -0,0 +1,25 @@
+import * as z from 'zod/v4';
+export declare const SettingsSchema: z.ZodObject<{
+    metadata: z.ZodPipe<z.ZodUnion<readonly [z.ZodUndefined, z.ZodNull, z.ZodCustom<Map<string, string | number | boolean>, Map<string, string | number | boolean>>, z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>]>, z.ZodTransform<Map<string, string | number | boolean>, Record<string, string | number | boolean> | Map<string, string | number | boolean> | null | undefined>>;
+    deactivatedAt: z.ZodOptional<z.ZodUnion<readonly [z.ZodDate, z.ZodPipe<z.ZodString, z.ZodTransform<Date, string>>]>>;
+    deletedAt: z.ZodOptional<z.ZodUnion<readonly [z.ZodDate, z.ZodPipe<z.ZodString, z.ZodTransform<Date, string>>]>>;
+    updatedAt: z.ZodUnion<readonly [z.ZodDate, z.ZodPipe<z.ZodString, z.ZodTransform<Date, string>>]>;
+    factors: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodUndefined, z.ZodNull, z.ZodArray<z.ZodType<import("../factors/schema.js").AuthenticationFactorType, unknown, z.core.$ZodTypeInternals<import("../factors/schema.js").AuthenticationFactorType, unknown>>>]>, z.ZodTransform<import("../factors/schema.js").AuthenticationFactorType[] | undefined, import("../factors/schema.js").AuthenticationFactorType[] | null | undefined>>>;
+}, z.core.$strip>;
+export type SettingsProperties = z.input<typeof SettingsSchema>;
+export type Settings = z.output<typeof SettingsSchema>;
+export declare const SettingsPayloadSchema: z.ZodObject<{
+    metadata: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodUndefined, z.ZodNull, z.ZodCustom<Map<string, string | number | boolean>, Map<string, string | number | boolean>>, z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>]>, z.ZodTransform<Record<string, string | number | boolean> | undefined, Record<string, string | number | boolean> | Map<string, string | number | boolean> | null | undefined>>>;
+    deactivatedAt: z.ZodOptional<z.ZodPipe<z.ZodOptional<z.ZodUnion<readonly [z.ZodDate, z.ZodPipe<z.ZodString, z.ZodTransform<Date, string>>]>>, z.ZodTransform<string | undefined, Date | undefined>>>;
+    deletedAt: z.ZodOptional<z.ZodPipe<z.ZodOptional<z.ZodUnion<readonly [z.ZodDate, z.ZodPipe<z.ZodString, z.ZodTransform<Date, string>>]>>, z.ZodTransform<string | undefined, Date | undefined>>>;
+    factors: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodUndefined, z.ZodNull, z.ZodArray<z.ZodType<import("../factors/schema.js").AuthenticationFactorType, unknown, z.core.$ZodTypeInternals<import("../factors/schema.js").AuthenticationFactorType, unknown>>>]>, z.ZodTransform<import("../factors/schema.js").AuthenticationFactorType[] | undefined, import("../factors/schema.js").AuthenticationFactorType[] | null | undefined>>>;
+    updatedAt: z.ZodOptional<z.ZodPipe<z.ZodOptional<z.ZodUnion<readonly [z.ZodDate, z.ZodPipe<z.ZodString, z.ZodTransform<Date, string>>]>>, z.ZodTransform<string | undefined, Date | undefined>>>;
+}, z.core.$strip>;
+export type SettingsPayload = z.output<typeof SettingsPayloadSchema>;
+export declare const UpsertSettingsPayloadSchema: z.ZodObject<{
+    metadata: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodUndefined, z.ZodNull, z.ZodCustom<Map<string, string | number | boolean>, Map<string, string | number | boolean>>, z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>]>, z.ZodTransform<Record<string, string | number | boolean> | null | undefined, Record<string, string | number | boolean> | Map<string, string | number | boolean> | null | undefined>>>;
+    factors: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodUndefined, z.ZodNull, z.ZodArray<z.ZodType<import("../factors/schema.js").AuthenticationFactorType, unknown, z.core.$ZodTypeInternals<import("../factors/schema.js").AuthenticationFactorType, unknown>>>]>, z.ZodTransform<import("../factors/schema.js").AuthenticationFactorType[] | undefined, import("../factors/schema.js").AuthenticationFactorType[] | null | undefined>>>;
+}, z.core.$strip>;
+export type UpsertSettingsInput = z.input<typeof UpsertSettingsPayloadSchema>;
+export type UpsertSettingsPayload = z.output<typeof UpsertSettingsPayloadSchema>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/esm/authentication/settings/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../src/authentication/settings/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAgB5B,eAAO,MAAM,cAAc;;;;;;iBAMzB,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAChE,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,cAAc,CAAC,CAAC;AAEvD,eAAO,MAAM,qBAAqB;;;;;;iBAMhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAErE,eAAO,MAAM,2BAA2B;;;iBAGtC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAC9E,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAC1C,OAAO,2BAA2B,CACnC,CAAC"}

package/dist/esm/authentication/settings/schema.js

@@ -0,0 +1,22 @@
+import * as z from 'zod/v4';
+import { DeactivatedAtPropertyPayloadSchema, DeactivatedAtPropertySchema, DeletedAtPropertyPayloadSchema, DeletedAtPropertySchema, OptionalDatePayloadSchema, UpdatedAtPropertySchema, } from '../../common/schema/dates.js';
+import { MetadataMapPropertySchema, MetadataPayloadPropertySchema, UpsertMetadataPropertyPayloadSchema, } from '../../common/schema/metadata.js';
+import { AuthenticationFactorsSchema } from '../factors/schema.js';
+export const SettingsSchema = z.object({
+    factors: AuthenticationFactorsSchema.optional(),
+    ...UpdatedAtPropertySchema.shape,
+    ...DeletedAtPropertySchema.shape,
+    ...DeactivatedAtPropertySchema.shape,
+    ...MetadataMapPropertySchema.shape,
+});
+export const SettingsPayloadSchema = z.object({
+    factors: AuthenticationFactorsSchema.optional(),
+    updatedAt: OptionalDatePayloadSchema,
+    ...DeletedAtPropertyPayloadSchema.shape,
+    ...DeactivatedAtPropertyPayloadSchema.shape,
+    ...MetadataPayloadPropertySchema.shape,
+});
+export const UpsertSettingsPayloadSchema = z.object({
+    factors: AuthenticationFactorsSchema.optional(),
+    ...UpsertMetadataPropertyPayloadSchema.shape,
+});

package/dist/esm/authentication/settings/schema.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=schema.test.d.ts.map

package/dist/esm/authentication/settings/schema.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.test.d.ts","sourceRoot":"","sources":["../../../../src/authentication/settings/schema.test.ts"],"names":[],"mappings":""}

package/dist/esm/authentication/settings/schema.test.js

@@ -0,0 +1,460 @@
+import { describe, expect, test } from 'vitest';
+import { generateStrategyId } from '../utils.js';
+import { SettingsSchema, SettingsPayloadSchema, UpsertSettingsPayloadSchema, } from './schema.js';
+describe('Authentication Settings - Schema', () => {
+    describe('SettingsSchema', () => {
+        test('should accept minimal settings object', () => {
+            const settings = {
+                createdAt: new Date(),
+                updatedAt: new Date(),
+                metadata: {},
+            };
+            const result = SettingsSchema.safeParse(settings);
+            // Parse succeeds for valid data
+            expect(result.success).toBe(true);
+        });
+        test('should reject missing required dates', () => {
+            const settings = {
+                metadata: {},
+                // missing createdAt, updatedAt
+            };
+            const result = SettingsSchema.safeParse(settings);
+            expect(result.success).toBe(false);
+        });
+        test('should accept settings with factors', () => {
+            const settings = {
+                factors: [
+                    {
+                        id: generateStrategyId(),
+                    },
+                ],
+                updatedAt: new Date(),
+                metadata: {},
+            };
+            const result = SettingsSchema.safeParse(settings);
+            expect(result.success).toBe(true);
+            if (result.success) {
+                expect(result.data.factors).toHaveLength(1);
+                expect(result.data.factors?.[0].id).toMatch(/^stg_[A-Za-z0-9]+$/);
+            }
+        });
+        test('should accept settings with nested factors', () => {
+            const settings = {
+                factors: [
+                    {
+                        id: generateStrategyId(),
+                        nextFactors: [
+                            {
+                                id: generateStrategyId(),
+                            },
+                        ],
+                    },
+                ],
+                updatedAt: new Date(),
+                metadata: {},
+            };
+            const result = SettingsSchema.safeParse(settings);
+            expect(result.success).toBe(true);
+            if (result.success) {
+                expect(result.data.factors?.[0].nextFactors).toHaveLength(1);
+            }
+        });
+        test('should accept settings with undefined factors', () => {
+            const settings = {
+                factors: undefined,
+                updatedAt: new Date(),
+                metadata: {},
+            };
+            const result = SettingsSchema.safeParse(settings);
+            expect(result.success).toBe(true);
+            if (result.success) {
+                expect(result.data.factors).toBeUndefined();
+            }
+        });
+        test('should accept settings with null factors (transforms to undefined)', () => {
+            const settings = {
+                factors: null,
+                updatedAt: new Date(),
+                metadata: {},
+            };
+            const result = SettingsSchema.safeParse(settings);
+            expect(result.success).toBe(true);
+            if (result.success) {
+                expect(result.data.factors).toBeUndefined();
+            }
+        });
+        test('should accept settings with multiple factors', () => {
+            const settings = {
+                factors: [
+                    { id: generateStrategyId() },
+                    { id: generateStrategyId() },
+                    { id: generateStrategyId() },
+                ],
+                updatedAt: new Date(),
+                metadata: {},
+            };
+            const result = SettingsSchema.safeParse(settings);
+            expect(result.success).toBe(true);
+            if (result.success) {
+                expect(result.data.factors).toHaveLength(3);
+            }
+        });
+        test('should accept settings with deeply nested factors', () => {
+            const settings = {
+                factors: [
+                    {
+                        id: generateStrategyId(),
+                        nextFactors: [
+                            {
+                                id: generateStrategyId(),
+                                nextFactors: [
+                                    {
+                                        id: generateStrategyId(),
+                                    },
+                                ],
+                            },
+                        ],
+                    },
+                ],
+                updatedAt: new Date(),
+                metadata: {},
+            };
+            const result = SettingsSchema.safeParse(settings);
+            expect(result.success).toBe(true);
+            if (result.success) {
+                expect(result.data.factors?.[0].nextFactors?.[0].nextFactors).toHaveLength(1);
+            }
+        });
+        test('should reject settings with invalid factor id', () => {
+            const settings = {
+                factors: [
+                    {
+                        id: 'invalid-id',
+                    },
+                ],
+                updatedAt: new Date(),
+                metadata: {},
+            };
+            const result = SettingsSchema.safeParse(settings);
+            expect(result.success).toBe(false);
+        });
+        test('should reject settings with factors as object instead of array', () => {
+            const settings = {
+                factors: { id: generateStrategyId() },
+                updatedAt: new Date(),
+                metadata: {},
+            };
+            const result = SettingsSchema.safeParse(settings);
+            expect(result.success).toBe(false);
+        });
+        test('should accept settings with deletedAt', () => {
+            const settings = {
+                updatedAt: new Date(),
+                deletedAt: new Date(),
+                metadata: {},
+            };
+            const result = SettingsSchema.safeParse(settings);
+            expect(result.success).toBe(true);
+            if (result.success) {
+                expect(result.data.deletedAt).toBeDefined();
+            }
+        });
+        test('should accept settings with deactivatedAt', () => {
+            const settings = {
+                updatedAt: new Date(),
+                deactivatedAt: new Date(),
+                metadata: {},
+            };
+            const result = SettingsSchema.safeParse(settings);
+            expect(result.success).toBe(true);
+            if (result.success) {
+                expect(result.data.deactivatedAt).toBeDefined();
+            }
+        });
+    });
+    describe('SettingsPayloadSchema', () => {
+        test('should accept minimal payload', () => {
+            const payload = {
+                metadata: {},
+            };
+            const result = SettingsPayloadSchema.safeParse(payload);
+            // Parse succeeds for valid data
+            expect(result.success).toBe(true);
+            if (result.success) {
+                expect(result.data).toEqual(payload);
+            }
+        });
+        test('should accept payload with optional dates', () => {
+            const payload = {
+                updatedAt: new Date().toISOString(),
+                metadata: {},
+            };
+            const result = SettingsPayloadSchema.safeParse(payload);
+            // Parse succeeds for valid data
+            expect(result.success).toBe(true);
+        });
+        test('should accept empty payload', () => {
+            const payload = {
+            // Schema might have defaults for metadata
+            };
+            const result = SettingsPayloadSchema.safeParse(payload);
+            // Parse succeeds for valid data
+            expect(result.success).toBe(true);
+        });
+        test('should accept payload with factors', () => {
+            const payload = {
+                factors: [
+                    {
+                        id: generateStrategyId(),
+                    },
+                ],
+                metadata: {},
+            };
+            const result = SettingsPayloadSchema.safeParse(payload);
+            expect(result.success).toBe(true);
+            if (result.success) {
+                expect(result.data.factors).toHaveLength(1);
+            }
+        });
+        test('should accept payload with nested factors', () => {
+            const payload = {
+                factors: [
+                    {
+                        id: generateStrategyId(),
+                        nextFactors: [
+                            {
+                                id: generateStrategyId(),
+                                nextFactors: [
+                                    {
+                                        id: generateStrategyId(),
+                                    },
+                                ],
+                            },
+                        ],
+                    },
+                ],
+                metadata: {},
+            };
+            const result = SettingsPayloadSchema.safeParse(payload);
+            expect(result.success).toBe(true);
+            if (result.success) {
+                expect(result.data.factors?.[0].nextFactors).toBeDefined();
+            }
+        });
+        test('should accept payload with null factors (transforms to undefined)', () => {
+            const payload = {
+                factors: null,
+                metadata: {},
+            };
+            const result = SettingsPayloadSchema.safeParse(payload);
+            expect(result.success).toBe(true);
+            if (result.success) {
+                expect(result.data.factors).toBeUndefined();
+            }
+        });
+        test('should accept payload with undefined factors', () => {
+            const payload = {
+                factors: undefined,
+                metadata: {},
+            };
+            const result = SettingsPayloadSchema.safeParse(payload);
+            expect(result.success).toBe(true);
+            if (result.success) {
+                expect(result.data.factors).toBeUndefined();
+            }
+        });
+        test('should reject payload with invalid factor structure', () => {
+            const payload = {
+                factors: [{ id: 123 }],
+                metadata: {},
+            };
+            const result = SettingsPayloadSchema.safeParse(payload);
+            expect(result.success).toBe(false);
+        });
+        test('should accept payload with deletedAt and deactivatedAt', () => {
+            const payload = {
+                updatedAt: new Date().toISOString(),
+                deletedAt: new Date().toISOString(),
+                deactivatedAt: new Date().toISOString(),
+                metadata: {},
+            };
+            const result = SettingsPayloadSchema.safeParse(payload);
+            expect(result.success).toBe(true);
+            if (result.success) {
+                expect(result.data.deletedAt).toBeDefined();
+                expect(result.data.deactivatedAt).toBeDefined();
+            }
+        });
+    });
+    describe('UpsertSettingsPayloadSchema', () => {
+        test('should accept empty upsert payload', () => {
+            const payload = {};
+            const result = UpsertSettingsPayloadSchema.safeParse(payload);
+            // Parse succeeds for valid data
+            expect(result.success).toBe(true);
+            if (result.success) {
+                expect(result.data).toEqual(payload);
+            }
+        });
+        test('should accept upsert with only metadata', () => {
+            const payload = {
+                metadata: { configVersion: '2.0' },
+            };
+            const result = UpsertSettingsPayloadSchema.safeParse(payload);
+            // Parse succeeds for valid data
+            expect(result.success).toBe(true);
+        });
+        test('should reject invalid factors structure', () => {
+            const payload = {
+                factors: 'invalid-factors',
+            };
+            const result = UpsertSettingsPayloadSchema.safeParse(payload);
+            expect(result.success).toBe(false);
+        });
+        test('should accept upsert with factors array', () => {
+            const payload = {
+                factors: [
+                    {
+                        id: generateStrategyId(),
+                    },
+                ],
+            };
+            const result = UpsertSettingsPayloadSchema.safeParse(payload);
+            expect(result.success).toBe(true);
+            if (result.success) {
+                expect(result.data.factors).toHaveLength(1);
+            }
+        });
+        test('should accept upsert with nested factors', () => {
+            const payload = {
+                factors: [
+                    {
+                        id: generateStrategyId(),
+                        nextFactors: [
+                            {
+                                id: generateStrategyId(),
+                            },
+                        ],
+                    },
+                ],
+            };
+            const result = UpsertSettingsPayloadSchema.safeParse(payload);
+            expect(result.success).toBe(true);
+            if (result.success) {
+                expect(result.data.factors?.[0].nextFactors).toHaveLength(1);
+            }
+        });
+        test('should accept upsert with multiple top-level factors', () => {
+            const payload = {
+                factors: [{ id: generateStrategyId() }, { id: generateStrategyId() }],
+            };
+            const result = UpsertSettingsPayloadSchema.safeParse(payload);
+            expect(result.success).toBe(true);
+            if (result.success) {
+                expect(result.data.factors).toHaveLength(2);
+            }
+        });
+        test('should accept upsert with null factors', () => {
+            const payload = {
+                factors: null,
+            };
+            const result = UpsertSettingsPayloadSchema.safeParse(payload);
+            expect(result.success).toBe(true);
+        });
+        test('should accept upsert with undefined factors', () => {
+            const payload = {
+                factors: undefined,
+            };
+            const result = UpsertSettingsPayloadSchema.safeParse(payload);
+            expect(result.success).toBe(true);
+        });
+        test('should accept upsert with deeply nested factors', () => {
+            const payload = {
+                factors: [
+                    {
+                        id: generateStrategyId(),
+                        nextFactors: [
+                            {
+                                id: generateStrategyId(),
+                                nextFactors: [
+                                    {
+                                        id: generateStrategyId(),
+                                        nextFactors: [
+                                            {
+                                                id: generateStrategyId(),
+                                            },
+                                        ],
+                                    },
+                                ],
+                            },
+                        ],
+                    },
+                ],
+            };
+            const result = UpsertSettingsPayloadSchema.safeParse(payload);
+            expect(result.success).toBe(true);
+            if (result.success) {
+                const firstFactor = result.data.factors?.[0];
+                expect(firstFactor?.nextFactors?.[0].nextFactors?.[0].nextFactors).toHaveLength(1);
+            }
+        });
+        test('should reject upsert with invalid factor id type', () => {
+            const payload = {
+                factors: [
+                    {
+                        id: 12345,
+                    },
+                ],
+            };
+            const result = UpsertSettingsPayloadSchema.safeParse(payload);
+            expect(result.success).toBe(false);
+        });
+        test('should reject upsert with factors as single object', () => {
+            const payload = {
+                factors: {
+                    id: generateStrategyId(),
+                },
+            };
+            const result = UpsertSettingsPayloadSchema.safeParse(payload);
+            expect(result.success).toBe(false);
+        });
+        test('should reject upsert with invalid nextFactors type', () => {
+            const payload = {
+                factors: [
+                    {
+                        id: generateStrategyId(),
+                        nextFactors: 'invalid',
+                    },
+                ],
+            };
+            const result = UpsertSettingsPayloadSchema.safeParse(payload);
+            expect(result.success).toBe(false);
+        });
+        test('should accept upsert with factors and metadata together', () => {
+            const payload = {
+                factors: [
+                    {
+                        id: generateStrategyId(),
+                    },
+                ],
+                metadata: { key: 'value' },
+            };
+            const result = UpsertSettingsPayloadSchema.safeParse(payload);
+            expect(result.success).toBe(true);
+            if (result.success) {
+                expect(result.data.factors).toHaveLength(1);
+                expect(result.data.metadata).toEqual({ key: 'value' });
+            }
+        });
+        test('should accept upsert with empty factors array', () => {
+            const payload = {
+                factors: [],
+            };
+            const result = UpsertSettingsPayloadSchema.safeParse(payload);
+            expect(result.success).toBe(true);
+            if (result.success) {
+                expect(result.data.factors).toHaveLength(0);
+            }
+        });
+    });
+});