@ttt-productions/ttt-core 0.27.0 → 0.28.0

package/dist/doc-schemas/ncii/notices.d.ts

@@ -1,109 +0,0 @@
-import { z } from 'zod';
-/** Notice delivery channel. */
-export declare const NciiUploaderNoticeChannelSchema: z.ZodEnum<{
-    email: "email";
-    inApp: "inApp";
-}>;
-export type NciiUploaderNoticeChannel = z.infer<typeof NciiUploaderNoticeChannelSchema>;
-/** Who the notice is for, snapshotted at decision time (NEVER re-resolved). */
-export declare const NciiUploaderNoticeRecipientSnapshotSchema: z.ZodObject<{
-    uid: z.ZodString;
-    deliveryAddressRef: z.ZodString;
-    capturedAt: z.ZodNumber;
-}, z.core.$strict>;
-export type NciiUploaderNoticeRecipientSnapshot = z.infer<typeof NciiUploaderNoticeRecipientSnapshotSchema>;
-/** Durable retry/dead-letter delivery command on the notice. */
-export declare const NciiUploaderNoticeCommandV1Schema: z.ZodObject<{
-    commandId: z.ZodString;
-    attemptCount: z.ZodNumber;
-    nextAttemptAt: z.ZodOptional<z.ZodNumber>;
-    leaseOwner: z.ZodOptional<z.ZodString>;
-    leaseExpiresAt: z.ZodOptional<z.ZodNumber>;
-    lastErrorCode: z.ZodOptional<z.ZodString>;
-}, z.core.$strict>;
-export type NciiUploaderNoticeCommandV1 = z.infer<typeof NciiUploaderNoticeCommandV1Schema>;
-/** `nciiCases/{caseId}/uploaderNotices/{noticeId}` — durable uploader-notice
- * delivery record (OWNED by the notices cluster). Doc id `noticeId` is
- * deterministic:
- * `sha256('ncii-uploader-notice-v1:' + caseId + ':' + recipientUid + ':' + removalGeneration)`. */
-export declare const NciiUploaderNoticeV1Schema: z.ZodObject<{
-    schemaVersion: z.ZodLiteral<1>;
-    noticeId: z.ZodString;
-    caseId: z.ZodString;
-    requestIds: z.ZodArray<z.ZodString>;
-    removalGeneration: z.ZodNumber;
-    recipientSnapshot: z.ZodObject<{
-        uid: z.ZodString;
-        deliveryAddressRef: z.ZodString;
-        capturedAt: z.ZodNumber;
-    }, z.core.$strict>;
-    channel: z.ZodEnum<{
-        email: "email";
-        inApp: "inApp";
-    }>;
-    templateId: z.ZodString;
-    templateVersion: z.ZodNumber;
-    status: z.ZodEnum<{
-        pending: "pending";
-        sent: "sent";
-        delayed: "delayed";
-        suppressed: "suppressed";
-        notApplicable: "notApplicable";
-    }>;
-    suppressionReason: z.ZodOptional<z.ZodEnum<{
-        victimSafetyRisk: "victimSafetyRisk";
-        retaliationRisk: "retaliationRisk";
-        extortionRisk: "extortionRisk";
-        lawEnforcementRequest: "lawEnforcementRequest";
-        childSafetyInvestigation: "childSafetyInvestigation";
-        evidencePreservationRisk: "evidencePreservationRisk";
-        legalRestriction: "legalRestriction";
-        otherApproved: "otherApproved";
-    }>>;
-    rationaleRef: z.ZodOptional<z.ZodString>;
-    decidedByUid: z.ZodOptional<z.ZodString>;
-    delayedUntil: z.ZodOptional<z.ZodNumber>;
-    idempotencyKey: z.ZodString;
-    command: z.ZodObject<{
-        commandId: z.ZodString;
-        attemptCount: z.ZodNumber;
-        nextAttemptAt: z.ZodOptional<z.ZodNumber>;
-        leaseOwner: z.ZodOptional<z.ZodString>;
-        leaseExpiresAt: z.ZodOptional<z.ZodNumber>;
-        lastErrorCode: z.ZodOptional<z.ZodString>;
-    }, z.core.$strict>;
-    verifiedDeliveredAt: z.ZodOptional<z.ZodNumber>;
-    createdAt: z.ZodNumber;
-    updatedAt: z.ZodNumber;
-}, z.core.$strict>;
-export type NciiUploaderNoticeV1 = z.infer<typeof NciiUploaderNoticeV1Schema>;
-/** Per-attempt delivery result. */
-export declare const NciiUploaderNoticeAttemptResultSchema: z.ZodEnum<{
-    queued: "queued";
-    failed: "failed";
-    deferred: "deferred";
-    sent: "sent";
-}>;
-export type NciiUploaderNoticeAttemptResult = z.infer<typeof NciiUploaderNoticeAttemptResultSchema>;
-/** `nciiCases/{caseId}/uploaderNotices/{noticeId}/attempts/{attemptId}` —
- * IMMUTABLE append-only per-attempt ledger. Doc id `attemptId` is a
- * deterministic/assigned id (z.string().min(1)). */
-export declare const NciiUploaderNoticeAttemptV1Schema: z.ZodObject<{
-    schemaVersion: z.ZodLiteral<1>;
-    attemptId: z.ZodString;
-    at: z.ZodNumber;
-    channel: z.ZodEnum<{
-        email: "email";
-        inApp: "inApp";
-    }>;
-    result: z.ZodEnum<{
-        queued: "queued";
-        failed: "failed";
-        deferred: "deferred";
-        sent: "sent";
-    }>;
-    providerRef: z.ZodOptional<z.ZodString>;
-    errorCode: z.ZodOptional<z.ZodString>;
-}, z.core.$strict>;
-export type NciiUploaderNoticeAttemptV1 = z.infer<typeof NciiUploaderNoticeAttemptV1Schema>;
-//# sourceMappingURL=notices.d.ts.map

