@plyaz/types 1.18.0 → 1.18.2

package/dist/examples/index.cjs

@@ -0,0 +1,76 @@
+'use strict';
+
+var zod = require('zod');
+
+// @plyaz package - Built with tsup
+
+var NAME_MIN_LENGTH = 3;
+var NAME_MAX_LENGTH = 100;
+var DECIMAL_PRECISION_MULTIPLIER = 100;
+var PAGINATION_MAX_LIMIT = 100;
+var PAGINATION_DEFAULT_LIMIT = 20;
+var CreateExampleSchema = zod.z.object({
+  // String with sanitization (trim)
+  name: zod.z.string().trim().min(NAME_MIN_LENGTH, `Name must be at least ${NAME_MIN_LENGTH} characters`).max(NAME_MAX_LENGTH, `Name must be at most ${NAME_MAX_LENGTH} characters`),
+  // Optional string with sanitization (trim + empty to undefined)
+  description: zod.z.string().trim().optional().transform((val) => val ?? void 0),
+  // Number with sanitization (round to 2 decimal places)
+  amount: zod.z.number().positive("Amount must be positive").transform(
+    (val) => Math.round(val * DECIMAL_PRECISION_MULTIPLIER) / DECIMAL_PRECISION_MULTIPLIER
+  ),
+  // Boolean with default
+  is_visible: zod.z.boolean().default(true)
+});
+var UpdateExampleSchema = CreateExampleSchema;
+var PatchExampleSchema = CreateExampleSchema.partial();
+var QueryExampleSchema = zod.z.object({
+  // Pagination
+  page: zod.z.coerce.number().int().positive().default(1),
+  limit: zod.z.coerce.number().int().min(1).max(PAGINATION_MAX_LIMIT).default(PAGINATION_DEFAULT_LIMIT),
+  // Sorting
+  sort_by: zod.z.enum(["name", "amount", "created_at", "updated_at"]).default("created_at"),
+  sort_order: zod.z.enum(["asc", "desc"]).default("desc"),
+  // Filters
+  status: zod.z.enum(["draft", "active", "archived"]).optional(),
+  is_visible: zod.z.coerce.boolean().optional(),
+  min_amount: zod.z.coerce.number().positive().optional(),
+  max_amount: zod.z.coerce.number().positive().optional(),
+  // Search
+  search: zod.z.string().trim().optional()
+});
+var DeleteExampleSchema = zod.z.object({
+  // Soft delete flag
+  soft: zod.z.boolean().default(true),
+  // Reason for audit
+  reason: zod.z.string().trim().optional()
+});
+var ExampleResponseSchema = zod.z.object({
+  id: zod.z.string().uuid(),
+  name: zod.z.string(),
+  description: zod.z.string().nullable(),
+  owner_id: zod.z.string().uuid(),
+  status: zod.z.enum(["draft", "active", "archived"]),
+  amount: zod.z.number(),
+  is_visible: zod.z.boolean(),
+  created_at: zod.z.string().datetime(),
+  updated_at: zod.z.string().datetime()
+});
+var ExampleListResponseSchema = zod.z.object({
+  data: zod.z.array(ExampleResponseSchema),
+  meta: zod.z.object({
+    page: zod.z.number(),
+    limit: zod.z.number(),
+    total: zod.z.number(),
+    total_pages: zod.z.number()
+  })
+});
+
+exports.CreateExampleSchema = CreateExampleSchema;
+exports.DeleteExampleSchema = DeleteExampleSchema;
+exports.ExampleListResponseSchema = ExampleListResponseSchema;
+exports.ExampleResponseSchema = ExampleResponseSchema;
+exports.PatchExampleSchema = PatchExampleSchema;
+exports.QueryExampleSchema = QueryExampleSchema;
+exports.UpdateExampleSchema = UpdateExampleSchema;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/examples/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/examples/schemas.ts"],"names":["z"],"mappings":";;;;;;AAkBA,IAAM,eAAA,GAAkB,CAAA;AAExB,IAAM,eAAA,GAAkB,GAAA;AAExB,IAAM,4BAAA,GAA+B,GAAA;AAErC,IAAM,oBAAA,GAAuB,GAAA;AAE7B,IAAM,wBAAA,GAA2B,EAAA;AAU1B,IAAM,mBAAA,GAAsBA,MAAE,MAAA,CAAO;AAAA;AAAA,EAE1C,MAAMA,KAAA,CACH,MAAA,EAAO,CACP,IAAA,GACA,GAAA,CAAI,eAAA,EAAiB,CAAA,sBAAA,EAAyB,eAAe,aAAa,CAAA,CAC1E,GAAA,CAAI,eAAA,EAAiB,CAAA,qBAAA,EAAwB,eAAe,CAAA,WAAA,CAAa,CAAA;AAAA;AAAA,EAG5E,WAAA,EAAaA,KAAA,CACV,MAAA,EAAO,CACP,IAAA,EAAK,CACL,QAAA,EAAS,CACT,SAAA,CAAU,CAAA,GAAA,KAAO,GAAA,IAAO,MAAS,CAAA;AAAA;AAAA,EAGpC,QAAQA,KAAA,CACL,MAAA,EAAO,CACP,QAAA,CAAS,yBAAyB,CAAA,CAClC,SAAA;AAAA,IACC,CAAA,GAAA,KAAO,IAAA,CAAK,KAAA,CAAM,GAAA,GAAM,4BAA4B,CAAA,GAAI;AAAA,GAC1D;AAAA;AAAA,EAGF,UAAA,EAAYA,KAAA,CAAE,OAAA,EAAQ,CAAE,QAAQ,IAAI;AACtC,CAAC;AAUM,IAAM,mBAAA,GAAsB;AAU5B,IAAM,kBAAA,GAAqB,oBAAoB,OAAA;AAS/C,IAAM,kBAAA,GAAqBA,MAAE,MAAA,CAAO;AAAA;AAAA,EAEzC,IAAA,EAAMA,KAAA,CAAE,MAAA,CAAO,MAAA,EAAO,CAAE,KAAI,CAAE,QAAA,EAAS,CAAE,OAAA,CAAQ,CAAC,CAAA;AAAA,EAClD,KAAA,EAAOA,KAAA,CAAE,MAAA,CAAO,MAAA,GAAS,GAAA,EAAI,CAAE,GAAA,CAAI,CAAC,CAAA,CAAE,GAAA,CAAI,oBAAoB,CAAA,CAAE,QAAQ,wBAAwB,CAAA;AAAA;AAAA,EAGhG,OAAA,EAASA,KAAA,CAAE,IAAA,CAAK,CAAC,MAAA,EAAQ,QAAA,EAAU,YAAA,EAAc,YAAY,CAAC,CAAA,CAAE,OAAA,CAAQ,YAAY,CAAA;AAAA,EACpF,UAAA,EAAYA,MAAE,IAAA,CAAK,CAAC,OAAO,MAAM,CAAC,CAAA,CAAE,OAAA,CAAQ,MAAM,CAAA;AAAA;AAAA,EAGlD,MAAA,EAAQA,MAAE,IAAA,CAAK,CAAC,SAAS,QAAA,EAAU,UAAU,CAAC,CAAA,CAAE,QAAA,EAAS;AAAA,EACzD,UAAA,EAAYA,KAAA,CAAE,MAAA,CAAO,OAAA,GAAU,QAAA,EAAS;AAAA,EACxC,YAAYA,KAAA,CAAE,MAAA,CAAO,QAAO,CAAE,QAAA,GAAW,QAAA,EAAS;AAAA,EAClD,YAAYA,KAAA,CAAE,MAAA,CAAO,QAAO,CAAE,QAAA,GAAW,QAAA,EAAS;AAAA;AAAA,EAGlD,QAAQA,KAAA,CAAE,MAAA,EAAO,CAAE,IAAA,GAAO,QAAA;AAC5B,CAAC;AAUM,IAAM,mBAAA,GAAsBA,MAAE,MAAA,CAAO;AAAA;AAAA,EAE1C,IAAA,EAAMA,KAAA,CAAE,OAAA,EAAQ,CAAE,QAAQ,IAAI,CAAA;AAAA;AAAA,EAG9B,QAAQA,KAAA,CAAE,MAAA,EAAO,CAAE,IAAA,GAAO,QAAA;AAC5B,CAAC;AASM,IAAM,qBAAA,GAAwBA,MAAE,MAAA,CAAO;AAAA,EAC5C,EAAA,EAAIA,KAAA,CAAE,MAAA,EAAO,CAAE,IAAA,EAAK;AAAA,EACpB,IAAA,EAAMA,MAAE,MAAA,EAAO;AAAA,EACf,WAAA,EAAaA,KAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EACjC,QAAA,EAAUA,KAAA,CAAE,MAAA,EAAO,CAAE,IAAA,EAAK;AAAA,EAC1B,QAAQA,KAAA,CAAE,IAAA,CAAK,CAAC,OAAA,EAAS,QAAA,EAAU,UAAU,CAAC,CAAA;AAAA,EAC9C,MAAA,EAAQA,MAAE,MAAA,EAAO;AAAA,EACjB,UAAA,EAAYA,MAAE,OAAA,EAAQ;AAAA,EACtB,UAAA,EAAYA,KAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EAChC,UAAA,EAAYA,KAAA,CAAE,MAAA,EAAO,CAAE,QAAA;AACzB,CAAC;AAKM,IAAM,yBAAA,GAA4BA,MAAE,MAAA,CAAO;AAAA,EAChD,IAAA,EAAMA,KAAA,CAAE,KAAA,CAAM,qBAAqB,CAAA;AAAA,EACnC,IAAA,EAAMA,MAAE,MAAA,CAAO;AAAA,IACb,IAAA,EAAMA,MAAE,MAAA,EAAO;AAAA,IACf,KAAA,EAAOA,MAAE,MAAA,EAAO;AAAA,IAChB,KAAA,EAAOA,MAAE,MAAA,EAAO;AAAA,IAChB,WAAA,EAAaA,MAAE,MAAA;AAAO,GACvB;AACH,CAAC","file":"index.cjs","sourcesContent":["/**\n * Example Schemas\n *\n * Demonstrates Zod schema patterns for validation + sanitization.\n * These schemas are used by @plyaz/core validators.\n *\n * Key concepts:\n * - Validation: min, max, email, regex, etc.\n * - Sanitization: trim, toLowerCase, transform, default\n */\n\nimport { z } from 'zod';\n\n// ─────────────────────────────────────────────────────────────────\n// Schema Constants\n// ─────────────────────────────────────────────────────────────────\n\n/** Minimum length for name field */\nconst NAME_MIN_LENGTH = 3;\n/** Maximum length for name field */\nconst NAME_MAX_LENGTH = 100;\n/** Multiplier for rounding to 2 decimal places */\nconst DECIMAL_PRECISION_MULTIPLIER = 100;\n/** Maximum items per page for pagination */\nconst PAGINATION_MAX_LIMIT = 100;\n/** Default items per page for pagination */\nconst PAGINATION_DEFAULT_LIMIT = 20;\n\n// ─────────────────────────────────────────────────────────────────\n// Create Schema (POST)\n// ─────────────────────────────────────────────────────────────────\n\n/**\n * Schema for creating an example entity\n * Handles both validation AND sanitization\n */\nexport const CreateExampleSchema = z.object({\n  // String with sanitization (trim)\n  name: z\n    .string()\n    .trim()\n    .min(NAME_MIN_LENGTH, `Name must be at least ${NAME_MIN_LENGTH} characters`)\n    .max(NAME_MAX_LENGTH, `Name must be at most ${NAME_MAX_LENGTH} characters`),\n\n  // Optional string with sanitization (trim + empty to undefined)\n  description: z\n    .string()\n    .trim()\n    .optional()\n    .transform(val => val ?? undefined),\n\n  // Number with sanitization (round to 2 decimal places)\n  amount: z\n    .number()\n    .positive('Amount must be positive')\n    .transform(\n      val => Math.round(val * DECIMAL_PRECISION_MULTIPLIER) / DECIMAL_PRECISION_MULTIPLIER\n    ),\n\n  // Boolean with default\n  is_visible: z.boolean().default(true),\n});\n\n// ─────────────────────────────────────────────────────────────────\n// Update Schema (PUT - full replacement)\n// ─────────────────────────────────────────────────────────────────\n\n/**\n * Schema for full update (PUT)\n * All fields required (replaces entire entity)\n */\nexport const UpdateExampleSchema = CreateExampleSchema;\n\n// ─────────────────────────────────────────────────────────────────\n// Patch Schema (PATCH - partial update)\n// ─────────────────────────────────────────────────────────────────\n\n/**\n * Schema for partial update (PATCH)\n * All fields optional\n */\nexport const PatchExampleSchema = CreateExampleSchema.partial();\n\n// ─────────────────────────────────────────────────────────────────\n// Query/Filter Schema (GET with params)\n// ─────────────────────────────────────────────────────────────────\n\n/**\n * Schema for query parameters (GET list)\n */\nexport const QueryExampleSchema = z.object({\n  // Pagination\n  page: z.coerce.number().int().positive().default(1),\n  limit: z.coerce.number().int().min(1).max(PAGINATION_MAX_LIMIT).default(PAGINATION_DEFAULT_LIMIT),\n\n  // Sorting\n  sort_by: z.enum(['name', 'amount', 'created_at', 'updated_at']).default('created_at'),\n  sort_order: z.enum(['asc', 'desc']).default('desc'),\n\n  // Filters\n  status: z.enum(['draft', 'active', 'archived']).optional(),\n  is_visible: z.coerce.boolean().optional(),\n  min_amount: z.coerce.number().positive().optional(),\n  max_amount: z.coerce.number().positive().optional(),\n\n  // Search\n  search: z.string().trim().optional(),\n});\n\n// ─────────────────────────────────────────────────────────────────\n// Delete Schema (DELETE with params)\n// ─────────────────────────────────────────────────────────────────\n\n/**\n * Schema for delete operation\n * Can include options like soft delete, cascade, etc.\n */\nexport const DeleteExampleSchema = z.object({\n  // Soft delete flag\n  soft: z.boolean().default(true),\n\n  // Reason for audit\n  reason: z.string().trim().optional(),\n});\n\n// ─────────────────────────────────────────────────────────────────\n// Response Schema (validate API response)\n// ─────────────────────────────────────────────────────────────────\n\n/**\n * Schema for validating API response\n */\nexport const ExampleResponseSchema = z.object({\n  id: z.string().uuid(),\n  name: z.string(),\n  description: z.string().nullable(),\n  owner_id: z.string().uuid(),\n  status: z.enum(['draft', 'active', 'archived']),\n  amount: z.number(),\n  is_visible: z.boolean(),\n  created_at: z.string().datetime(),\n  updated_at: z.string().datetime(),\n});\n\n/**\n * Schema for list response with pagination\n */\nexport const ExampleListResponseSchema = z.object({\n  data: z.array(ExampleResponseSchema),\n  meta: z.object({\n    page: z.number(),\n    limit: z.number(),\n    total: z.number(),\n    total_pages: z.number(),\n  }),\n});\n"]}

