@accounter/server 0.0.9-alpha-20251210153039-1cfd8df346dd211c95a70c76c63465a29236849b → 0.0.9-alpha-20251210155614-e6e65aaecafef9e8fedd0b933f613ffcf478cecf

package/dist/server/src/demo-fixtures/helpers/deterministic-uuid.js

@@ -1,66 +0,0 @@
-import { randomUUID } from 'node:crypto';
-import { v5 as uuidv5 } from 'uuid';
-/**
- * Fixed namespace for all demo data (regenerate on schema-breaking changes if needed).
- * Using standard DNS namespace UUID as recommended by RFC 4122.
- */
-const DEMO_NAMESPACE = '6ba7b810-9dad-11d1-80b4-00c04fd430c8';
-/**
- * Generate deterministic UUID v5 from semantic name.
- *
- * This function creates stable, reproducible UUIDs for demo/staging data entities.
- * The same namespace + name combination will always produce the same UUID across
- * deployments, making it safe to reference these IDs in documentation, screenshots,
- * and external links.
- *
- * @param namespace - Entity type: 'business', 'charge', 'transaction', 'document', etc.
- * @param name - Semantic identifier (kebab-case recommended)
- * @returns UUID v5 string (e.g., '550e8400-e29b-41d4-a716-446655440000')
- *
- * @example
- * ```typescript
- * // Business entity
- * makeUUID('business', 'acme-consulting-llc')
- * // => Always produces same UUID
- *
- * // Charge entity
- * makeUUID('charge', 'consulting-invoice-2024-11')
- * // => Stable across deploys
- *
- * // Financial account
- * makeUUID('financial-account', 'bank-usd-account')
- * // => Different from makeUUID('business', 'bank-usd-account')
- * ```
- *
- * @remarks
- * **Naming Conventions:**
- * - Use kebab-case for all semantic names
- * - Combine entity type + descriptive name ensures no collisions
- * - Never change a semantic name once deployed (breaks external links)
- * - For updates to same entity, append version: `acme-consulting-llc-v2`
- *
- * **Stability Warning:**
- * Once a UUID is generated and used in staging/production, the semantic name
- * MUST NOT be changed. Doing so will generate a different UUID and break:
- * - External documentation with embedded links
- * - Screenshots with visible UUIDs
- * - Any hardcoded references in client applications
- *
- * If you need to modify an entity, create a new semantic name with a version suffix.
- */
-export function makeUUID(namespace, name) {
-    const composite = `${namespace}:${name}`;
-    return uuidv5(composite, DEMO_NAMESPACE);
-}
-/**
- * Backward compatible adapter for legacy single-argument API.
- * - When seed is provided, returns deterministic UUID v5 scoped under 'legacy' namespace
- * - When seed omitted, returns a random UUID to preserve previous behavior
- */
-export function makeUUIDLegacy(seed) {
-    if (seed === undefined || seed === null) {
-        return randomUUID();
-    }
-    return makeUUID('legacy', seed);
-}
-//# sourceMappingURL=deterministic-uuid.js.map

package/dist/server/src/demo-fixtures/helpers/deterministic-uuid.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"deterministic-uuid.js","sourceRoot":"","sources":["../../../../../src/demo-fixtures/helpers/deterministic-uuid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,EAAE,IAAI,MAAM,EAAE,MAAM,MAAM,CAAC;AAEpC;;;GAGG;AACH,MAAM,cAAc,GAAG,sCAAsC,CAAC;AAE9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,MAAM,UAAU,QAAQ,CAAC,SAAiB,EAAE,IAAY;IACtD,MAAM,SAAS,GAAG,GAAG,SAAS,IAAI,IAAI,EAAE,CAAC;IACzC,OAAO,MAAM,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;AAC3C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,IAAa;IAC1C,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QACxC,OAAO,UAAU,EAAE,CAAC;IACtB,CAAC;IACD,OAAO,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;AAClC,CAAC"}

package/src/demo-fixtures/__tests__/deterministic-uuid.test.ts

