@openora/core 0.4.0

package/dist/compliance/contract/rg.js

@@ -0,0 +1,129 @@
+import { oc } from '@orpc/contract';
+import * as z from 'zod';
+import { UuidSchema, TimestampSchema, LimitTypeSchema, LimitPeriodSchema, ExclusionKindSchema, ExclusionStatusSchema, RgFlagTypeSchema, RgFlagStatusSchema, } from '@openora/core/contracts';
+import { PageQuerySchema, paginated } from '@openora/core/contracts/kit';
+import { LimitSchema, isConsistentLimit } from './limits.js';
+export const RgExclusionSchema = z.object({
+    id: UuidSchema,
+    userId: UuidSchema,
+    kind: ExclusionKindSchema,
+    status: ExclusionStatusSchema,
+    reason: z.string(),
+    permanent: z.boolean(),
+    startsAt: TimestampSchema,
+    expiresAt: TimestampSchema.nullable(),
+    liftedAt: TimestampSchema.nullable(),
+    liftedReason: z.string().nullable(),
+    liftedBy: UuidSchema.nullable(),
+    createdBy: UuidSchema,
+    createdAt: TimestampSchema,
+    updatedAt: TimestampSchema,
+});
+export const SetPlayerLimitInputSchema = z
+    .object({
+    userId: UuidSchema,
+    type: LimitTypeSchema,
+    amount: z.number().positive(),
+    period: LimitPeriodSchema,
+})
+    .refine(isConsistentLimit, {
+    message: "type 'session' requires period 'session' and vice versa",
+    path: ['period'],
+});
+// 24h .. 6 weeks (1008h) per the Confluence cooling-off window.
+export const ActivateCoolingOffInputSchema = z.object({
+    userId: UuidSchema,
+    durationHours: z.number().int().min(24).max(1008),
+    reason: z.string().trim().min(1),
+});
+// Self-exclusion is permanent, OR a fixed term of at least 6 months. `confirm` guards
+// against an accidental irreversible action.
+export const ActivateSelfExclusionInputSchema = z
+    .object({
+    userId: UuidSchema,
+    permanent: z.boolean(),
+    durationMonths: z.number().int().min(6).optional(),
+    reason: z.string().trim().min(1),
+    confirm: z.literal(true),
+})
+    .refine((v) => v.permanent || v.durationMonths !== undefined, {
+    message: 'durationMonths (>= 6) is required unless permanent is true',
+    path: ['durationMonths'],
+});
+export const LiftSelfExclusionInputSchema = z.object({
+    userId: UuidSchema,
+    reason: z.string().trim().min(1),
+    confirm: z.literal(true),
+});
+export const RgSectionSchema = z.object({
+    limits: z.array(LimitSchema),
+    coolingOff: RgExclusionSchema.nullable(),
+    selfExclusion: RgExclusionSchema.nullable(),
+});
+// Each flagType writes one known detail shape (see rg-monitoring.service.ts).
+export const LimitThresholdDetailSchema = z.object({
+    actual: z.number(),
+    limit: z.number(),
+    period: LimitPeriodSchema,
+    pct: z.number(),
+});
+export const SessionTimeDetailSchema = z.object({
+    sessionMinutes: z.number(),
+    limitMinutes: z.number(),
+    pct: z.number(),
+});
+export const SelfExcludedLoginDetailSchema = z.object({
+    trigger: z.string(),
+    kind: ExclusionKindSchema.nullable(),
+});
+export const RgFlagDetailSchema = z.union([
+    LimitThresholdDetailSchema,
+    SessionTimeDetailSchema,
+    SelfExcludedLoginDetailSchema,
+]);
+export const RgFlagListItemSchema = z.object({
+    id: UuidSchema,
+    userId: UuidSchema,
+    username: z.string().nullable(),
+    email: z.string().nullable(),
+    flagType: RgFlagTypeSchema,
+    limitType: z.string().nullable(),
+    detail: RgFlagDetailSchema,
+    status: RgFlagStatusSchema,
+    flaggedAt: TimestampSchema,
+    clearedAt: TimestampSchema.nullable(),
+});
+export const ListRgFlagsInputSchema = PageQuerySchema.extend({
+    flagType: RgFlagTypeSchema.optional(),
+    limitType: LimitTypeSchema.optional(),
+    status: RgFlagStatusSchema.optional(),
+    fromDate: z.string().optional(),
+    toDate: z.string().optional(),
+});
+export const rgContract = {
+    setPlayerLimit: oc
+        .route({ method: 'PUT', path: '/compliance/players/{userId}/limits' })
+        .input(SetPlayerLimitInputSchema)
+        .output(LimitSchema),
+    activateCoolingOff: oc
+        .route({ method: 'POST', path: '/compliance/players/{userId}/cooling-off' })
+        .input(ActivateCoolingOffInputSchema)
+        .output(RgExclusionSchema),
+    activateSelfExclusion: oc
+        .route({ method: 'POST', path: '/compliance/players/{userId}/self-exclusion' })
+        .input(ActivateSelfExclusionInputSchema)
+        .output(RgExclusionSchema),
+    liftSelfExclusion: oc
+        .route({ method: 'POST', path: '/compliance/players/{userId}/self-exclusion/lift' })
+        .input(LiftSelfExclusionInputSchema)
+        .output(RgExclusionSchema),
+    getRgSection: oc
+        .route({ method: 'GET', path: '/compliance/players/{userId}/rg' })
+        .input(z.object({ userId: UuidSchema }))
+        .output(RgSectionSchema),
+    listRgFlags: oc
+        .route({ method: 'GET', path: '/compliance/rg-flags' })
+        .input(ListRgFlagsInputSchema)
+        .output(paginated(RgFlagListItemSchema)),
+};
+//# sourceMappingURL=rg.js.map

