@ttt-productions/ttt-core 0.79.47 → 0.79.49

package/dist/doc-schemas/public-documents.js

@@ -0,0 +1,158 @@
+// Versioned public documents — the Firestore contracts of the release system.
+//
+//   _appConfig/{documentId}                                   current projection (public; the
+//                                                             existing page readers read it)
+//   publicDocuments/{documentId}/publicDocumentVersions/v{n}  immutable published version
+//   publicDocumentDrafts/{documentId}                         the private working copy
+//   publicDocumentReleases/{releaseId}                        one release record per publish
+//   _appConfig/app.publicDocumentVersions                     the version block every session
+//                                                             already reads live
+//   userProfiles/{uid}/privateData/{uid}.publicDocumentAcceptance
+//                                                             what the person last accepted
+//
+// All are backend-written. Versions are whole numbers v1, v2, … per document, assigned by the
+// one publish transaction; a correction is a new version, never an edit. "Require acceptance"
+// is recorded on the release and in the version block — never as a second version number.
+// Acceptance HISTORY lives only in the append-only `publicDocuments.accepted` audit events.
+import { z } from 'zod';
+import { SPECIAL_DOCS } from '../paths/collections.js';
+import { PUBLIC_DOCUMENT_IDS } from '../constants/public-documents.js';
+import { LegalPageDocumentSchema, RulesAndAgreementsSchema, FuturePlansDocumentSchema, TakeItDownPageCopySchema, DmcaPolicyDocumentSchema, } from './content.js';
+import { LegalReviewNoticeRevisionSchema } from './legal-review-notice.js';
+export const PublicDocumentIdSchema = z.enum(PUBLIC_DOCUMENT_IDS);
+/** A published version number: v1 is the first. */
+export const PublicDocumentVersionNumberSchema = z.number().int().positive();
+/** A version reference where 0 means "none yet" (never accepted / never required / no base). */
+const versionOrNoneSchema = z.number().int().nonnegative();
+/** An acceptance level: 0 = nothing required / nothing accepted; each requiring release adds 1. */
+export const PublicDocumentAcceptanceLevelSchema = z.number().int().nonnegative();
+/** A document paired with one of its published versions. */
+export const PublicDocumentVersionRefSchema = z
+    .object({
+    documentId: PublicDocumentIdSchema,
+    version: PublicDocumentVersionNumberSchema,
+})
+    .strict();
+// ── Content ──────────────────────────────────────────────────────────────────
+// A document's CONTENT is its current-projection shape minus `version` / `lastUpdated`, so the
+// existing page readers, the working copy, and the immutable version all share one shape.
+export const LegalPageContentSchema = LegalPageDocumentSchema.pick({ sections: true });
+export const RulesAndAgreementsContentSchema = RulesAndAgreementsSchema.pick({ rules: true, agreements: true });
+export const FuturePlansContentSchema = FuturePlansDocumentSchema.pick({ plans: true });
+export const TakeItDownPageCopyContentSchema = TakeItDownPageCopySchema.pick({ strings: true });
+export const DmcaPolicyContentSchema = DmcaPolicyDocumentSchema.pick({
+    intro: true,
+    contactBlocks: true,
+    sections: true,
+});
+/** Each document's stored content schema. */
+export const PUBLIC_DOCUMENT_CONTENT_SCHEMAS = {
+    [SPECIAL_DOCS.TERMS_PAGE]: LegalPageContentSchema,
+    [SPECIAL_DOCS.PRIVACY_PAGE]: LegalPageContentSchema,
+    [SPECIAL_DOCS.RULES_AND_AGREEMENTS]: RulesAndAgreementsContentSchema,
+    [SPECIAL_DOCS.FUTURE_PLANS]: FuturePlansContentSchema,
+    [SPECIAL_DOCS.DMCA_POLICY]: DmcaPolicyContentSchema,
+    [SPECIAL_DOCS.TAKE_IT_DOWN_PAGE_COPY]: TakeItDownPageCopyContentSchema,
+};
+/** Each document's current-projection schema (`_appConfig/{documentId}`). */
+export const PUBLIC_DOCUMENT_PROJECTION_SCHEMAS = {
+    [SPECIAL_DOCS.TERMS_PAGE]: LegalPageDocumentSchema,
+    [SPECIAL_DOCS.PRIVACY_PAGE]: LegalPageDocumentSchema,
+    [SPECIAL_DOCS.RULES_AND_AGREEMENTS]: RulesAndAgreementsSchema,
+    [SPECIAL_DOCS.FUTURE_PLANS]: FuturePlansDocumentSchema,
+    [SPECIAL_DOCS.DMCA_POLICY]: DmcaPolicyDocumentSchema,
+    [SPECIAL_DOCS.TAKE_IT_DOWN_PAGE_COPY]: TakeItDownPageCopySchema,
+};
+// One discriminated branch per document, so a version or draft's `content` is typed by its
+// `documentId`.
+function perDocument(shape) {
+    const branch = (documentId) => z.object({ documentId: z.literal(documentId), content: PUBLIC_DOCUMENT_CONTENT_SCHEMAS[documentId], ...shape });
+    return z.discriminatedUnion('documentId', [
+        branch(SPECIAL_DOCS.TERMS_PAGE),
+        branch(SPECIAL_DOCS.PRIVACY_PAGE),
+        branch(SPECIAL_DOCS.RULES_AND_AGREEMENTS),
+        branch(SPECIAL_DOCS.FUTURE_PLANS),
+        branch(SPECIAL_DOCS.DMCA_POLICY),
+        branch(SPECIAL_DOCS.TAKE_IT_DOWN_PAGE_COPY),
+    ]);
+}
+// ── Immutable version ────────────────────────────────────────────────────────
+/**
+ * `publicDocuments/{documentId}/publicDocumentVersions/v{version}` — one published version,
+ * written once by the publish transaction and never edited: the full content, the version,
+ * the release that published it, the publisher's uid, and the server time.
+ */
+export const PublicDocumentVersionSchema = perDocument({
+    version: PublicDocumentVersionNumberSchema,
+    releaseId: z.string().min(1),
+    publishedBy: z.string().min(1),
+    publishedAt: z.number(),
+});
+// ── Working copy ─────────────────────────────────────────────────────────────
+/**
+ * `publicDocumentDrafts/{documentId}` — the one private working copy of a document, saved from
+ * its Admin editor. `baseVersion` is the published version the edit started from (0 when the
+ * document has never been published): the publish rejects a draft whose base is no longer the
+ * current version, and one whose content equals the current version.
+ */
+export const PublicDocumentDraftSchema = perDocument({
+    baseVersion: versionOrNoneSchema,
+    savedBy: z.string().min(1),
+    savedAt: z.number(),
+});
+// ── Release record ───────────────────────────────────────────────────────────
+/**
+ * `publicDocumentReleases/{releaseId}` — one record per publish: which documents moved to
+ * which versions, whether the release requires acceptance, the required-acceptance level in
+ * force after it (raised by one only when it requires acceptance), and who published it when.
+ */
+export const PublicDocumentReleaseSchema = z.object({
+    releaseId: z.string().min(1),
+    documents: z.array(PublicDocumentVersionRefSchema).min(1),
+    requireAcceptance: z.boolean(),
+    requiredAcceptanceLevel: PublicDocumentAcceptanceLevelSchema,
+    publishedBy: z.string().min(1),
+    publishedAt: z.number(),
+});
+// ── Version block on _appConfig/app ──────────────────────────────────────────
+/**
+ * One document's entry in the version block: its current published version and the latest
+ * version a release REQUIRED acceptance of (0 when none has).
+ */
+export const PublicDocumentVersionStateSchema = z
+    .object({
+    currentVersion: PublicDocumentVersionNumberSchema,
+    requiredVersion: versionOrNoneSchema,
+})
+    .strict()
+    .refine((state) => state.requiredVersion <= state.currentVersion, {
+    message: 'requiredVersion cannot exceed currentVersion',
+});
+/**
+ * `_appConfig/app.publicDocumentVersions` — written only by the publish transaction. A document
+ * never published has no entry. `requiredAcceptanceLevel` rises by one with every release that
+ * requires acceptance; a session whose accepted level is below it is asked to accept.
+ */
+export const PublicDocumentVersionBlockSchema = z
+    .object({
+    documents: z.partialRecord(PublicDocumentIdSchema, PublicDocumentVersionStateSchema),
+    requiredAcceptanceLevel: PublicDocumentAcceptanceLevelSchema,
+})
+    .strict();
+// ── The person's acceptance summary (private doc) ────────────────────────────
+/**
+ * `privateData/{uid}.publicDocumentAcceptance` — the LATEST accepted version of each document
+ * and the accepted level, replaced whole on every acceptance (registration or the re-acceptance
+ * prompt). A document absent from `documentVersions` counts as version 0. The notice revision in
+ * force at that acceptance is recorded when the notice was active. History is not kept here — it
+ * is the `publicDocuments.accepted` audit events.
+ */
+export const PublicDocumentAcceptanceSchema = z
+    .object({
+    documentVersions: z.partialRecord(PublicDocumentIdSchema, versionOrNoneSchema),
+    acceptedLevel: PublicDocumentAcceptanceLevelSchema,
+    legalReviewNoticeRevision: LegalReviewNoticeRevisionSchema.optional(),
+    acceptedAt: z.number(),
+})
+    .strict();
+//# sourceMappingURL=public-documents.js.map