@@ -1,75 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import { makeUUID } from '../helpers/deterministic-uuid.js';
-
-describe('deterministic-uuid', () => {
-  describe('makeUUID', () => {
-    it('generates same UUID for same inputs', () => {
-      const uuid1 = makeUUID('business', 'acme-consulting-llc');
-      const uuid2 = makeUUID('business', 'acme-consulting-llc');
-
-      expect(uuid1).toBe(uuid2);
-      expect(uuid1).toMatch(/^[0-9a-f]{8}-[0-9a-f]{4}-5[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/);
-    });
-
-    it('generates different UUIDs for different names', () => {
-      const uuid1 = makeUUID('business', 'acme-llc');
-      const uuid2 = makeUUID('business', 'acme-corp');
-
-      expect(uuid1).not.toBe(uuid2);
-    });
-
-    it('generates different UUIDs for different namespaces', () => {
-      const businessUUID = makeUUID('business', 'acme');
-      const chargeUUID = makeUUID('charge', 'acme');
-
-      expect(businessUUID).not.toBe(chargeUUID);
-    });
-
-    it('includes namespace in composite key', () => {
-      // Same name, different namespace types
-      const bizUUID = makeUUID('business', 'test-entity');
-      const transactionUUID = makeUUID('transaction', 'test-entity');
-      const documentUUID = makeUUID('document', 'test-entity');
-
-      expect(bizUUID).not.toBe(transactionUUID);
-      expect(bizUUID).not.toBe(documentUUID);
-      expect(transactionUUID).not.toBe(documentUUID);
-    });
-
-    it('generates valid UUID v5 format', () => {
-      const uuid = makeUUID('charge', 'monthly-invoice-2024-11');
-
-      // UUID v5 format: xxxxxxxx-xxxx-5xxx-yxxx-xxxxxxxxxxxx
-      // where y is one of [8, 9, a, b]
-      expect(uuid).toMatch(/^[0-9a-f]{8}-[0-9a-f]{4}-5[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/);
-    });
-
-    it('handles kebab-case names correctly', () => {
-      const uuid1 = makeUUID('business', 'us-supplier-acme-llc');
-      const uuid2 = makeUUID('business', 'us-supplier-acme-llc');
-
-      expect(uuid1).toBe(uuid2);
-    });
-
-    it('handles numeric components in names', () => {
-      const uuid1 = makeUUID('charge', 'invoice-2024-11-15');
-      const uuid2 = makeUUID('charge', 'invoice-2024-11-15');
-
-      expect(uuid1).toBe(uuid2);
-    });
-
-    it('is case-sensitive for names', () => {
-      const uuid1 = makeUUID('business', 'acme-llc');
-      const uuid2 = makeUUID('business', 'ACME-LLC');
-
-      expect(uuid1).not.toBe(uuid2);
-    });
-
-    it('is case-sensitive for namespaces', () => {
-      const uuid1 = makeUUID('business', 'acme');
-      const uuid2 = makeUUID('Business', 'acme');
-
-      expect(uuid1).not.toBe(uuid2);
-    });
-  });
-});

package/src/demo-fixtures/helpers/deterministic-uuid.ts

@@ -1,68 +0,0 @@
-import { randomUUID } from 'node:crypto';
-import { v5 as uuidv5 } from 'uuid';
-
-/**
- * Fixed namespace for all demo data (regenerate on schema-breaking changes if needed).
- * Using standard DNS namespace UUID as recommended by RFC 4122.
- */
-const DEMO_NAMESPACE = '6ba7b810-9dad-11d1-80b4-00c04fd430c8';
-
-/**
- * Generate deterministic UUID v5 from semantic name.
- *
- * This function creates stable, reproducible UUIDs for demo/staging data entities.
- * The same namespace + name combination will always produce the same UUID across
- * deployments, making it safe to reference these IDs in documentation, screenshots,
- * and external links.
- *
- * @param namespace - Entity type: 'business', 'charge', 'transaction', 'document', etc.
- * @param name - Semantic identifier (kebab-case recommended)
- * @returns UUID v5 string (e.g., '550e8400-e29b-41d4-a716-446655440000')
- *
- * @example
- * ```typescript
- * // Business entity
- * makeUUID('business', 'acme-consulting-llc')
- * // => Always produces same UUID
- *
- * // Charge entity
- * makeUUID('charge', 'consulting-invoice-2024-11')
- * // => Stable across deploys
- *
- * // Financial account
- * makeUUID('financial-account', 'bank-usd-account')
- * // => Different from makeUUID('business', 'bank-usd-account')
- * ```
- *
- * @remarks
- * **Naming Conventions:**
- * - Use kebab-case for all semantic names
- * - Combine entity type + descriptive name ensures no collisions
- * - Never change a semantic name once deployed (breaks external links)
- * - For updates to same entity, append version: `acme-consulting-llc-v2`
- *
- * **Stability Warning:**
- * Once a UUID is generated and used in staging/production, the semantic name
- * MUST NOT be changed. Doing so will generate a different UUID and break:
- * - External documentation with embedded links
- * - Screenshots with visible UUIDs
- * - Any hardcoded references in client applications
- *
- * If you need to modify an entity, create a new semantic name with a version suffix.
- */
-export function makeUUID(namespace: string, name: string): string {
-  const composite = `${namespace}:${name}`;
-  return uuidv5(composite, DEMO_NAMESPACE);
-}
-
-/**
- * Backward compatible adapter for legacy single-argument API.
- * - When seed is provided, returns deterministic UUID v5 scoped under 'legacy' namespace
- * - When seed omitted, returns a random UUID to preserve previous behavior
- */
-export function makeUUIDLegacy(seed?: string): string {
-  if (seed === undefined || seed === null) {
-    return randomUUID();
-  }
-  return makeUUID('legacy', seed);
-}