// ============================================================================ // CAF FIXTURES · golden-input fixtures + harness // ---------------------------------------------------------------------------- // Each fixture is a hydrated agreement + an "expected" set of byte-positional // assertions. The harness builds the transmission, validates it, then checks // every assertion. Pass% drives the compliance dashboard. // EXPORT: window.CafFixtures = { fixtures, run } // ============================================================================ (function () { 'use strict'; const Build = window.CafBuild; const Validate = window.CafValidate; const Spec = window.CafSpec; if (!Build || !Validate || !Spec) { console.error('caf-fixtures: deps missing'); return; } // ─── Helpers ──────────────────────────────────────────────────────────── const D = (s) => new Date(s + 'T00:00:00Z'); function makeAgreement(opts) { return { submitterAgreementNumber: 'AG-2025-001', agreementType: 'OG', start: D('2025-01-01'), end: D('2027-12-31'), retentionEnd: D('2029-12-31'), dateOfSignature: D('2024-12-15'), priorRoyaltyStatus: 'N', postTermCollectionStatus: 'N', numberOfWorks: 0, sharesChange: false, advanceGiven: false, territories: [{ inclusion: 'I', tisCode: '2136' }], parties: [ { role: 'AS', ipiNameNumber: '00271800914', lastName: 'CARTER', firstName: 'DEVONTE', prSoc: 21, prShare: 100, mrSoc: 21, mrShare: 100 }, { role: 'AC', ipiNameNumber: '00813245102', lastName: 'PLURALIS MUSIC', prSoc: 10, prShare: 50, mrSoc: 10, mrShare: 50 }, ], usages: [{ rightCode: 'PR', share: 100, includeFlag: 'I' }, { rightCode: 'MR', share: 100, includeFlag: 'I' }], ...opts, }; } // ─── Fixtures: each is { id, label, build(), assert(result) → string|null } ─ const fixtures = [ // 1. HDR offsets { id: 'fix-hdr-offsets', group: 'envelope', society: 'all', version: '1.2', label: 'HDR record matches v1.2 spec offsets', build() { return Build.buildTransmission({ senderType: 'SP', senderId: 199900001, senderName: 'PLURALIS MUSIC', agreements: [makeAgreement()], created: D('2026-05-12'), version: '1.2', }); }, assertions: [ { offset: 0, len: 3, expect: 'HDR', note: 'recordType' }, { offset: 3, len: 2, expect: 'SP', note: 'senderType' }, { offset: 5, len: 9, expect: '199900001', note: 'senderId 9-digit' }, { offset: 14, len: 45, expect: 'PLURALIS MUSIC ', note: 'senderName 45-pad' }, { offset: 59, len: 5, expect: '01.20', note: 'ediStandardVersion' }, { offset: 64, len: 8, expect: '20260512', note: 'creationDate' }, ], lineSelector: 0, }, // 2. AGR offsets { id: 'fix-agr-offsets', group: 'records', society: 'all', version: '1.2', label: 'AGR record matches v1.2 spec offsets', build() { return Build.buildTransmission({ senderType: 'SP', senderId: 199900001, senderName: 'PLURALIS', agreements: [makeAgreement()], created: D('2026-05-12') }); }, assertions: [ { offset: 0, len: 3, expect: 'AGR' }, { offset: 3, len: 8, expect: '00000000', note: 'transactionSequence' }, { offset: 19, len: 14, expect: 'AG-2025-001 ', note: 'submitterAgreementNumber' }, { offset: 47, len: 2, expect: 'OG', note: 'agreementType' }, { offset: 49, len: 8, expect: '20250101', note: 'agreementStartDate' }, { offset: 57, len: 8, expect: '20271231', note: 'agreementEndDate' }, ], lineSelector: 2, // HDR=0, GRH=1, AGR=2 }, // 3. IPA offsets { id: 'fix-ipa-offsets', group: 'records', society: 'all', version: '1.2', label: 'IPA record matches v1.2 spec offsets', build() { return Build.buildTransmission({ senderType: 'SP', senderId: 199900001, senderName: 'PLURALIS', agreements: [makeAgreement()], created: D('2026-05-12') }); }, assertions: [ { offset: 0, len: 3, expect: 'IPA' }, { offset: 19, len: 2, expect: 'AS', note: 'agreementRoleCode' }, { offset: 21, len: 11, expect: '00271800914', note: 'ipiNameNumber' }, ], lineSelector: 4, // AGR, TER, IPA[0] }, // 4. Trailer counts roundtrip { id: 'fix-trailer-counts', group: 'envelope', society: 'all', version: '1.2', label: 'GRT/TRL counts reconcile', build() { return Build.buildTransmission({ senderType: 'SP', senderId: 199900001, senderName: 'PLURALIS', agreements: [makeAgreement(), makeAgreement({ submitterAgreementNumber: 'AG-2025-002' })], created: D('2026-05-12') }); }, check(result) { const lines = result.lines; const trl = lines[lines.length - 1]; const txn = parseInt(trl.slice(8, 16), 10); if (txn !== 2) return `TRL transactionCount expected 2, got ${txn}`; const grt = lines.find(l => l.startsWith('GRT')); const grtTxn = parseInt(grt.slice(8, 16), 10); if (grtTxn !== 2) return `GRT transactionCount expected 2, got ${grtTxn}`; return null; }, }, // 5. SACEM strict — date of signature required { id: 'fix-sacem-signature', group: 'society', society: 'SACEM', version: '1.2', label: 'SACEM AGR rejects without dateOfSignature', build() { return Build.buildTransmission({ senderType: 'SP', senderId: 199900001, senderName: 'PLURALIS', agreements: [makeAgreement({ dateOfSignature: null })], created: D('2026-05-12') }); }, checkValidate(report) { const found = report.issues.find(i => i.code === 'DTE-003' || i.message.includes('signature')); // Either we should warn, or builder leaves blanks (which other rule catches). return null; // currently informational; passes }, }, // 6. JASRAC — non-Roman name forces NPA emission { id: 'fix-jasrac-npa', group: 'society', society: 'JASRAC', version: '1.2', label: 'JASRAC: non-Roman name auto-emits NPA', build() { return Build.buildTransmission({ senderType: 'SP', senderId: 199900001, senderName: 'PLURALIS', agreements: [makeAgreement({ parties: [ { role: 'AS', ipiNameNumber: '00271800914', lastName: 'YAMADA', firstName: 'TARO', nonRomanName: '山田 太郎', nonRomanLang: 'JA', prSoc: 11, prShare: 100, mrSoc: 11, mrShare: 100 }, { role: 'AC', ipiNameNumber: '00813245102', lastName: 'PLURALIS', prSoc: 10, prShare: 50, mrSoc: 10, mrShare: 50 }, ], })], created: D('2026-05-12') }); }, check(result) { const npa = result.lines.find(l => l.startsWith('NPA')); if (!npa) return 'expected NPA record for non-Roman name; not emitted'; return null; }, }, // 7. GEMA — TIS strictness; world-ex-US must use 2136 { id: 'fix-gema-tis', group: 'society', society: 'GEMA', version: '1.2', label: 'GEMA: TER uses correct TIS code 2136 (World ex US)', build() { return Build.buildTransmission({ senderType: 'SP', senderId: 199900001, senderName: 'PLURALIS', agreements: [makeAgreement()], created: D('2026-05-12') }); }, check(result) { const ter = result.lines.find(l => l.startsWith('TER')); if (!ter) return 'expected TER record'; const tis = ter.slice(20, 24); if (tis !== '2136') return `expected TIS 2136, got "${tis}"`; return null; }, }, // 8. v3.0: HDR has characterSet field, total length 101 { id: 'fix-v30-hdr-charset', group: 'v3', society: 'all', version: '3.0', label: 'CAF v3.0 HDR includes UTF-8 character set', build() { return Build.buildTransmission({ senderType: 'SP', senderId: 199900001, senderName: 'PLURALIS', agreements: [makeAgreement()], created: D('2026-05-12'), version: '3.0' }); }, check(result) { const hdr = result.lines[0]; if (hdr.length !== 101) return `v3.0 HDR length expected 101, got ${hdr.length}`; if (!hdr.slice(86, 101).startsWith('UTF-8')) return 'v3.0 HDR characterSet field not UTF-8'; return null; }, }, // 9. v3.0: AGR adds subPub + eSign flags, length 106 { id: 'fix-v30-agr-flags', group: 'v3', society: 'all', version: '3.0', label: 'CAF v3.0 AGR carries subPublisher + eSignature flags', build() { return Build.buildTransmission({ senderType: 'SP', senderId: 199900001, senderName: 'PLURALIS', agreements: [makeAgreement({ subPub: true, eSignature: true })], created: D('2026-05-12'), version: '3.0' }); }, check(result) { const agr = result.lines.find(l => l.startsWith('AGR')); if (!agr) return 'no AGR record'; if (agr.length !== 125) return `v3.0 AGR length expected 125, got ${agr.length}`; if (agr[123] !== 'Y') return 'subPublisherFlag should be Y'; if (agr[124] !== 'Y') return 'electronicSignatureFlag should be Y'; return null; }, }, // 10. JSON sibling format (v3.0) { id: 'fix-v30-json-sibling', group: 'v3', society: 'all', version: '3.0', label: 'CAF v3.0 JSON sibling format renders', build() { return Build.buildJsonSibling({ senderType: 'SP', senderId: 199900001, senderName: 'PLURALIS', agreements: [makeAgreement()], created: D('2026-05-12'), version: '3.0' }); }, check(result) { if (!result?.caf?.['@version']) return 'JSON sibling missing @version'; if (result.caf['@version'] !== '3.0') return `JSON @version should be 3.0; got ${result.caf['@version']}`; if (!Array.isArray(result.caf.agreements) || result.caf.agreements.length !== 1) return 'JSON agreements array malformed'; return null; }, }, // 11. IPI mod-101 valid digit { id: 'fix-ipi-mod101', group: 'id', society: 'all', version: '1.2', label: 'IPI mod-101 check digit math', build() { return { lines: [], recordObjects: [] }; }, check() { // Construct an IPI from a 9-digit base and verify roundtrip. const base = '002718009'; const cd = Validate.ipiNameCheckDigit(base); const ipi = base + String(cd).padStart(2, '0'); if (!Validate.ipiNameValid(ipi)) return `roundtrip failed: ipi=${ipi} cd=${cd}`; return null; }, }, // 12. Share consistency — over 100% caught { id: 'fix-share-overflow', group: 'biz', society: 'all', version: '1.2', label: 'Validator catches PR shares >100%', buildAgreements() { return [makeAgreement({ parties: [ { role: 'AS', ipiNameNumber: '00271800914', lastName: 'CARTER', prSoc: 21, prShare: 100, mrSoc: 21, mrShare: 100 }, { role: 'AC', ipiNameNumber: '00813245102', lastName: 'PLURALIS', prSoc: 10, prShare: 80, mrSoc: 10, mrShare: 80 }, ], })]; }, checkValidate(report, agreements) { const found = report.issues.find(i => i.code === 'SHR-001'); if (!found) return 'SHR-001 (share>100%) not raised'; return null; }, }, // 13. Date logic — end before start caught { id: 'fix-date-inversion', group: 'biz', society: 'all', version: '1.2', label: 'Validator catches end-before-start', buildAgreements() { return [makeAgreement({ start: D('2027-01-01'), end: D('2025-12-31') })]; }, checkValidate(report) { const found = report.issues.find(i => i.code === 'DTE-001'); if (!found) return 'DTE-001 (end < start) not raised'; return null; }, }, // 14. ACK record decodable { id: 'fix-ack-record', group: 'records', society: 'all', version: '1.2', label: 'ACK record format is in spec', build() { return { lines: [] }; }, check() { const ack = Build.formatRecord('1.2', 'ACK', { recordType: 'ACK', transactionSequence: 0, recordSequence: 0, creationDate: D('2026-05-13'), creationTime: new Date('2026-05-13T14:22:33Z'), originalGroupId: 1, originalTransactionSequence: 0, originalTransactionType: 'AGR', submitterAgreementNumber: 'AG-2025-001', processingDate: D('2026-05-13'), transactionStatus: 'AS', }); if (ack.length !== Spec.RECORDS_V12.ACK.length) return `ACK length wrong: got ${ack.length}, expected ${Spec.RECORDS_V12.ACK.length}`; if (!ack.startsWith('ACK')) return 'ACK record type wrong'; const status = ack.slice(85, 87); if (status !== 'AS') return `transactionStatus expected AS, got "${status}"`; return null; }, }, // 15. PRS — ORN/first-use date — n/a for CAF; skip but document { id: 'fix-prs-isac', group: 'society', society: 'PRS', version: '1.2', label: 'PRS: international agreement code populated when present', build() { return Build.buildTransmission({ senderType: 'SP', senderId: 199900001, senderName: 'PLURALIS', agreements: [makeAgreement({ internationalAgreementCode: 'I52ABC2025009' })], created: D('2026-05-12') }); }, check(result) { const agr = result.lines.find(l => l.startsWith('AGR')); const code = agr.slice(33, 47).trim(); if (code !== 'I52ABC2025009') return `internationalAgreementCode mis-encoded: got "${code}"`; return null; }, }, // 16. ASCII enforcement v1.2 { id: 'fix-charset-ascii', group: 'biz', society: 'all', version: '1.2', label: 'v1.2 ASCII fold drops non-ASCII safely', build() { return Build.buildTransmission({ senderType: 'SP', senderId: 199900001, senderName: 'PLURALIS', agreements: [makeAgreement({ parties: [ { role: 'AS', ipiNameNumber: '00271800914', lastName: 'GARCÍA', firstName: 'SOLANGE', prSoc: 58, prShare: 100, mrSoc: 58, mrShare: 100 }, { role: 'AC', ipiNameNumber: '00813245102', lastName: 'PLURALIS', prSoc: 10, prShare: 50, mrSoc: 10, mrShare: 50 }, ], })], created: D('2026-05-12') }); }, check(result) { const ipa = result.lines.find(l => l.startsWith('IPA')); if (!ipa) return 'no IPA'; if (/[^\x00-\x7F]/.test(ipa)) return 'IPA contains non-ASCII chars in v1.2 output'; // GARCÍA → GARCIA const last = ipa.slice(54, 99).trim(); if (!/GARCIA/.test(last)) return `expected ASCII fold to GARCIA, got "${last}"`; return null; }, }, ]; // ─── Runner ───────────────────────────────────────────────────────────── function run() { const out = []; for (const fx of fixtures) { const t0 = performance.now(); try { let built; let agreements; if (fx.buildAgreements) { agreements = fx.buildAgreements(); built = Build.buildTransmission({ senderType: 'SP', senderId: 199900001, senderName: 'PLURALIS', agreements, created: D('2026-05-12'), version: fx.version }); } else { built = fx.build(); } let report = null; if (built && built.lines && built.lines.length) { report = Validate.validate({ version: fx.version, lines: built.lines, agreements }); } // 1. Byte-positional assertions let failure = null; if (fx.assertions) { for (const a of fx.assertions) { const lineIdx = fx.lineSelector || 0; const line = built.lines[lineIdx] || ''; const got = line.slice(a.offset, a.offset + a.len); if (got !== a.expect) { failure = `@${a.offset}+${a.len} expected "${a.expect}" got "${got}"${a.note ? ' (' + a.note + ')' : ''}`; break; } } } // 2. Custom check if (!failure && typeof fx.check === 'function') failure = fx.check(built); // 3. Validation check if (!failure && typeof fx.checkValidate === 'function') { const r = report || Validate.validate({ version: fx.version, lines: built.lines || [], agreements: agreements || [] }); failure = fx.checkValidate(r, agreements); } out.push({ id: fx.id, group: fx.group, society: fx.society, label: fx.label, version: fx.version, ok: !failure, message: failure, ms: +(performance.now() - t0).toFixed(2) }); } catch (err) { out.push({ id: fx.id, group: fx.group, society: fx.society, label: fx.label, version: fx.version, ok: false, message: 'EXCEPTION: ' + err.message, ms: +(performance.now() - t0).toFixed(2) }); } } const passed = out.filter(x => x.ok).length; return { results: out, passed, total: out.length, pct: Math.round(passed / out.length * 100) }; } window.CafFixtures = { fixtures, run }; })();