package/dist/doc-schemas/ncii/notices.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"notices.d.ts","sourceRoot":"","sources":["../../../src/doc-schemas/ncii/notices.ts"],"names":[],"mappings":"AAqCA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,+BAA+B;AAC/B,eAAO,MAAM,+BAA+B;;;EAA6B,CAAC;AAC1E,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAExF,+EAA+E;AAC/E,eAAO,MAAM,yCAAyC;;;;kBAI3C,CAAC;AACZ,MAAM,MAAM,mCAAmC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yCAAyC,CAAC,CAAC;AAE5G,gEAAgE;AAChE,eAAO,MAAM,iCAAiC;;;;;;;kBAOnC,CAAC;AACZ,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAM5F;;;mGAGmG;AACnG,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA6B5B,CAAC;AACZ,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAO9E,mCAAmC;AACnC,eAAO,MAAM,qCAAqC;;;;;EAAmD,CAAC;AACtG,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qCAAqC,CAAC,CAAC;AAEpG;;oDAEoD;AACpD,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;kBAQnC,CAAC;AACZ,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC"}

package/dist/doc-schemas/ncii/notices.js

@@ -1,114 +0,0 @@
-// Trust & Safety — durable uploader-notice delivery state machine (Appendix A
-// §A11 [H-10]).
-//
-// `nciiCases/{caseId}/uploaderNotices/{noticeId}` — the uploader notice is a
-// first-class durable delivery record like every other NCII workflow object (NOT
-// just two bare enums). NOTE: this notices cluster OWNS the
-// `nciiCases/{caseId}/uploaderNotices/{noticeId}` subcollection schema even though
-// the `nciiCases` root doc itself is owned by the requests cluster.
-//
-// Deterministic `noticeId = sha256('ncii-uploader-notice-v1:' + caseId + ':' +
-// recipientUid + ':' + removalGeneration)`. The client-supplied ≥128-bit
-// `idempotencyKey` together with the deterministic noticeId guarantees one record
-// per retry.
-//
-// TRANSITIONS [H-10]:
-//   pending → sent | delayed | suppressed | notApplicable
-//   delayed → sent  (when `delayedUntil` elapses and no suppression applies)
-//   delayed → suppressed
-// A failed delivery re-drives through `command` (retry/dead-letter), never silently
-// drops. Each terminal/transition writes the matching NciiActionType
-// (`uploaderNoticeSent` / `uploaderNoticeDelayed` / `uploaderNoticeSuppressed` /
-// `uploaderNoticeNotApplicable`) to the request `actions` log.
-//
-// Every shape here is transcribed verbatim from docs/code_changes_needed/
-// trust-and-safety/IMPLEMENTATION_PLAN.md Appendix A §A11 [H-10] — no invented
-// values, no placeholders.
-//
-// SHARED enums come from ../safety/foundation.js (the single source for every
-// cross-cluster enum); they are NEVER redefined here. This cluster IMPORTS
-// UploaderNoticeStatusSchema + UploaderNoticeReasonSchema.
-//
-// Collection note: this cluster owns a NEW subcollection of the requests-cluster
-// `nciiCases` root (+ an append-only per-attempt ledger); wiring collections.ts /
-// path-builders.ts / registry.ts is deferred to the app leg (the orchestrator
-// binds the schemas + path builders there); the deterministic doc-id shape is
-// documented on each schema below.
-import { z } from 'zod';
-import { UploaderNoticeStatusSchema, UploaderNoticeReasonSchema, } from '../safety/foundation.js';
-// ===========================================================================
-// §A11 [H-10] — delivery channel + embedded shapes
-// ===========================================================================
-/** Notice delivery channel. */
-export const NciiUploaderNoticeChannelSchema = z.enum(['inApp', 'email']);
-/** Who the notice is for, snapshotted at decision time (NEVER re-resolved). */
-export const NciiUploaderNoticeRecipientSnapshotSchema = z.object({
-    uid: z.string().min(1),
-    deliveryAddressRef: z.string().min(1),
-    capturedAt: z.number(),
-}).strict();
-/** Durable retry/dead-letter delivery command on the notice. */
-export const NciiUploaderNoticeCommandV1Schema = z.object({
-    commandId: z.string().min(1),
-    attemptCount: z.number(),
-    nextAttemptAt: z.number().optional(),
-    leaseOwner: z.string().min(1).optional(),
-    leaseExpiresAt: z.number().optional(),
-    lastErrorCode: z.string().optional(),
-}).strict();
-// ===========================================================================
-// §A11 [H-10] — nciiCases/{caseId}/uploaderNotices/{noticeId}
-// ===========================================================================
-/** `nciiCases/{caseId}/uploaderNotices/{noticeId}` — durable uploader-notice
- * delivery record (OWNED by the notices cluster). Doc id `noticeId` is
- * deterministic:
- * `sha256('ncii-uploader-notice-v1:' + caseId + ':' + recipientUid + ':' + removalGeneration)`. */
-export const NciiUploaderNoticeV1Schema = z.object({
-    schemaVersion: z.literal(1),
-    noticeId: z.string().min(1),
-    caseId: z.string().min(1),
-    requestIds: z.array(z.string().min(1)).max(16),
-    removalGeneration: z.number(),
-    // who, snapshotted at decision time (never re-resolved)
-    recipientSnapshot: NciiUploaderNoticeRecipientSnapshotSchema,
-    channel: NciiUploaderNoticeChannelSchema,
-    // the notice template + version actually used
-    templateId: z.string().min(1),
-    templateVersion: z.number(),
-    // 'pending'|'sent'|'delayed'|'suppressed'|'notApplicable'
-    status: UploaderNoticeStatusSchema,
-    // present ONLY when status='suppressed' (+ restricted rationale via rationaleRef + reviewer identity)
-    suppressionReason: UploaderNoticeReasonSchema.optional(),
-    // suppression/delay rationale (restricted) + reviewer identity
-    rationaleRef: z.string().min(1).optional(),
-    decidedByUid: z.string().min(1).optional(),
-    // when status='delayed' — the scheduled re-evaluation time (delayed → sent transition)
-    delayedUntil: z.number().optional(),
-    // ≥128-bit; with the deterministic noticeId guarantees one record per retry
-    idempotencyKey: z.string().min(1),
-    // durable retry/dead-letter delivery command
-    command: NciiUploaderNoticeCommandV1Schema,
-    // proof of delivery (provider receipt / read marker), when available
-    verifiedDeliveredAt: z.number().optional(),
-    createdAt: z.number(),
-    updatedAt: z.number(),
-}).strict();
-// ===========================================================================
-// §A11 [H-10] — nciiCases/{caseId}/uploaderNotices/{noticeId}/attempts/{attemptId}
-// IMMUTABLE append-only per-attempt ledger.
-// ===========================================================================
-/** Per-attempt delivery result. */
-export const NciiUploaderNoticeAttemptResultSchema = z.enum(['queued', 'sent', 'failed', 'deferred']);
-/** `nciiCases/{caseId}/uploaderNotices/{noticeId}/attempts/{attemptId}` —
- * IMMUTABLE append-only per-attempt ledger. Doc id `attemptId` is a
- * deterministic/assigned id (z.string().min(1)). */
-export const NciiUploaderNoticeAttemptV1Schema = z.object({
-    schemaVersion: z.literal(1),
-    attemptId: z.string().min(1),
-    at: z.number(),
-    channel: NciiUploaderNoticeChannelSchema,
-    result: NciiUploaderNoticeAttemptResultSchema,
-    providerRef: z.string().min(1).optional(),
-    errorCode: z.string().optional(),
-}).strict();
-//# sourceMappingURL=notices.js.map

