@verisure-italy/zipcode-types 1.3.0 → 1.4.0

package/README.md

@@ -0,0 +1,171 @@
+# ZipCode Types
+
+TypeScript types and Zod schemas for ZipCode service entities. This package provides type-safe definitions for areas and enabled zip codes.
+
+## Features
+
+- ✅ **Type-Safe** - Full TypeScript support with Zod runtime validation
+- ✅ **Shared Types** - Built on top of `@verisure-italy/shared-types`
+- ✅ **Runtime Validation** - Zod schemas for request/response validation
+- ✅ **Tree-Shakeable** - ESM and CJS support for optimal bundle size
+
+## Installation
+
+```bash
+pnpm add @verisure-italy/zipcode-types
+```
+
+## Types
+
+### Area
+
+Represents a geographic area with zip code information.
+
+```typescript
+import { Area, areaSchema } from '@verisure-italy/zipcode-types'
+
+// TypeScript type
+const area: Area = {
+  id: '123e4567-e89b-12d3-a456-426614174000',
+  city: 'Milano',
+  province: 'MI',
+  region: 'Lombardia',
+  town: 'Milano',
+  zipCode: '20100',
+}
+
+// Runtime validation with Zod
+const result = areaSchema.safeParse(data)
+if (result.success) {
+  const validArea: Area = result.data
+}
+```
+
+**Schema:**
+
+```typescript
+const areaSchema = z.object({
+  id: z.uuid(),                                              // UUID v4
+  city: z.string().min(2, 'city.required'),                 // Min 2 chars
+  province: z.string().min(2).max(3),                       // 2-3 chars (e.g., MI, RM)
+  region: z.string().min(2, 'region.required'),            // Min 2 chars
+  town: z.string().min(2, 'town.required'),                // Min 2 chars
+  zipCode: zipCodeSchema,                                    // From shared-types
+})
+```
+
+### Enabled
+
+Represents an enabled zip code.
+
+```typescript
+import { Enabled, enabledSchema } from '@verisure-italy/zipcode-types'
+
+// TypeScript type
+const enabled: Enabled = {
+  zipCode: '20100',
+}
+
+// Runtime validation with Zod
+const result = enabledSchema.safeParse(data)
+if (result.success) {
+  const validEnabled: Enabled = result.data
+}
+```
+
+**Schema:**
+
+```typescript
+const enabledSchema = z.object({
+  zipCode: zipCodeSchema,  // From shared-types
+})
+```
+
+## Usage Examples
+
+### Express Route with Validation
+
+```typescript
+import express from 'express'
+import { areaSchema, type Area } from '@verisure-italy/zipcode-types'
+
+const router = express.Router()
+
+router.post('/areas', async (req, res) => {
+  // Validate request body
+  const result = areaSchema.safeParse(req.body)
+  
+  if (!result.success) {
+    return res.status(400).json({ 
+      error: 'Invalid area data',
+      details: result.error.issues 
+    })
+  }
+  
+  const area: Area = result.data
+  // ... save to database ...
+  
+  res.json(area)
+})
+```
+
+### With Router Middleware
+
+```typescript
+import { createRestResource } from '@verisure-italy/router-middleware'
+import { areaSchema, type Area } from '@verisure-italy/zipcode-types'
+
+const areaResource = createRestResource<Area>({
+  name: 'area',
+  schema: areaSchema,
+  // ... repository methods ...
+})
+
+// Validation is handled automatically by router-middleware
+```
+
+### Type Guards
+
+```typescript
+import { areaSchema, type Area } from '@verisure-italy/zipcode-types'
+
+function isValidArea(data: unknown): data is Area {
+  return areaSchema.safeParse(data).success
+}
+
+// Usage
+if (isValidArea(unknownData)) {
+  // TypeScript knows this is an Area
+  console.log(unknownData.city)
+}
+```
+
+## Dependencies
+
+- `@verisure-italy/shared-types` - Provides `zipCodeSchema` and other shared types
+- `zod` ^4.1.12 - Runtime validation library
+
+## Related Packages
+
+- [`@verisure-italy/shared-types`](../shared-types) - Shared types across services
+- [`@verisure-italy/router-middleware`](../router-middleware) - REST resource creation with validation
+- [`@verisure-italy/error-handler-middleware`](../error-handler-middleware) - Handles validation errors
+
+## TypeScript Configuration
+
+This package is built with TypeScript 5.9+ and exports both type definitions and runtime schemas.
+
+```json
+{
+  "compilerOptions": {
+    "moduleResolution": "bundler",
+    "module": "ESNext",
+    "target": "ES2022"
+  }
+}
+```
+
+## License
+
+Internal Verisure Italy package
+

package/dist/index.cjs

@@ -20,27 +20,17 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
-  areaSchema: () => areaSchema,
-  enabledSchema: () => enabledSchema
+  overbookingAllocationTypeSchema: () => overbookingAllocationTypeSchema,
+  overbookingAllocationTypes: () => overbookingAllocationTypes
 });
 module.exports = __toCommonJS(index_exports);
 
