@wildo-ai/saas-technical-doc 1.1.1

package/dist/esm/content/application-consumer-documentation-content-manifest.schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"application-consumer-documentation-content-manifest.schemas.js","sourceRoot":"","sources":["../../../../src/content/application-consumer-documentation-content-manifest.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["/** Portable identities for the reusable engine-owned application-consumer content bundle. No filesystem or companion runtime belongs in this module. */\nimport { z } from 'zod';\n\nimport {\n  TechnicalDocumentationNormalizedRelativePathSchema,\n  TechnicalDocumentationRefSchema,\n  technicalDocumentationValuesAreUniqueAndSorted,\n} from '@wildo-ai/saas-specifications/technical-documentation';\n\n/** Exact media types accepted by the engine-owned application-consumer content bundle. */\nexport enum ApplicationConsumerDocumentationContentMediaType {\n  MARKDOWN_UTF8 = 'text/markdown; charset=utf-8',\n}\n\n/** The engine-owned content bundle's stable name. With `contentBundleVersion` it is the bundle's identity. */\nexport const APPLICATION_CONSUMER_DOCUMENTATION_CONTENT_BUNDLE_REF = 'technical-documentation:content-bundle/engine-application-consumer' as const;\n\nexport const APPLICATION_CONSUMER_DOCUMENTATION_ENGINE_CONTENT_SOURCE_PREFIX = 'saas-technical-doc:engine-content/' as const;\n/**\n * References to safe, explicitly curated facts projected from framework source.\n *\n * Authored Markdown may cite these facts but can never cite an arbitrary model,\n * resource specification, or source file. The companion projector joins each\n * reference to the exact catalog entry and fails closed when it is absent.\n */\nexport const APPLICATION_CONSUMER_DOCUMENTATION_CONSUMER_FACT_SOURCE_PREFIX = 'source:consumer-fact:' as const;\n/**\n * A narrow, public projection made by the application companion. The current\n * use is the application's organization-role inventory; it is deliberately\n * not a general escape hatch for arbitrary application source.\n */\nexport const APPLICATION_CONSUMER_DOCUMENTATION_COMPANION_PROJECTION_SOURCE_PREFIX = 'source:companion-projection:' as const;\n\nexport const ApplicationConsumerDocumentationContentFileIdentityV1Schema = z.strictObject({\n  managedPath: TechnicalDocumentationNormalizedRelativePathSchema,\n  mediaType: z.literal(ApplicationConsumerDocumentationContentMediaType.MARKDOWN_UTF8),\n  byteLength: z.number().int().nonnegative(),\n  /**\n   * sha256 of the file's exact UTF-8 bytes. Kept through the 2026-08-27 digest demolition because\n   * it names opaque emitted content and detects its corruption; the `semanticDigest` and\n   * `contentBundleRootDigest` that sat beside it recorded agreement between two parts of this\n   * repository, which is what went.\n   */\n  fileDigest: z.string().regex(/^sha256:[0-9a-f]{64}$/),\n  unitRef: TechnicalDocumentationRefSchema,\n});\nexport type ApplicationConsumerDocumentationContentFileIdentityV1 = z.infer<typeof ApplicationConsumerDocumentationContentFileIdentityV1Schema>;\n\nexport const ApplicationConsumerDocumentationContentUnitIdentityV1Schema = z\n  .strictObject({\n    unitRef: TechnicalDocumentationRefSchema,\n    sourceRefs: z.array(TechnicalDocumentationRefSchema).min(1),\n    managedPaths: z.array(TechnicalDocumentationNormalizedRelativePathSchema).min(1),\n  })\n  .superRefine((unit, context) => {\n    if (!technicalDocumentationValuesAreUniqueAndSorted(unit.sourceRefs)) {\n      context.addIssue({ code: 'custom', message: 'content sourceRefs must be unique and sorted', path: ['sourceRefs'] });\n    }\n    if (!technicalDocumentationValuesAreUniqueAndSorted(unit.managedPaths)) {\n      context.addIssue({ code: 'custom', message: 'content managedPaths must be unique and sorted', path: ['managedPaths'] });\n    }\n    for (const [index, sourceRef] of unit.sourceRefs.entries()) {\n      if (!sourceRef.startsWith(APPLICATION_CONSUMER_DOCUMENTATION_ENGINE_CONTENT_SOURCE_PREFIX)\n        && !sourceRef.startsWith(APPLICATION_CONSUMER_DOCUMENTATION_CONSUMER_FACT_SOURCE_PREFIX)\n        && !sourceRef.startsWith(APPLICATION_CONSUMER_DOCUMENTATION_COMPANION_PROJECTION_SOURCE_PREFIX)) {\n        context.addIssue({ code: 'custom', message: 'engine content units can cite only engine-content, curated consumer-fact, or declared companion-projection source refs', path: ['sourceRefs', index] });\n      }\n    }\n  });\nexport type ApplicationConsumerDocumentationContentUnitIdentityV1 = z.infer<typeof ApplicationConsumerDocumentationContentUnitIdentityV1Schema>;\n\n/**\n * Exact identity of the managed engine content bundle.\n *\n * generatedAt is operational provenance only, and is excluded from every comparison so regenerating\n * identical source bytes stays identity-stable.\n */\nexport const ApplicationConsumerDocumentationContentManifestV1Schema = z\n  .strictObject({\n    schemaVersion: z.literal(1),\n    contentBundleVersion: z.number().int().positive(),\n    generatedAt: z.iso.datetime(),\n    fileCount: z.number().int().positive(),\n    unitCount: z.number().int().positive(),\n    files: z.array(ApplicationConsumerDocumentationContentFileIdentityV1Schema).min(1),\n    units: z.array(ApplicationConsumerDocumentationContentUnitIdentityV1Schema).min(1),\n  })\n  .superRefine((manifest, context) => {\n    if (manifest.fileCount !== manifest.files.length) {\n      context.addIssue({ code: 'custom', message: 'fileCount must equal the exact managed file inventory', path: ['fileCount'] });\n    }\n    if (manifest.unitCount !== manifest.units.length) {\n      context.addIssue({ code: 'custom', message: 'unitCount must equal the exact unit inventory', path: ['unitCount'] });\n    }\n\n    const paths = manifest.files.map((file) => file.managedPath);\n    if (!technicalDocumentationValuesAreUniqueAndSorted(paths)) {\n      context.addIssue({ code: 'custom', message: 'managed files must be unique and sorted by path', path: ['files'] });\n    }\n    const caseFoldedPaths = paths.map((path) => path.toLocaleLowerCase('en-US'));\n    if (new Set(caseFoldedPaths).size !== caseFoldedPaths.length) {\n      context.addIssue({ code: 'custom', message: 'managed file paths cannot collide after case folding', path: ['files'] });\n    }\n\n    const unitRefs = manifest.units.map((unit) => unit.unitRef);\n    if (!technicalDocumentationValuesAreUniqueAndSorted(unitRefs)) {\n      context.addIssue({ code: 'custom', message: 'content units must be unique and sorted by unitRef', path: ['units'] });\n    }\n\n    const filesByUnitRef = new Map<string, string[]>();\n    for (const file of manifest.files) {\n      const managedPaths = filesByUnitRef.get(file.unitRef) ?? [];\n      managedPaths.push(file.managedPath);\n      filesByUnitRef.set(file.unitRef, managedPaths);\n    }\n    for (const [index, unit] of manifest.units.entries()) {\n      const exactPaths = filesByUnitRef.get(unit.unitRef)?.sort() ?? [];\n      if (exactPaths.join('\\0') !== unit.managedPaths.join('\\0')) {\n        context.addIssue({ code: 'custom', message: 'unit managedPaths must exactly cover files assigned to that unitRef', path: ['units', index, 'managedPaths'] });\n      }\n    }\n    const declaredUnitRefs = new Set(unitRefs);\n    for (const [index, file] of manifest.files.entries()) {\n      if (!declaredUnitRefs.has(file.unitRef)) {\n        context.addIssue({ code: 'custom', message: 'every managed file must belong to a declared unit', path: ['files', index, 'unitRef'] });\n      }\n    }\n  });\nexport type ApplicationConsumerDocumentationContentManifestV1 = z.infer<typeof ApplicationConsumerDocumentationContentManifestV1Schema>;\n\nexport interface ApplicationConsumerDocumentationAuthoredContentV1 {\n  readonly managedPath: string;\n  readonly unitRef: string;\n  readonly sourceRefs: readonly string[];\n  readonly markdown: string;\n}\n\n"]}