package/dist/doc-schemas/ncii/notices.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"notices.js","sourceRoot":"","sources":["../../../src/doc-schemas/ncii/notices.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,gBAAgB;AAChB,EAAE;AACF,6EAA6E;AAC7E,iFAAiF;AACjF,4DAA4D;AAC5D,mFAAmF;AACnF,oEAAoE;AACpE,EAAE;AACF,+EAA+E;AAC/E,yEAAyE;AACzE,kFAAkF;AAClF,aAAa;AACb,EAAE;AACF,sBAAsB;AACtB,0DAA0D;AAC1D,6EAA6E;AAC7E,yBAAyB;AACzB,oFAAoF;AACpF,qEAAqE;AACrE,iFAAiF;AACjF,+DAA+D;AAC/D,EAAE;AACF,0EAA0E;AAC1E,+EAA+E;AAC/E,2BAA2B;AAC3B,EAAE;AACF,8EAA8E;AAC9E,2EAA2E;AAC3E,2DAA2D;AAC3D,EAAE;AACF,iFAAiF;AACjF,kFAAkF;AAClF,8EAA8E;AAC9E,8EAA8E;AAC9E,mCAAmC;AAEnC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,0BAA0B,EAC1B,0BAA0B,GAC3B,MAAM,yBAAyB,CAAC;AAEjC,8EAA8E;AAC9E,mDAAmD;AACnD,8EAA8E;AAE9E,+BAA+B;AAC/B,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;AAG1E,+EAA+E;AAC/E,MAAM,CAAC,MAAM,yCAAyC,GAAG,CAAC,CAAC,MAAM,CAAC;IAChE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACtB,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;CACvB,CAAC,CAAC,MAAM,EAAE,CAAC;AAGZ,gEAAgE;AAChE,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAAC,CAAC,MAAM,CAAC;IACxD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;IACxB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACxC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACrC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACrC,CAAC,CAAC,MAAM,EAAE,CAAC;AAGZ,8EAA8E;AAC9E,8DAA8D;AAC9D,8EAA8E;AAE9E;;;mGAGmG;AACnG,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,aAAa,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;IAC9C,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE;IAC7B,wDAAwD;IACxD,iBAAiB,EAAE,yCAAyC;IAC5D,OAAO,EAAE,+BAA+B;IACxC,8CAA8C;IAC9C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7B,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE;IAC3B,0DAA0D;IAC1D,MAAM,EAAE,0BAA0B;IAClC,sGAAsG;IACtG,iBAAiB,EAAE,0BAA0B,CAAC,QAAQ,EAAE;IACxD,+DAA+D;IAC/D,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC1C,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC1C,uFAAuF;IACvF,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACnC,4EAA4E;IAC5E,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACjC,6CAA6C;IAC7C,OAAO,EAAE,iCAAiC;IAC1C,qEAAqE;IACrE,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC1C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;CACtB,CAAC,CAAC,MAAM,EAAE,CAAC;AAGZ,8EAA8E;AAC9E,mFAAmF;AACnF,4CAA4C;AAC5C,8EAA8E;AAE9E,mCAAmC;AACnC,MAAM,CAAC,MAAM,qCAAqC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC;AAGtG;;oDAEoD;AACpD,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAAC,CAAC,MAAM,CAAC;IACxD,aAAa,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,OAAO,EAAE,+BAA+B;IACxC,MAAM,EAAE,qCAAqC;IAC7C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACzC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC,MAAM,EAAE,CAAC"}