package/dist/compliance/contract/rg.js.map

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

package/dist/compliance/drizzle/migrations/0000_talented_mattie_franklin.sql

@@ -0,0 +1,80 @@
+CREATE TYPE "public"."kyc_triggered_by" AS ENUM('submission', 'reverify_threshold', 'manual');--> statement-breakpoint
+CREATE TYPE "public"."kyc_verification_status" AS ENUM('not_started', 'pending', 'verified', 'rejected', 'resubmission_requested', 'manually_overridden');--> statement-breakpoint
+CREATE TYPE "public"."rg_exclusion_kind" AS ENUM('cooling_off', 'self_exclusion');--> statement-breakpoint
+CREATE TYPE "public"."rg_exclusion_status" AS ENUM('active', 'lifted', 'expired');--> statement-breakpoint
+CREATE TYPE "public"."rg_flag_status" AS ENUM('active', 'cleared');--> statement-breakpoint
+CREATE TYPE "public"."rg_flag_type" AS ENUM('limit_threshold', 'session_time', 'self_excluded_login');--> statement-breakpoint
+CREATE TABLE "geo_rule" (
+	"id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
+	"country_code" text NOT NULL,
+	"action" text NOT NULL,
+	"created_at" timestamp with time zone DEFAULT now() NOT NULL,
+	CONSTRAINT "geo_rule_country_code_unique" UNIQUE("country_code")
+);
+--> statement-breakpoint
+CREATE TABLE "kyc_verification" (
+	"id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
+	"user_id" uuid NOT NULL,
+	"provider" text NOT NULL,
+	"reference_id" text NOT NULL,
+	"status" "kyc_verification_status" NOT NULL,
+	"document_types" jsonb DEFAULT '[]'::jsonb NOT NULL,
+	"decision_reason" text,
+	"triggered_by" "kyc_triggered_by" NOT NULL,
+	"trigger_deposits" numeric(18, 2),
+	"submitted_at" timestamp with time zone DEFAULT now() NOT NULL,
+	"decided_at" timestamp with time zone,
+	"created_at" timestamp with time zone DEFAULT now() NOT NULL,
+	"updated_at" timestamp with time zone NOT NULL
+);
+--> statement-breakpoint
+CREATE TABLE "rg_exclusion" (
+	"id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
+	"user_id" uuid NOT NULL,
+	"kind" "rg_exclusion_kind" NOT NULL,
+	"status" "rg_exclusion_status" DEFAULT 'active' NOT NULL,
+	"reason" text NOT NULL,
+	"permanent" boolean DEFAULT false NOT NULL,
+	"starts_at" timestamp with time zone DEFAULT now() NOT NULL,
+	"expires_at" timestamp with time zone,
+	"lifted_at" timestamp with time zone,
+	"lifted_reason" text,
+	"lifted_by" uuid,
+	"created_by" uuid NOT NULL,
+	"created_at" timestamp with time zone DEFAULT now() NOT NULL,
+	"updated_at" timestamp with time zone NOT NULL
+);
+--> statement-breakpoint
+CREATE TABLE "rg_flag" (
+	"id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
+	"user_id" uuid NOT NULL,
+	"flag_type" "rg_flag_type" NOT NULL,
+	"limit_type" text,
+	"detail" jsonb DEFAULT '{}'::jsonb NOT NULL,
+	"status" "rg_flag_status" DEFAULT 'active' NOT NULL,
+	"flagged_at" timestamp with time zone DEFAULT now() NOT NULL,
+	"cleared_at" timestamp with time zone
+);
+--> statement-breakpoint
+CREATE TABLE "user_limit" (
+	"id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
+	"user_id" uuid NOT NULL,
+	"type" text NOT NULL,
+	"amount" real NOT NULL,
+	"period" text NOT NULL,
+	"created_at" timestamp with time zone DEFAULT now() NOT NULL,
+	"updated_at" timestamp with time zone NOT NULL
+);
+--> statement-breakpoint
+CREATE INDEX "kyc_verification_user_id_created_at_idx" ON "kyc_verification" USING btree ("user_id","created_at");--> statement-breakpoint
+CREATE INDEX "kyc_verification_reference_id_idx" ON "kyc_verification" USING btree ("reference_id");--> statement-breakpoint
+CREATE INDEX "kyc_verification_status_idx" ON "kyc_verification" USING btree ("status");--> statement-breakpoint
+CREATE INDEX "rg_exclusion_user_id_idx" ON "rg_exclusion" USING btree ("user_id");--> statement-breakpoint
+CREATE INDEX "rg_exclusion_user_id_status_idx" ON "rg_exclusion" USING btree ("user_id","status");--> statement-breakpoint
+CREATE INDEX "rg_exclusion_kind_status_idx" ON "rg_exclusion" USING btree ("kind","status");--> statement-breakpoint
+CREATE UNIQUE INDEX "rg_exclusion_active_kind_key" ON "rg_exclusion" USING btree ("user_id","kind") WHERE "rg_exclusion"."status" = 'active';--> statement-breakpoint
+CREATE INDEX "rg_flag_status_flagged_at_idx" ON "rg_flag" USING btree ("status","flagged_at");--> statement-breakpoint
+CREATE INDEX "rg_flag_user_id_idx" ON "rg_flag" USING btree ("user_id");--> statement-breakpoint
+CREATE INDEX "rg_flag_flag_type_idx" ON "rg_flag" USING btree ("flag_type");--> statement-breakpoint
+CREATE UNIQUE INDEX "user_limit_user_id_type_period_key" ON "user_limit" USING btree ("user_id","type","period");--> statement-breakpoint
+CREATE INDEX "user_limit_user_id_idx" ON "user_limit" USING btree ("user_id");