package/dist/doc-schemas/public-documents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-documents.js","sourceRoot":"","sources":["../../src/doc-schemas/public-documents.ts"],"names":[],"mappings":"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","sourcesContent":["// Versioned public documents — the Firestore contracts of the release system.\n//\n//   _appConfig/{documentId}                                   current projection (public; the\n//                                                             existing page readers read it)\n//   publicDocuments/{documentId}/publicDocumentVersions/v{n}  immutable published version\n//   publicDocumentDrafts/{documentId}                         the private working copy\n//   publicDocumentReleases/{releaseId}                        one release record per publish\n//   _appConfig/app.publicDocumentVersions                     the version block every session\n//                                                             already reads live\n//   userProfiles/{uid}/privateData/{uid}.publicDocumentAcceptance\n//                                                             what the person last accepted\n//\n// All are backend-written. Versions are whole numbers v1, v2, … per document, assigned by the\n// one publish transaction; a correction is a new version, never an edit. \"Require acceptance\"\n// is recorded on the release and in the version block — never as a second version number.\n// Acceptance HISTORY lives only in the append-only `publicDocuments.accepted` audit events.\n\nimport { z } from 'zod';\nimport { SPECIAL_DOCS } from '../paths/collections.js';\nimport { PUBLIC_DOCUMENT_IDS, type PublicDocumentId } from '../constants/public-documents.js';\nimport {\n  LegalPageDocumentSchema,\n  RulesAndAgreementsSchema,\n  FuturePlansDocumentSchema,\n  TakeItDownPageCopySchema,\n  DmcaPolicyDocumentSchema,\n} from './content.js';\nimport { LegalReviewNoticeRevisionSchema } from './legal-review-notice.js';\n\nexport const PublicDocumentIdSchema = z.enum(PUBLIC_DOCUMENT_IDS);\n\n/** A published version number: v1 is the first. */\nexport const PublicDocumentVersionNumberSchema = z.number().int().positive();\n\n/** A version reference where 0 means \"none yet\" (never accepted / never required / no base). */\nconst versionOrNoneSchema = z.number().int().nonnegative();\n\n/** An acceptance level: 0 = nothing required / nothing accepted; each requiring release adds 1. */\nexport const PublicDocumentAcceptanceLevelSchema = z.number().int().nonnegative();\n\n/** A document paired with one of its published versions. */\nexport const PublicDocumentVersionRefSchema = z\n  .object({\n    documentId: PublicDocumentIdSchema,\n    version: PublicDocumentVersionNumberSchema,\n  })\n  .strict();\nexport type PublicDocumentVersionRef = z.infer<typeof PublicDocumentVersionRefSchema>;\n\n// ── Content ──────────────────────────────────────────────────────────────────\n// A document's CONTENT is its current-projection shape minus `version` / `lastUpdated`, so the\n// existing page readers, the working copy, and the immutable version all share one shape.\n\nexport const LegalPageContentSchema = LegalPageDocumentSchema.pick({ sections: true });\nexport const RulesAndAgreementsContentSchema = RulesAndAgreementsSchema.pick({ rules: true, agreements: true });\nexport const FuturePlansContentSchema = FuturePlansDocumentSchema.pick({ plans: true });\nexport const TakeItDownPageCopyContentSchema = TakeItDownPageCopySchema.pick({ strings: true });\nexport const DmcaPolicyContentSchema = DmcaPolicyDocumentSchema.pick({\n  intro: true,\n  contactBlocks: true,\n  sections: true,\n});\n\n/** Each document's stored content schema. */\nexport const PUBLIC_DOCUMENT_CONTENT_SCHEMAS = {\n  [SPECIAL_DOCS.TERMS_PAGE]: LegalPageContentSchema,\n  [SPECIAL_DOCS.PRIVACY_PAGE]: LegalPageContentSchema,\n  [SPECIAL_DOCS.RULES_AND_AGREEMENTS]: RulesAndAgreementsContentSchema,\n  [SPECIAL_DOCS.FUTURE_PLANS]: FuturePlansContentSchema,\n  [SPECIAL_DOCS.DMCA_POLICY]: DmcaPolicyContentSchema,\n  [SPECIAL_DOCS.TAKE_IT_DOWN_PAGE_COPY]: TakeItDownPageCopyContentSchema,\n} as const satisfies Record<PublicDocumentId, z.ZodType>;\n\n/** The content of document `D`. */\nexport type PublicDocumentContent<D extends PublicDocumentId = PublicDocumentId> = z.infer<\n  (typeof PUBLIC_DOCUMENT_CONTENT_SCHEMAS)[D]\n>;\n\n/** Each document's current-projection schema (`_appConfig/{documentId}`). */\nexport const PUBLIC_DOCUMENT_PROJECTION_SCHEMAS = {\n  [SPECIAL_DOCS.TERMS_PAGE]: LegalPageDocumentSchema,\n  [SPECIAL_DOCS.PRIVACY_PAGE]: LegalPageDocumentSchema,\n  [SPECIAL_DOCS.RULES_AND_AGREEMENTS]: RulesAndAgreementsSchema,\n  [SPECIAL_DOCS.FUTURE_PLANS]: FuturePlansDocumentSchema,\n  [SPECIAL_DOCS.DMCA_POLICY]: DmcaPolicyDocumentSchema,\n  [SPECIAL_DOCS.TAKE_IT_DOWN_PAGE_COPY]: TakeItDownPageCopySchema,\n} as const satisfies Record<PublicDocumentId, z.ZodType>;\n\n/**\n * The current projection the publish writes for document `D`: its content plus the version and\n * the publish time. Assignable to the page's existing document type.\n */\nexport type PublicDocumentProjection<D extends PublicDocumentId = PublicDocumentId> =\n  PublicDocumentContent<D> & { version: number; lastUpdated: number };\n\n// One discriminated branch per document, so a version or draft's `content` is typed by its\n// `documentId`.\nfunction perDocument<const S extends z.ZodRawShape>(shape: S) {\n  const branch = <const D extends PublicDocumentId>(documentId: D) =>\n    z.object({ documentId: z.literal(documentId), content: PUBLIC_DOCUMENT_CONTENT_SCHEMAS[documentId], ...shape });\n  return z.discriminatedUnion('documentId', [\n    branch(SPECIAL_DOCS.TERMS_PAGE),\n    branch(SPECIAL_DOCS.PRIVACY_PAGE),\n    branch(SPECIAL_DOCS.RULES_AND_AGREEMENTS),\n    branch(SPECIAL_DOCS.FUTURE_PLANS),\n    branch(SPECIAL_DOCS.DMCA_POLICY),\n    branch(SPECIAL_DOCS.TAKE_IT_DOWN_PAGE_COPY),\n  ]);\n}\n\n// ── Immutable version ────────────────────────────────────────────────────────\n\n/**\n * `publicDocuments/{documentId}/publicDocumentVersions/v{version}` — one published version,\n * written once by the publish transaction and never edited: the full content, the version,\n * the release that published it, the publisher's uid, and the server time.\n */\nexport const PublicDocumentVersionSchema = perDocument({\n  version: PublicDocumentVersionNumberSchema,\n  releaseId: z.string().min(1),\n  publishedBy: z.string().min(1),\n  publishedAt: z.number(),\n});\nexport type PublicDocumentVersion = z.infer<typeof PublicDocumentVersionSchema>;\n\n// ── Working copy ─────────────────────────────────────────────────────────────\n\n/**\n * `publicDocumentDrafts/{documentId}` — the one private working copy of a document, saved from\n * its Admin editor. `baseVersion` is the published version the edit started from (0 when the\n * document has never been published): the publish rejects a draft whose base is no longer the\n * current version, and one whose content equals the current version.\n */\nexport const PublicDocumentDraftSchema = perDocument({\n  baseVersion: versionOrNoneSchema,\n  savedBy: z.string().min(1),\n  savedAt: z.number(),\n});\nexport type PublicDocumentDraft = z.infer<typeof PublicDocumentDraftSchema>;\n\n// ── Release record ───────────────────────────────────────────────────────────\n\n/**\n * `publicDocumentReleases/{releaseId}` — one record per publish: which documents moved to\n * which versions, whether the release requires acceptance, the required-acceptance level in\n * force after it (raised by one only when it requires acceptance), and who published it when.\n */\nexport const PublicDocumentReleaseSchema = z.object({\n  releaseId: z.string().min(1),\n  documents: z.array(PublicDocumentVersionRefSchema).min(1),\n  requireAcceptance: z.boolean(),\n  requiredAcceptanceLevel: PublicDocumentAcceptanceLevelSchema,\n  publishedBy: z.string().min(1),\n  publishedAt: z.number(),\n});\nexport type PublicDocumentRelease = z.infer<typeof PublicDocumentReleaseSchema>;\n\n// ── Version block on _appConfig/app ──────────────────────────────────────────\n\n/**\n * One document's entry in the version block: its current published version and the latest\n * version a release REQUIRED acceptance of (0 when none has).\n */\nexport const PublicDocumentVersionStateSchema = z\n  .object({\n    currentVersion: PublicDocumentVersionNumberSchema,\n    requiredVersion: versionOrNoneSchema,\n  })\n  .strict()\n  .refine((state) => state.requiredVersion <= state.currentVersion, {\n    message: 'requiredVersion cannot exceed currentVersion',\n  });\nexport type PublicDocumentVersionState = z.infer<typeof PublicDocumentVersionStateSchema>;\n\n/**\n * `_appConfig/app.publicDocumentVersions` — written only by the publish transaction. A document\n * never published has no entry. `requiredAcceptanceLevel` rises by one with every release that\n * requires acceptance; a session whose accepted level is below it is asked to accept.\n */\nexport const PublicDocumentVersionBlockSchema = z\n  .object({\n    documents: z.partialRecord(PublicDocumentIdSchema, PublicDocumentVersionStateSchema),\n    requiredAcceptanceLevel: PublicDocumentAcceptanceLevelSchema,\n  })\n  .strict();\nexport type PublicDocumentVersionBlock = z.infer<typeof PublicDocumentVersionBlockSchema>;\n\n// ── The person's acceptance summary (private doc) ────────────────────────────\n\n/**\n * `privateData/{uid}.publicDocumentAcceptance` — the LATEST accepted version of each document\n * and the accepted level, replaced whole on every acceptance (registration or the re-acceptance\n * prompt). A document absent from `documentVersions` counts as version 0. The notice revision in\n * force at that acceptance is recorded when the notice was active. History is not kept here — it\n * is the `publicDocuments.accepted` audit events.\n */\nexport const PublicDocumentAcceptanceSchema = z\n  .object({\n    documentVersions: z.partialRecord(PublicDocumentIdSchema, versionOrNoneSchema),\n    acceptedLevel: PublicDocumentAcceptanceLevelSchema,\n    legalReviewNoticeRevision: LegalReviewNoticeRevisionSchema.optional(),\n    acceptedAt: z.number(),\n  })\n  .strict();\nexport type PublicDocumentAcceptance = z.infer<typeof PublicDocumentAcceptanceSchema>;\n"]}