-// src/models.ts
-var import_shared_types = require("@verisure-italy/shared-types");
+// src/types.ts
 var import_zod = require("zod");
-var enabledSchema = import_zod.z.object({
-  zipCode: import_shared_types.zipCodeSchema
-});
-var areaSchema = import_zod.z.object({
-  id: import_zod.z.uuid(),
-  city: import_zod.z.string().min(2, "city.required"),
-  province: import_zod.z.string().min(2, "province.required").max(3, "province.bad_format"),
-  region: import_zod.z.string().min(2, "region.required"),
-  town: import_zod.z.string().min(2, "town.required"),
-  zipCode: import_shared_types.zipCodeSchema
-});
+var overbookingAllocationTypes = ["front", "ko", "telesales", "ecommerce"];
+var overbookingAllocationTypeSchema = import_zod.z.enum(overbookingAllocationTypes);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  areaSchema,
-  enabledSchema
+  overbookingAllocationTypeSchema,
+  overbookingAllocationTypes
 });

package/dist/index.d.cts

@@ -1,17 +1,12 @@
 import { z } from 'zod';
 
-declare const enabledSchema: z.ZodObject<{
-    zipCode: z.ZodString;
-}, z.core.$strip>;
-type Enabled = z.infer<typeof enabledSchema>;
-declare const areaSchema: z.ZodObject<{
-    id: z.ZodUUID;
-    city: z.ZodString;
-    province: z.ZodString;
-    region: z.ZodString;
-    town: z.ZodString;
-    zipCode: z.ZodString;
-}, z.core.$strip>;
-type Area = z.infer<typeof areaSchema>;
+declare const overbookingAllocationTypes: readonly ["front", "ko", "telesales", "ecommerce"];
+declare const overbookingAllocationTypeSchema: z.ZodEnum<{
+    front: "front";
+    ko: "ko";
+    telesales: "telesales";
+    ecommerce: "ecommerce";
+}>;
+type OverbookingAllocationType = z.infer<typeof overbookingAllocationTypeSchema>;
 
-export { type Area, type Enabled, areaSchema, enabledSchema };
+export { type OverbookingAllocationType, overbookingAllocationTypeSchema, overbookingAllocationTypes };

package/dist/index.d.ts

@@ -1,17 +1,12 @@
 import { z } from 'zod';
 
-declare const enabledSchema: z.ZodObject<{
-    zipCode: z.ZodString;
-}, z.core.$strip>;
-type Enabled = z.infer<typeof enabledSchema>;
-declare const areaSchema: z.ZodObject<{
-    id: z.ZodUUID;
-    city: z.ZodString;
-    province: z.ZodString;
-    region: z.ZodString;
-    town: z.ZodString;
-    zipCode: z.ZodString;
-}, z.core.$strip>;
-type Area = z.infer<typeof areaSchema>;
+declare const overbookingAllocationTypes: readonly ["front", "ko", "telesales", "ecommerce"];
+declare const overbookingAllocationTypeSchema: z.ZodEnum<{
+    front: "front";
+    ko: "ko";
+    telesales: "telesales";
+    ecommerce: "ecommerce";
+}>;
+type OverbookingAllocationType = z.infer<typeof overbookingAllocationTypeSchema>;
 
-export { type Area, type Enabled, areaSchema, enabledSchema };
+export { type OverbookingAllocationType, overbookingAllocationTypeSchema, overbookingAllocationTypes };

package/dist/index.js

@@ -1,18 +1,8 @@
-// src/models.ts
-import { zipCodeSchema } from "@verisure-italy/shared-types";
+// src/types.ts
 import { z } from "zod";
-var enabledSchema = z.object({
-  zipCode: zipCodeSchema
-});
-var areaSchema = z.object({
-  id: z.uuid(),
-  city: z.string().min(2, "city.required"),
-  province: z.string().min(2, "province.required").max(3, "province.bad_format"),
-  region: z.string().min(2, "region.required"),
-  town: z.string().min(2, "town.required"),
-  zipCode: zipCodeSchema
-});
+var overbookingAllocationTypes = ["front", "ko", "telesales", "ecommerce"];
+var overbookingAllocationTypeSchema = z.enum(overbookingAllocationTypes);
 export {
-  areaSchema,
-  enabledSchema
+  overbookingAllocationTypeSchema,
+  overbookingAllocationTypes
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@verisure-italy/zipcode-types",
   "description": "Types for ZipCode service",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -19,7 +19,7 @@
   ],
   "dependencies": {
     "zod": "4.1.12",
-    "@verisure-italy/shared-types": "1.3.0"
+    "@verisure-italy/shared-types": "1.4.0"
   },
   "devDependencies": {
     "@types/node": "24.6.0",