package/dist/examples/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Example Domain Types & Schemas
+ *
+ * Demonstrates the pattern for domain types in @plyaz/types.
+ * Used by @plyaz/core for testing and as reference implementation.
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   CreateExampleSchema,
+ *   CreateExampleDTO,
+ *   ExampleEntity,
+ * } from '@plyaz/types/examples';
+ * ```
+ */
+export { CreateExampleSchema, UpdateExampleSchema, PatchExampleSchema, QueryExampleSchema, DeleteExampleSchema, ExampleResponseSchema, ExampleListResponseSchema, } from './schemas';
+export type { CreateExampleDTO, UpdateExampleDTO, PatchExampleDTO, QueryExampleDTO, DeleteExampleDTO, ExampleResponseDTO, ExampleListResponseDTO, ExampleEntity, ExampleStoreItem, ExampleStoreState, ExampleCreatedPayload, ExampleUpdatedPayload, ExampleDeletedPayload, ExampleValidationFailedPayload, } from './types';

package/dist/examples/index.js

@@ -0,0 +1,68 @@
+import { z } from 'zod';
+
+// @plyaz package - Built with tsup
+
+var NAME_MIN_LENGTH = 3;
+var NAME_MAX_LENGTH = 100;
+var DECIMAL_PRECISION_MULTIPLIER = 100;
+var PAGINATION_MAX_LIMIT = 100;
+var PAGINATION_DEFAULT_LIMIT = 20;
+var CreateExampleSchema = z.object({
+  // String with sanitization (trim)
+  name: z.string().trim().min(NAME_MIN_LENGTH, `Name must be at least ${NAME_MIN_LENGTH} characters`).max(NAME_MAX_LENGTH, `Name must be at most ${NAME_MAX_LENGTH} characters`),
+  // Optional string with sanitization (trim + empty to undefined)
+  description: z.string().trim().optional().transform((val) => val ?? void 0),
+  // Number with sanitization (round to 2 decimal places)
+  amount: z.number().positive("Amount must be positive").transform(
+    (val) => Math.round(val * DECIMAL_PRECISION_MULTIPLIER) / DECIMAL_PRECISION_MULTIPLIER
+  ),
+  // Boolean with default
+  is_visible: z.boolean().default(true)
+});
+var UpdateExampleSchema = CreateExampleSchema;
+var PatchExampleSchema = CreateExampleSchema.partial();
+var QueryExampleSchema = z.object({
+  // Pagination
+  page: z.coerce.number().int().positive().default(1),
+  limit: z.coerce.number().int().min(1).max(PAGINATION_MAX_LIMIT).default(PAGINATION_DEFAULT_LIMIT),
+  // Sorting
+  sort_by: z.enum(["name", "amount", "created_at", "updated_at"]).default("created_at"),
+  sort_order: z.enum(["asc", "desc"]).default("desc"),
+  // Filters
+  status: z.enum(["draft", "active", "archived"]).optional(),
+  is_visible: z.coerce.boolean().optional(),
+  min_amount: z.coerce.number().positive().optional(),
+  max_amount: z.coerce.number().positive().optional(),
+  // Search
+  search: z.string().trim().optional()
+});
+var DeleteExampleSchema = z.object({
+  // Soft delete flag
+  soft: z.boolean().default(true),
+  // Reason for audit
+  reason: z.string().trim().optional()
+});
+var ExampleResponseSchema = z.object({
+  id: z.string().uuid(),
+  name: z.string(),
+  description: z.string().nullable(),
+  owner_id: z.string().uuid(),
+  status: z.enum(["draft", "active", "archived"]),
+  amount: z.number(),
+  is_visible: z.boolean(),
+  created_at: z.string().datetime(),
+  updated_at: z.string().datetime()
+});
+var ExampleListResponseSchema = z.object({
+  data: z.array(ExampleResponseSchema),
+  meta: z.object({
+    page: z.number(),
+    limit: z.number(),
+    total: z.number(),
+    total_pages: z.number()
+  })
+});
+
+export { CreateExampleSchema, DeleteExampleSchema, ExampleListResponseSchema, ExampleResponseSchema, PatchExampleSchema, QueryExampleSchema, UpdateExampleSchema };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/examples/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/examples/schemas.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Example Schemas\n *\n * Demonstrates Zod schema patterns for validation + sanitization.\n * These schemas are used by @plyaz/core validators.\n *\n * Key concepts:\n * - Validation: min, max, email, regex, etc.\n * - Sanitization: trim, toLowerCase, transform, default\n */\n\nimport { z } from 'zod';\n\n// ─────────────────────────────────────────────────────────────────\n// Schema Constants\n// ─────────────────────────────────────────────────────────────────\n\n/** Minimum length for name field */\nconst NAME_MIN_LENGTH = 3;\n/** Maximum length for name field */\nconst NAME_MAX_LENGTH = 100;\n/** Multiplier for rounding to 2 decimal places */\nconst DECIMAL_PRECISION_MULTIPLIER = 100;\n/** Maximum items per page for pagination */\nconst PAGINATION_MAX_LIMIT = 100;\n/** Default items per page for pagination */\nconst PAGINATION_DEFAULT_LIMIT = 20;\n\n// ─────────────────────────────────────────────────────────────────\n// Create Schema (POST)\n// ─────────────────────────────────────────────────────────────────\n\n/**\n * Schema for creating an example entity\n * Handles both validation AND sanitization\n */\nexport const CreateExampleSchema = z.object({\n  // String with sanitization (trim)\n  name: z\n    .string()\n    .trim()\n    .min(NAME_MIN_LENGTH, `Name must be at least ${NAME_MIN_LENGTH} characters`)\n    .max(NAME_MAX_LENGTH, `Name must be at most ${NAME_MAX_LENGTH} characters`),\n\n  // Optional string with sanitization (trim + empty to undefined)\n  description: z\n    .string()\n    .trim()\n    .optional()\n    .transform(val => val ?? undefined),\n\n  // Number with sanitization (round to 2 decimal places)\n  amount: z\n    .number()\n    .positive('Amount must be positive')\n    .transform(\n      val => Math.round(val * DECIMAL_PRECISION_MULTIPLIER) / DECIMAL_PRECISION_MULTIPLIER\n    ),\n\n  // Boolean with default\n  is_visible: z.boolean().default(true),\n});\n\n// ─────────────────────────────────────────────────────────────────\n// Update Schema (PUT - full replacement)\n// ─────────────────────────────────────────────────────────────────\n\n/**\n * Schema for full update (PUT)\n * All fields required (replaces entire entity)\n */\nexport const UpdateExampleSchema = CreateExampleSchema;\n\n// ─────────────────────────────────────────────────────────────────\n// Patch Schema (PATCH - partial update)\n// ─────────────────────────────────────────────────────────────────\n\n/**\n * Schema for partial update (PATCH)\n * All fields optional\n */\nexport const PatchExampleSchema = CreateExampleSchema.partial();\n\n// ─────────────────────────────────────────────────────────────────\n// Query/Filter Schema (GET with params)\n// ─────────────────────────────────────────────────────────────────\n\n/**\n * Schema for query parameters (GET list)\n */\nexport const QueryExampleSchema = z.object({\n  // Pagination\n  page: z.coerce.number().int().positive().default(1),\n  limit: z.coerce.number().int().min(1).max(PAGINATION_MAX_LIMIT).default(PAGINATION_DEFAULT_LIMIT),\n\n  // Sorting\n  sort_by: z.enum(['name', 'amount', 'created_at', 'updated_at']).default('created_at'),\n  sort_order: z.enum(['asc', 'desc']).default('desc'),\n\n  // Filters\n  status: z.enum(['draft', 'active', 'archived']).optional(),\n  is_visible: z.coerce.boolean().optional(),\n  min_amount: z.coerce.number().positive().optional(),\n  max_amount: z.coerce.number().positive().optional(),\n\n  // Search\n  search: z.string().trim().optional(),\n});\n\n// ─────────────────────────────────────────────────────────────────\n// Delete Schema (DELETE with params)\n// ─────────────────────────────────────────────────────────────────\n\n/**\n * Schema for delete operation\n * Can include options like soft delete, cascade, etc.\n */\nexport const DeleteExampleSchema = z.object({\n  // Soft delete flag\n  soft: z.boolean().default(true),\n\n  // Reason for audit\n  reason: z.string().trim().optional(),\n});\n\n// ─────────────────────────────────────────────────────────────────\n// Response Schema (validate API response)\n// ─────────────────────────────────────────────────────────────────\n\n/**\n * Schema for validating API response\n */\nexport const ExampleResponseSchema = z.object({\n  id: z.string().uuid(),\n  name: z.string(),\n  description: z.string().nullable(),\n  owner_id: z.string().uuid(),\n  status: z.enum(['draft', 'active', 'archived']),\n  amount: z.number(),\n  is_visible: z.boolean(),\n  created_at: z.string().datetime(),\n  updated_at: z.string().datetime(),\n});\n\n/**\n * Schema for list response with pagination\n */\nexport const ExampleListResponseSchema = z.object({\n  data: z.array(ExampleResponseSchema),\n  meta: z.object({\n    page: z.number(),\n    limit: z.number(),\n    total: z.number(),\n    total_pages: z.number(),\n  }),\n});\n"]}

package/dist/examples/schemas.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Example Schemas
+ *
+ * Demonstrates Zod schema patterns for validation + sanitization.
+ * These schemas are used by @plyaz/core validators.
+ *
+ * Key concepts:
+ * - Validation: min, max, email, regex, etc.
+ * - Sanitization: trim, toLowerCase, transform, default
+ */
+import { z } from 'zod';
+/**
+ * Schema for creating an example entity
+ * Handles both validation AND sanitization
+ */
+export declare const CreateExampleSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string, string>>;
+    amount: z.ZodPipe<z.ZodNumber, z.ZodTransform<number, number>>;
+    is_visible: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+/**
+ * Schema for full update (PUT)
+ * All fields required (replaces entire entity)
+ */
+export declare const UpdateExampleSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string, string>>;
+    amount: z.ZodPipe<z.ZodNumber, z.ZodTransform<number, number>>;
+    is_visible: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+/**
+ * Schema for partial update (PATCH)
+ * All fields optional
+ */
+export declare const PatchExampleSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string, string>>>;
+    amount: z.ZodOptional<z.ZodPipe<z.ZodNumber, z.ZodTransform<number, number>>>;
+    is_visible: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+}, z.core.$strip>;
+/**
+ * Schema for query parameters (GET list)
+ */
+export declare const QueryExampleSchema: z.ZodObject<{
+    page: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    sort_by: z.ZodDefault<z.ZodEnum<{
+        name: "name";
+        created_at: "created_at";
+        updated_at: "updated_at";
+        amount: "amount";
+    }>>;
+    sort_order: z.ZodDefault<z.ZodEnum<{
+        asc: "asc";
+        desc: "desc";
+    }>>;
+    status: z.ZodOptional<z.ZodEnum<{
+        active: "active";
+        draft: "draft";
+        archived: "archived";
+    }>>;
+    is_visible: z.ZodOptional<z.ZodCoercedBoolean<unknown>>;
+    min_amount: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    max_amount: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    search: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Schema for delete operation
+ * Can include options like soft delete, cascade, etc.
+ */
+export declare const DeleteExampleSchema: z.ZodObject<{
+    soft: z.ZodDefault<z.ZodBoolean>;
+    reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Schema for validating API response
+ */
+export declare const ExampleResponseSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodNullable<z.ZodString>;
+    owner_id: z.ZodString;
+    status: z.ZodEnum<{
+        active: "active";
+        draft: "draft";
+        archived: "archived";
+    }>;
+    amount: z.ZodNumber;
+    is_visible: z.ZodBoolean;
+    created_at: z.ZodString;
+    updated_at: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Schema for list response with pagination
+ */
+export declare const ExampleListResponseSchema: z.ZodObject<{
+    data: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodNullable<z.ZodString>;
+        owner_id: z.ZodString;
+        status: z.ZodEnum<{
+            active: "active";
+            draft: "draft";
+            archived: "archived";
+        }>;
+        amount: z.ZodNumber;
+        is_visible: z.ZodBoolean;
+        created_at: z.ZodString;
+        updated_at: z.ZodString;
+    }, z.core.$strip>>;
+    meta: z.ZodObject<{
+        page: z.ZodNumber;
+        limit: z.ZodNumber;
+        total: z.ZodNumber;
+        total_pages: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;

package/dist/examples/types.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Example Types
+ *
+ * TypeScript interfaces and types for the example domain.
+ * Inferred from Zod schemas where possible.
+ */
+import type { z } from 'zod';
+import type { CreateExampleSchema, UpdateExampleSchema, PatchExampleSchema, QueryExampleSchema, DeleteExampleSchema, ExampleResponseSchema, ExampleListResponseSchema } from './schemas';
+import type { CoreEntityCreatedPayload, CoreEntityUpdatedPayload, CoreEntityDeletedPayload, CoreValidationFailedPayload } from '../core/events';
+/**
+ * Create request DTO (POST body)
+ */
+export type CreateExampleDTO = z.infer<typeof CreateExampleSchema>;
+/**
+ * Update request DTO (PUT body - full replacement)
+ */
+export type UpdateExampleDTO = z.infer<typeof UpdateExampleSchema>;
+/**
+ * Patch request DTO (PATCH body - partial update)
+ */
+export type PatchExampleDTO = z.infer<typeof PatchExampleSchema>;
+/**
+ * Query params DTO (GET list)
+ */
+export type QueryExampleDTO = z.infer<typeof QueryExampleSchema>;
+/**
+ * Delete options DTO (DELETE)
+ */
+export type DeleteExampleDTO = z.infer<typeof DeleteExampleSchema>;
+/**
+ * Single entity response DTO
+ */
+export type ExampleResponseDTO = z.infer<typeof ExampleResponseSchema>;
+/**
+ * List response with pagination
+ */
+export type ExampleListResponseDTO = z.infer<typeof ExampleListResponseSchema>;
+/**
+ * Example domain entity
+ * Represents the fully hydrated domain model
+ */
+export interface ExampleEntity {
+    id: string;
+    name: string;
+    description: string | null;
+    ownerId: string;
+    status: 'draft' | 'active' | 'archived';
+    amount: number;
+    isVisible: boolean;
+    createdAt: Date;
+    updatedAt: Date;
+    isActive: boolean;
+    hasDescription: () => boolean;
+}
+/**
+ * Store state for example entity
+ * Serializable (no Date objects, no functions)
+ */
+export interface ExampleStoreItem {
+    id: string;
+    name: string;
+    description: string | null;
+    ownerId: string;
+    status: ExampleEntity['status'];
+    amount: number;
+    isVisible: boolean;
+    createdAt: string;
+    updatedAt: string;
+    isActive: boolean;
+    isSelected?: boolean;
+    isLoading?: boolean;
+    isDeleting?: boolean;
+}
+/**
+ * Store state for example list
+ */
+export interface ExampleStoreState {
+    items: ExampleStoreItem[];
+    loading: boolean;
+    error: string | null;
+    page: number;
+    limit: number;
+    total: number;
+    totalPages: number;
+    filters: Partial<QueryExampleDTO>;
+    selectedIds: Set<string>;
+}
+/**
+ * Event payload for example:created
+ */
+export type ExampleCreatedPayload = CoreEntityCreatedPayload<ExampleEntity, ExampleStoreItem>;
+/**
+ * Event payload for example:updated
+ */
+export type ExampleUpdatedPayload = CoreEntityUpdatedPayload<ExampleEntity, ExampleStoreItem>;
+/**
+ * Event payload for example:deleted
+ */
+export type ExampleDeletedPayload = CoreEntityDeletedPayload;
+/**
+ * Event payload for example:validation:failed
+ */
+export type ExampleValidationFailedPayload = CoreValidationFailedPayload;

package/dist/features/feature-flag/types.d.ts

@@ -95,7 +95,16 @@ export interface FeatureFlagConfig<FeatureFlagKey extends string> extends SetOpt
     /** Database configuration (required if provider is 'database') */
     databaseConfig?: {
         connectionString: string;
+        /** Table name for feature flags (default: 'feature_flags') */
         tableName: string;
+        /** Table name for feature flag rules (default: 'feature_flag_rules') */
+        rulesTableName?: string;
+        /** Table name for feature flag evaluations (default: 'feature_flag_evaluations') */
+        evaluationsTableName?: string;
+        /** Table name for feature flag overrides (default: 'feature_flag_overrides') */
+        overridesTableName?: string;
+        /** Schema for evaluations table (default: 'public', use 'audit' for partitioned tables) */
+        evaluationsSchema?: string;
         options?: Record<string, unknown>;
     };
     /** Redis configuration (required if provider is 'redis') */
@@ -170,11 +179,22 @@ export interface FeatureFlagProviderProps<FeatureFlagKey extends string, Feature
     }>;
 }
 /**
- * Backend Request DTO for flag creation.
+ * Request DTO for creating a feature flag.
+ * Used by both the provider interface and API endpoints.
+ * @typeParam FeatureFlagKey - Feature flag key type (defaults to string)
  */
-export interface CreateFlagRequest<FeatureFlagKey extends string> extends Partial<WithEnvironment>, SetOptional<Enabled, 'isEnabled'>, SetOptional<Describable, 'description'>, Named, KeyValuePair<FeatureFlagKey, FeatureFlagValue> {
+export interface CreateFlagRequest<FeatureFlagKey extends string = string> extends Partial<WithEnvironment>, SetOptional<Enabled, 'isEnabled'>, SetOptional<Describable, 'description'>, Named, KeyValuePair<FeatureFlagKey, FeatureFlagValue> {
     rolloutPercentage?: number;
 }
+/**
+ * Response structure for fetching feature flag data.
+ * Contains both flags and their associated rules.
+ * @typeParam FeatureFlagKey - Feature flag key type (defaults to string)
+ */
+export interface FetchFeatureFlagDataResponse<FeatureFlagKey extends string = string> {
+    flags: FeatureFlag<FeatureFlagKey>[];
+    rules: FeatureFlagRule<FeatureFlagKey>[];
+}
 /**
  * Backend Provider health status information.
  */
@@ -184,10 +204,38 @@ export interface ProviderHealthStatus extends Initializable {
 }
 /**
  * Main interface for feature flag providers.
+ *
+ * The provider acts as the unified service layer for feature flag operations.
+ * All operations (read, write, override) go through the provider interface,
+ * regardless of the underlying storage backend.
+ *
+ * @example
+ * ```typescript
+ * // Controller uses provider directly
+ * @Controller('feature-flags')
+ * export class FeatureFlagController {
+ *   constructor(
+ *     @Inject('FEATURE_FLAG_PROVIDER')
+ *     private readonly provider: FeatureFlagProvider<FeatureFlagKey>,
+ *   ) {}
+ *
+ *   @Get(':key')
+ *   async getFlag(@Param('key') key: string) {
+ *     return this.provider.getFlag(key as FeatureFlagKey);
+ *   }
+ *
+ *   @Post()
+ *   async createFlag(@Body() data: CreateFlagRequest<FeatureFlagKey>) {
+ *     return this.provider.createFlag(data);
+ *   }
+ * }
+ * ```
  */
 export interface FeatureFlagProvider<FeatureFlagKey extends string> extends Refreshable {
     /** Initializes the provider by loading initial data */
     initialize(): Promise<void>;
+    /** Disposes of the provider, cleaning up resources */
+    dispose(): void;
     /** Evaluates a feature flag and returns full evaluation details */
     getFlag(key: FeatureFlagKey, context?: FeatureFlagContext): Promise<FeatureFlagEvaluation<FeatureFlagKey>>;
     /** Evaluates all feature flags for the given context */
@@ -196,20 +244,24 @@ export interface FeatureFlagProvider<FeatureFlagKey extends string> extends Refr
     isEnabled(key: FeatureFlagKey, context?: FeatureFlagContext): Promise<boolean>;
     /** Gets the value of a feature flag with optional type casting */
     getValue<T = FeatureFlagValue>(key: FeatureFlagKey, context?: FeatureFlagContext): Promise<T>;
-    /** Subscribes to flag changes and updates */
-    subscribe(callback: () => void): () => void;
     /** Sets an override for a specific flag key */
     setOverride(key: FeatureFlagKey, value: FeatureFlagValue): void;
     /** Removes an override for a specific flag key */
     removeOverride(key: FeatureFlagKey): void;
     /** Clears all overrides */
     clearOverrides(): void;
-    /** Disposes of the provider, cleaning up resources */
-    dispose(): void;
-    /** Optional: Update a flag (not all providers support this) */
-    updateFlag?(flag: FeatureFlag<FeatureFlagKey>): Promise<void>;
-    /** Optional: Update a rule (not all providers support this) */
-    updateRule?(rule: FeatureFlagRule<FeatureFlagKey>): Promise<void>;
+    /** Subscribes to flag changes and updates */
+    subscribe(callback: () => void): () => void;
+    /** Creates a new feature flag */
+    createFlag(data: CreateFlagRequest<FeatureFlagKey>): Promise<FeatureFlag<FeatureFlagKey>>;
+    /** Updates an existing feature flag */
+    updateFlag(key: FeatureFlagKey, data: Partial<CreateFlagRequest<FeatureFlagKey>>): Promise<FeatureFlag<FeatureFlagKey>>;
+    /** Deletes a feature flag */
+    deleteFlag(key: FeatureFlagKey): Promise<void>;
+    /** Gets all rules for a specific flag */
+    getRules(key: FeatureFlagKey): Promise<FeatureFlagRule<FeatureFlagKey>[]>;
+    /** Gets all enabled rules across all flags */
+    getAllRules(): Promise<FeatureFlagRule<FeatureFlagKey>[]>;
     /** Optional: Sync features at runtime (for providers that support dynamic updates) */
     syncFeatures?(newFeatures: Record<FeatureFlagKey, FeatureFlagValue>): Promise<void>;
 }
@@ -258,28 +310,6 @@ export interface FeatureFlagHelpers<FeatureFlagKey extends string = string> {
     isAllEnabled: (keys: FeatureFlagKey[], context?: FeatureFlagContext) => Promise<boolean>;
     whenEnabled: <T>(key: FeatureFlagKey, callback: () => T | Promise<T>, fallback?: () => T | Promise<T>, context?: FeatureFlagContext) => Promise<T | undefined>;
 }
-/**
- * Response structure for fetching feature flag data.
- * Contains both flags and their associated rules.
- *
- * @template FeatureFlagKey - Type of feature flag keys
- *
- * @example
- * ```typescript
- * const response: FetchFeatureFlagDataResponse<AppFeatures> = {
- *   flags: [
- *     { key: 'newUI', name: 'New UI', value: true, isEnabled: true }
- *   ],
- *   rules: [
- *     { flagKey: 'newUI', conditions: { userRole: 'beta' }, value: true }
- *   ]
- * };
- * ```
- */
-export interface FetchFeatureFlagDataResponse<FeatureFlagKey extends string> {
-    flags: FeatureFlag<FeatureFlagKey>[];
-    rules: FeatureFlagRule<FeatureFlagKey>[];
-}
 /**
  * Input for error handling test cases
  */