@nakafa/aksara-contracts 0.27.0

package/dist/tryout/catalog.d.ts

@@ -0,0 +1,376 @@
+import { Schema } from "effect";
+/** Current semantic catalog key accepted before its signed row is loaded. */
+export declare const TryoutCatalogNodeIdentitySchema: Schema.Union<readonly [Schema.Struct<{
+    readonly appLocale: Schema.brand<Schema.Literals<readonly ["en", "id", "de"]>, "@NakafaAI/AksaraAppLocale">;
+    readonly countryKey: Schema.String;
+    readonly kind: Schema.Literal<"country">;
+}>, Schema.Struct<{
+    readonly appLocale: Schema.brand<Schema.Literals<readonly ["en", "id", "de"]>, "@NakafaAI/AksaraAppLocale">;
+    readonly countryKey: Schema.String;
+    readonly examKey: Schema.String;
+    readonly kind: Schema.Literal<"exam">;
+}>, Schema.Struct<{
+    readonly appLocale: Schema.brand<Schema.Literals<readonly ["en", "id", "de"]>, "@NakafaAI/AksaraAppLocale">;
+    readonly countryKey: Schema.String;
+    readonly examKey: Schema.String;
+    readonly kind: Schema.Literal<"track">;
+    readonly trackKey: Schema.String;
+}>, Schema.Struct<{
+    readonly appLocale: Schema.brand<Schema.Literals<readonly ["en", "id", "de"]>, "@NakafaAI/AksaraAppLocale">;
+    readonly countryKey: Schema.String;
+    readonly examKey: Schema.String;
+    readonly kind: Schema.Literal<"set">;
+    readonly setKey: Schema.String;
+    readonly trackKey: Schema.String;
+}>, Schema.Struct<{
+    readonly appLocale: Schema.brand<Schema.Literals<readonly ["en", "id", "de"]>, "@NakafaAI/AksaraAppLocale">;
+    readonly countryKey: Schema.String;
+    readonly examKey: Schema.String;
+    readonly kind: Schema.Literal<"section">;
+    readonly sectionKey: Schema.String;
+    readonly setKey: Schema.String;
+    readonly trackKey: Schema.String;
+}>]>;
+export type TryoutCatalogNodeIdentity = typeof TryoutCatalogNodeIdentitySchema.Type;
+/** One localized country row. */
+export declare const TryoutCountrySchema: Schema.Struct<{
+    readonly appLocale: Schema.brand<Schema.Literals<readonly ["en", "id", "de"]>, "@NakafaAI/AksaraAppLocale">;
+    readonly description: Schema.optional<Schema.String>;
+    readonly graph: Schema.Struct<{
+        readonly alignmentId: Schema.String;
+        readonly assetId: Schema.String;
+        readonly conceptId: Schema.String;
+        readonly learningObjectId: Schema.String;
+        readonly lensId: Schema.String;
+    }>;
+    readonly sourceRevision: Schema.Trimmed;
+    readonly title: Schema.String;
+    readonly countryCode: Schema.String;
+    readonly countryKey: Schema.String;
+    readonly kind: Schema.Literal<"country">;
+    readonly order: Schema.Finite;
+    readonly publicPath: Schema.brand<Schema.String, "@NakafaAI/AksaraPublicPath">;
+}>;
+export type TryoutCountry = typeof TryoutCountrySchema.Type;
+/** One localized exam row. */
+export declare const TryoutExamSchema: Schema.Struct<{
+    readonly appLocale: Schema.brand<Schema.Literals<readonly ["en", "id", "de"]>, "@NakafaAI/AksaraAppLocale">;
+    readonly description: Schema.optional<Schema.String>;
+    readonly graph: Schema.Struct<{
+        readonly alignmentId: Schema.String;
+        readonly assetId: Schema.String;
+        readonly conceptId: Schema.String;
+        readonly learningObjectId: Schema.String;
+        readonly lensId: Schema.String;
+    }>;
+    readonly sourceRevision: Schema.Trimmed;
+    readonly title: Schema.String;
+    readonly countryKey: Schema.String;
+    readonly examKey: Schema.String;
+    readonly kind: Schema.Literal<"exam">;
+    readonly order: Schema.Finite;
+    readonly publicPath: Schema.brand<Schema.String, "@NakafaAI/AksaraPublicPath">;
+    readonly scoringStrategy: Schema.Literals<readonly ["irt", "raw"]>;
+}>;
+export type TryoutExam = typeof TryoutExamSchema.Type;
+/** One localized track row with exact inventory counts. */
+export declare const TryoutTrackSchema: Schema.Struct<{
+    readonly appLocale: Schema.brand<Schema.Literals<readonly ["en", "id", "de"]>, "@NakafaAI/AksaraAppLocale">;
+    readonly description: Schema.optional<Schema.String>;
+    readonly graph: Schema.Struct<{
+        readonly alignmentId: Schema.String;
+        readonly assetId: Schema.String;
+        readonly conceptId: Schema.String;
+        readonly learningObjectId: Schema.String;
+        readonly lensId: Schema.String;
+    }>;
+    readonly sourceRevision: Schema.Trimmed;
+    readonly title: Schema.String;
+    readonly countryKey: Schema.String;
+    readonly examKey: Schema.String;
+    readonly kind: Schema.Literal<"track">;
+    readonly order: Schema.Finite;
+    readonly publicPath: Schema.brand<Schema.String, "@NakafaAI/AksaraPublicPath">;
+    readonly questionCount: Schema.Finite;
+    readonly sectionCount: Schema.Finite;
+    readonly setCount: Schema.Finite;
+    readonly trackKey: Schema.String;
+    readonly trackKind: Schema.Literals<readonly ["subject", "year"]>;
+    readonly visibleSectionCount: Schema.Finite;
+}>;
+export type TryoutTrack = typeof TryoutTrackSchema.Type;
+/** One localized set row with exact inventory counts. */
+export declare const TryoutSetSchema: Schema.Struct<{
+    readonly appLocale: Schema.brand<Schema.Literals<readonly ["en", "id", "de"]>, "@NakafaAI/AksaraAppLocale">;
+    readonly description: Schema.optional<Schema.String>;
+    readonly graph: Schema.Struct<{
+        readonly alignmentId: Schema.String;
+        readonly assetId: Schema.String;
+        readonly conceptId: Schema.String;
+        readonly learningObjectId: Schema.String;
+        readonly lensId: Schema.String;
+    }>;
+    readonly sourceRevision: Schema.Trimmed;
+    readonly title: Schema.String;
+    readonly countryKey: Schema.String;
+    readonly examKey: Schema.String;
+    readonly internalEntrySectionKey: Schema.optional<Schema.String>;
+    readonly kind: Schema.Literal<"set">;
+    readonly order: Schema.Finite;
+    readonly publicPath: Schema.brand<Schema.String, "@NakafaAI/AksaraPublicPath">;
+    readonly questionCount: Schema.Finite;
+    readonly scoringStrategy: Schema.Literals<readonly ["irt", "raw"]>;
+    readonly sectionCount: Schema.Finite;
+    readonly setKey: Schema.String;
+    readonly trackKey: Schema.String;
+    readonly visibleSectionCount: Schema.Finite;
+}>;
+export type TryoutSet = typeof TryoutSetSchema.Type;
+/** One localized section row with source ownership. */
+export declare const TryoutSectionSchema: Schema.Struct<{
+    readonly appLocale: Schema.brand<Schema.Literals<readonly ["en", "id", "de"]>, "@NakafaAI/AksaraAppLocale">;
+    readonly description: Schema.optional<Schema.String>;
+    readonly graph: Schema.Struct<{
+        readonly alignmentId: Schema.String;
+        readonly assetId: Schema.String;
+        readonly conceptId: Schema.String;
+        readonly learningObjectId: Schema.String;
+        readonly lensId: Schema.String;
+    }>;
+    readonly sourceRevision: Schema.Trimmed;
+    readonly title: Schema.String;
+    readonly countryKey: Schema.String;
+    readonly examKey: Schema.String;
+    readonly kind: Schema.Literal<"section">;
+    readonly order: Schema.Finite;
+    readonly publicPath: Schema.optional<Schema.brand<Schema.String, "@NakafaAI/AksaraPublicPath">>;
+    readonly questionCount: Schema.Finite;
+    readonly questionSourcePath: Schema.brand<Schema.String, "@NakafaAI/AksaraCorpusSourcePath">;
+    readonly sectionKey: Schema.String;
+    readonly setKey: Schema.String;
+    readonly timeLimitSeconds: Schema.Finite;
+    readonly trackKey: Schema.String;
+    readonly visibility: Schema.Literals<readonly ["internal-entry", "visible"]>;
+}>;
+export type TryoutSection = typeof TryoutSectionSchema.Type;
+/** Complete hierarchy vocabulary for try-out publication. */
+export declare const TryoutCatalogRowSchema: Schema.Union<readonly [Schema.Struct<{
+    readonly appLocale: Schema.brand<Schema.Literals<readonly ["en", "id", "de"]>, "@NakafaAI/AksaraAppLocale">;
+    readonly description: Schema.optional<Schema.String>;
+    readonly graph: Schema.Struct<{
+        readonly alignmentId: Schema.String;
+        readonly assetId: Schema.String;
+        readonly conceptId: Schema.String;
+        readonly learningObjectId: Schema.String;
+        readonly lensId: Schema.String;
+    }>;
+    readonly sourceRevision: Schema.Trimmed;
+    readonly title: Schema.String;
+    readonly countryCode: Schema.String;
+    readonly countryKey: Schema.String;
+    readonly kind: Schema.Literal<"country">;
+    readonly order: Schema.Finite;
+    readonly publicPath: Schema.brand<Schema.String, "@NakafaAI/AksaraPublicPath">;
+}>, Schema.Struct<{
+    readonly appLocale: Schema.brand<Schema.Literals<readonly ["en", "id", "de"]>, "@NakafaAI/AksaraAppLocale">;
+    readonly description: Schema.optional<Schema.String>;
+    readonly graph: Schema.Struct<{
+        readonly alignmentId: Schema.String;
+        readonly assetId: Schema.String;
+        readonly conceptId: Schema.String;
+        readonly learningObjectId: Schema.String;
+        readonly lensId: Schema.String;
+    }>;
+    readonly sourceRevision: Schema.Trimmed;
+    readonly title: Schema.String;
+    readonly countryKey: Schema.String;
+    readonly examKey: Schema.String;
+    readonly kind: Schema.Literal<"exam">;
+    readonly order: Schema.Finite;
+    readonly publicPath: Schema.brand<Schema.String, "@NakafaAI/AksaraPublicPath">;
+    readonly scoringStrategy: Schema.Literals<readonly ["irt", "raw"]>;
+}>, Schema.Struct<{
+    readonly appLocale: Schema.brand<Schema.Literals<readonly ["en", "id", "de"]>, "@NakafaAI/AksaraAppLocale">;
+    readonly description: Schema.optional<Schema.String>;
+    readonly graph: Schema.Struct<{
+        readonly alignmentId: Schema.String;
+        readonly assetId: Schema.String;
+        readonly conceptId: Schema.String;
+        readonly learningObjectId: Schema.String;
+        readonly lensId: Schema.String;
+    }>;
+    readonly sourceRevision: Schema.Trimmed;
+    readonly title: Schema.String;
+    readonly countryKey: Schema.String;
+    readonly examKey: Schema.String;
+    readonly kind: Schema.Literal<"track">;
+    readonly order: Schema.Finite;
+    readonly publicPath: Schema.brand<Schema.String, "@NakafaAI/AksaraPublicPath">;
+    readonly questionCount: Schema.Finite;
+    readonly sectionCount: Schema.Finite;
+    readonly setCount: Schema.Finite;
+    readonly trackKey: Schema.String;
+    readonly trackKind: Schema.Literals<readonly ["subject", "year"]>;
+    readonly visibleSectionCount: Schema.Finite;
+}>, Schema.Struct<{
+    readonly appLocale: Schema.brand<Schema.Literals<readonly ["en", "id", "de"]>, "@NakafaAI/AksaraAppLocale">;
+    readonly description: Schema.optional<Schema.String>;
+    readonly graph: Schema.Struct<{
+        readonly alignmentId: Schema.String;
+        readonly assetId: Schema.String;
+        readonly conceptId: Schema.String;
+        readonly learningObjectId: Schema.String;
+        readonly lensId: Schema.String;
+    }>;
+    readonly sourceRevision: Schema.Trimmed;
+    readonly title: Schema.String;
+    readonly countryKey: Schema.String;
+    readonly examKey: Schema.String;
+    readonly internalEntrySectionKey: Schema.optional<Schema.String>;
+    readonly kind: Schema.Literal<"set">;
+    readonly order: Schema.Finite;
+    readonly publicPath: Schema.brand<Schema.String, "@NakafaAI/AksaraPublicPath">;
+    readonly questionCount: Schema.Finite;
+    readonly scoringStrategy: Schema.Literals<readonly ["irt", "raw"]>;
+    readonly sectionCount: Schema.Finite;
+    readonly setKey: Schema.String;
+    readonly trackKey: Schema.String;
+    readonly visibleSectionCount: Schema.Finite;
+}>, Schema.Struct<{
+    readonly appLocale: Schema.brand<Schema.Literals<readonly ["en", "id", "de"]>, "@NakafaAI/AksaraAppLocale">;
+    readonly description: Schema.optional<Schema.String>;
+    readonly graph: Schema.Struct<{
+        readonly alignmentId: Schema.String;
+        readonly assetId: Schema.String;
+        readonly conceptId: Schema.String;
+        readonly learningObjectId: Schema.String;
+        readonly lensId: Schema.String;
+    }>;
+    readonly sourceRevision: Schema.Trimmed;
+    readonly title: Schema.String;
+    readonly countryKey: Schema.String;
+    readonly examKey: Schema.String;
+    readonly kind: Schema.Literal<"section">;
+    readonly order: Schema.Finite;
+    readonly publicPath: Schema.optional<Schema.brand<Schema.String, "@NakafaAI/AksaraPublicPath">>;
+    readonly questionCount: Schema.Finite;
+    readonly questionSourcePath: Schema.brand<Schema.String, "@NakafaAI/AksaraCorpusSourcePath">;
+    readonly sectionKey: Schema.String;
+    readonly setKey: Schema.String;
+    readonly timeLimitSeconds: Schema.Finite;
+    readonly trackKey: Schema.String;
+    readonly visibility: Schema.Literals<readonly ["internal-entry", "visible"]>;
+}>]>;
+export type TryoutCatalogRow = typeof TryoutCatalogRowSchema.Type;
+/** One hierarchy row bound to its deterministic hash. */
+export declare const TryoutCatalogRecordSchema: Schema.Struct<{
+    readonly row: Schema.Union<readonly [Schema.Struct<{
+        readonly appLocale: Schema.brand<Schema.Literals<readonly ["en", "id", "de"]>, "@NakafaAI/AksaraAppLocale">;
+        readonly description: Schema.optional<Schema.String>;
+        readonly graph: Schema.Struct<{
+            readonly alignmentId: Schema.String;
+            readonly assetId: Schema.String;
+            readonly conceptId: Schema.String;
+            readonly learningObjectId: Schema.String;
+            readonly lensId: Schema.String;
+        }>;
+        readonly sourceRevision: Schema.Trimmed;
+        readonly title: Schema.String;
+        readonly countryCode: Schema.String;
+        readonly countryKey: Schema.String;
+        readonly kind: Schema.Literal<"country">;
+        readonly order: Schema.Finite;
+        readonly publicPath: Schema.brand<Schema.String, "@NakafaAI/AksaraPublicPath">;
+    }>, Schema.Struct<{
+        readonly appLocale: Schema.brand<Schema.Literals<readonly ["en", "id", "de"]>, "@NakafaAI/AksaraAppLocale">;
+        readonly description: Schema.optional<Schema.String>;
+        readonly graph: Schema.Struct<{
+            readonly alignmentId: Schema.String;
+            readonly assetId: Schema.String;
+            readonly conceptId: Schema.String;
+            readonly learningObjectId: Schema.String;
+            readonly lensId: Schema.String;
+        }>;
+        readonly sourceRevision: Schema.Trimmed;
+        readonly title: Schema.String;
+        readonly countryKey: Schema.String;
+        readonly examKey: Schema.String;
+        readonly kind: Schema.Literal<"exam">;
+        readonly order: Schema.Finite;
+        readonly publicPath: Schema.brand<Schema.String, "@NakafaAI/AksaraPublicPath">;
+        readonly scoringStrategy: Schema.Literals<readonly ["irt", "raw"]>;
+    }>, Schema.Struct<{
+        readonly appLocale: Schema.brand<Schema.Literals<readonly ["en", "id", "de"]>, "@NakafaAI/AksaraAppLocale">;
+        readonly description: Schema.optional<Schema.String>;
+        readonly graph: Schema.Struct<{
+            readonly alignmentId: Schema.String;
+            readonly assetId: Schema.String;
+            readonly conceptId: Schema.String;
+            readonly learningObjectId: Schema.String;
+            readonly lensId: Schema.String;
+        }>;
+        readonly sourceRevision: Schema.Trimmed;
+        readonly title: Schema.String;
+        readonly countryKey: Schema.String;
+        readonly examKey: Schema.String;
+        readonly kind: Schema.Literal<"track">;
+        readonly order: Schema.Finite;
+        readonly publicPath: Schema.brand<Schema.String, "@NakafaAI/AksaraPublicPath">;
+        readonly questionCount: Schema.Finite;
+        readonly sectionCount: Schema.Finite;
+        readonly setCount: Schema.Finite;
+        readonly trackKey: Schema.String;
+        readonly trackKind: Schema.Literals<readonly ["subject", "year"]>;
+        readonly visibleSectionCount: Schema.Finite;
+    }>, Schema.Struct<{
+        readonly appLocale: Schema.brand<Schema.Literals<readonly ["en", "id", "de"]>, "@NakafaAI/AksaraAppLocale">;
+        readonly description: Schema.optional<Schema.String>;
+        readonly graph: Schema.Struct<{
+            readonly alignmentId: Schema.String;
+            readonly assetId: Schema.String;
+            readonly conceptId: Schema.String;
+            readonly learningObjectId: Schema.String;
+            readonly lensId: Schema.String;
+        }>;
+        readonly sourceRevision: Schema.Trimmed;
+        readonly title: Schema.String;
+        readonly countryKey: Schema.String;
+        readonly examKey: Schema.String;
+        readonly internalEntrySectionKey: Schema.optional<Schema.String>;
+        readonly kind: Schema.Literal<"set">;
+        readonly order: Schema.Finite;
+        readonly publicPath: Schema.brand<Schema.String, "@NakafaAI/AksaraPublicPath">;
+        readonly questionCount: Schema.Finite;
+        readonly scoringStrategy: Schema.Literals<readonly ["irt", "raw"]>;
+        readonly sectionCount: Schema.Finite;
+        readonly setKey: Schema.String;
+        readonly trackKey: Schema.String;
+        readonly visibleSectionCount: Schema.Finite;
+    }>, Schema.Struct<{
+        readonly appLocale: Schema.brand<Schema.Literals<readonly ["en", "id", "de"]>, "@NakafaAI/AksaraAppLocale">;
+        readonly description: Schema.optional<Schema.String>;
+        readonly graph: Schema.Struct<{
+            readonly alignmentId: Schema.String;
+            readonly assetId: Schema.String;
+            readonly conceptId: Schema.String;
+            readonly learningObjectId: Schema.String;
+            readonly lensId: Schema.String;
+        }>;
+        readonly sourceRevision: Schema.Trimmed;
+        readonly title: Schema.String;
+        readonly countryKey: Schema.String;
+        readonly examKey: Schema.String;
+        readonly kind: Schema.Literal<"section">;
+        readonly order: Schema.Finite;
+        readonly publicPath: Schema.optional<Schema.brand<Schema.String, "@NakafaAI/AksaraPublicPath">>;
+        readonly questionCount: Schema.Finite;
+        readonly questionSourcePath: Schema.brand<Schema.String, "@NakafaAI/AksaraCorpusSourcePath">;
+        readonly sectionKey: Schema.String;
+        readonly setKey: Schema.String;
+        readonly timeLimitSeconds: Schema.Finite;
+        readonly trackKey: Schema.String;
+        readonly visibility: Schema.Literals<readonly ["internal-entry", "visible"]>;
+    }>]>;
+    readonly rowHash: Schema.brand<Schema.String, "@NakafaAI/AksaraSha256Hash">;
+}>;
+export type TryoutCatalogRecord = typeof TryoutCatalogRecordSchema.Type;

package/dist/tryout/catalog.js

@@ -0,0 +1,147 @@
+import { Schema } from "effect";
+import { CountryCodeSchema } from "#contracts/country";
+import { LearningGraphIdentitySchema } from "#contracts/graph/spec";
+import { CorpusSourcePathSchema, PublicPathSchema, Sha256HashSchema, } from "#contracts/ids";
+import { AppLocaleSchema } from "#contracts/locale";
+import { TryoutKeySchema } from "#contracts/tryout/key";
+import { TryoutScoringSchema, TryoutSourceRevisionSchema, TryoutTrackKindSchema, TryoutVisibilitySchema, } from "#contracts/tryout/spec";
+const PositiveCountSchema = Schema.Finite.pipe(Schema.check(Schema.isInt()), Schema.check(Schema.isGreaterThan(0)));
+const NonNegativeCountSchema = Schema.Finite.pipe(Schema.check(Schema.isInt()), Schema.check(Schema.isGreaterThanOrEqualTo(0)));
+const LocalizedFields = {
+    appLocale: AppLocaleSchema,
+    description: Schema.optional(Schema.String),
+    graph: LearningGraphIdentitySchema,
+    sourceRevision: TryoutSourceRevisionSchema,
+    title: Schema.String,
+};
+const ParentFields = {
+    countryKey: TryoutKeySchema,
+    examKey: TryoutKeySchema,
+};
+const CatalogNodeFields = {
+    appLocale: AppLocaleSchema,
+    countryKey: TryoutKeySchema,
+};
+/** Minimal country identity used to retrieve its complete signed row. */
+const TryoutCountryIdentitySchema = Schema.Struct({
+    ...CatalogNodeFields,
+    kind: Schema.Literal("country"),
+});
+/** Minimal exam identity used to retrieve its complete signed row. */
+const TryoutExamIdentitySchema = Schema.Struct({
+    ...CatalogNodeFields,
+    examKey: TryoutKeySchema,
+    kind: Schema.Literal("exam"),
+});
+/** Minimal track identity used to retrieve its complete signed row. */
+const TryoutTrackIdentitySchema = Schema.Struct({
+    ...CatalogNodeFields,
+    examKey: TryoutKeySchema,
+    kind: Schema.Literal("track"),
+    trackKey: TryoutKeySchema,
+});
+/** Minimal set identity used to retrieve its complete signed row. */
+const TryoutSetIdentitySchema = Schema.Struct({
+    ...CatalogNodeFields,
+    examKey: TryoutKeySchema,
+    kind: Schema.Literal("set"),
+    setKey: TryoutKeySchema,
+    trackKey: TryoutKeySchema,
+});
+/** Minimal section identity used to retrieve its complete signed row. */
+const TryoutSectionIdentitySchema = Schema.Struct({
+    ...CatalogNodeFields,
+    examKey: TryoutKeySchema,
+    kind: Schema.Literal("section"),
+    sectionKey: TryoutKeySchema,
+    setKey: TryoutKeySchema,
+    trackKey: TryoutKeySchema,
+});
+/** Current semantic catalog key accepted before its signed row is loaded. */
+export const TryoutCatalogNodeIdentitySchema = Schema.Union([
+    TryoutCountryIdentitySchema,
+    TryoutExamIdentitySchema,
+    TryoutTrackIdentitySchema,
+    TryoutSetIdentitySchema,
+    TryoutSectionIdentitySchema,
+]);
+/** One localized country row. */
+export const TryoutCountrySchema = Schema.Struct({
+    ...LocalizedFields,
+    countryCode: CountryCodeSchema,
+    countryKey: TryoutKeySchema,
+    kind: Schema.Literal("country"),
+    order: PositiveCountSchema,
+    publicPath: PublicPathSchema,
+});
+/** One localized exam row. */
+export const TryoutExamSchema = Schema.Struct({
+    ...LocalizedFields,
+    countryKey: TryoutKeySchema,
+    examKey: TryoutKeySchema,
+    kind: Schema.Literal("exam"),
+    order: PositiveCountSchema,
+    publicPath: PublicPathSchema,
+    scoringStrategy: TryoutScoringSchema,
+});
+/** One localized track row with exact inventory counts. */
+export const TryoutTrackSchema = Schema.Struct({
+    ...LocalizedFields,
+    ...ParentFields,
+    kind: Schema.Literal("track"),
+    order: PositiveCountSchema,
+    publicPath: PublicPathSchema,
+    questionCount: PositiveCountSchema,
+    sectionCount: PositiveCountSchema,
+    setCount: PositiveCountSchema,
+    trackKey: TryoutKeySchema,
+    trackKind: TryoutTrackKindSchema,
+    visibleSectionCount: NonNegativeCountSchema,
+}).pipe(Schema.check(Schema.makeFilter(({ sectionCount, visibleSectionCount }) => visibleSectionCount <= sectionCount, { message: "Visible track sections cannot exceed all sections." })));
+/** One localized set row with exact inventory counts. */
+export const TryoutSetSchema = Schema.Struct({
+    ...LocalizedFields,
+    ...ParentFields,
+    internalEntrySectionKey: Schema.optional(TryoutKeySchema),
+    kind: Schema.Literal("set"),
+    order: PositiveCountSchema,
+    publicPath: PublicPathSchema,
+    questionCount: PositiveCountSchema,
+    scoringStrategy: TryoutScoringSchema,
+    sectionCount: PositiveCountSchema,
+    setKey: TryoutKeySchema,
+    trackKey: TryoutKeySchema,
+    visibleSectionCount: NonNegativeCountSchema,
+}).pipe(Schema.check(Schema.makeFilter(({ internalEntrySectionKey, sectionCount, visibleSectionCount }) => internalEntrySectionKey === undefined
+    ? visibleSectionCount === sectionCount
+    : sectionCount === 1 && visibleSectionCount === 0, { message: "Set section counts do not match their visibility." })));
+/** One localized section row with source ownership. */
+export const TryoutSectionSchema = Schema.Struct({
+    ...LocalizedFields,
+    ...ParentFields,
+    kind: Schema.Literal("section"),
+    order: PositiveCountSchema,
+    publicPath: Schema.optional(PublicPathSchema),
+    questionCount: PositiveCountSchema,
+    questionSourcePath: CorpusSourcePathSchema,
+    sectionKey: TryoutKeySchema,
+    setKey: TryoutKeySchema,
+    timeLimitSeconds: PositiveCountSchema,
+    trackKey: TryoutKeySchema,
+    visibility: TryoutVisibilitySchema,
+}).pipe(Schema.check(Schema.makeFilter(({ publicPath, visibility }) => visibility === "visible"
+    ? publicPath !== undefined
+    : publicPath === undefined, { message: "Section visibility does not match its public path." })));
+/** Complete hierarchy vocabulary for try-out publication. */
+export const TryoutCatalogRowSchema = Schema.Union([
+    TryoutCountrySchema,
+    TryoutExamSchema,
+    TryoutTrackSchema,
+    TryoutSetSchema,
+    TryoutSectionSchema,
+]);
+/** One hierarchy row bound to its deterministic hash. */
+export const TryoutCatalogRecordSchema = Schema.Struct({
+    row: TryoutCatalogRowSchema,
+    rowHash: Sha256HashSchema,
+});

package/dist/tryout/content-hash.d.ts

@@ -0,0 +1,89 @@
+import { Schema } from "effect";
+/** Exact authored facts that define one app and delivery-language question. */
+export declare const TryoutContentInputSchema: Schema.Struct<{
+    readonly dateModified: Schema.optionalKey<Schema.String>;
+    readonly datePublished: Schema.String;
+    readonly answerArtifactLocale: Schema.brand<Schema.Literals<readonly ["en", "id", "de"]>, "@NakafaAI/AksaraArtifactLocale">;
+    readonly answerBody: Schema.String;
+    readonly appLocale: Schema.brand<Schema.Literals<readonly ["en", "id", "de"]>, "@NakafaAI/AksaraAppLocale">;
+    readonly blueprint: Schema.optionalKey<Schema.Struct<{
+        readonly cognitiveLevel: Schema.String;
+        readonly contentDomain: Schema.String;
+        readonly topic: Schema.String;
+    }>>;
+    readonly deliveryLanguage: Schema.brand<Schema.Literals<readonly ["en", "id", "de"]>, "@NakafaAI/AksaraDeliveryLanguage">;
+    readonly languagePolicy: Schema.Union<readonly [Schema.Struct<{
+        readonly kind: Schema.Literal<"app-locale">;
+    }>, Schema.Struct<{
+        readonly kind: Schema.Literal<"fixed">;
+        readonly language: Schema.brand<Schema.Literals<readonly ["en", "id", "de"]>, "@NakafaAI/AksaraDeliveryLanguage">;
+    }>]>;
+    readonly questionArtifactLocale: Schema.brand<Schema.Literals<readonly ["en", "id", "de"]>, "@NakafaAI/AksaraArtifactLocale">;
+    readonly questionBody: Schema.String;
+    readonly response: Schema.Union<readonly [Schema.Struct<{
+        readonly categories: Schema.$Array<Schema.Struct<{
+            readonly categoryKey: Schema.String;
+            readonly label: Schema.NonEmptyArray<Schema.Union<readonly [Schema.Struct<{
+                readonly display: Schema.Literals<readonly ["block", "inline"]>;
+                readonly kind: Schema.Literal<"math">;
+                readonly math: Schema.String;
+            }>, Schema.Struct<{
+                readonly kind: Schema.Literal<"text">;
+                readonly text: Schema.String;
+            }>]>>;
+            readonly order: Schema.Int;
+        }>>;
+        readonly kind: Schema.Literal<"category">;
+        readonly statements: Schema.$Array<Schema.Struct<{
+            readonly correctCategoryKey: Schema.String;
+            readonly label: Schema.NonEmptyArray<Schema.Union<readonly [Schema.Struct<{
+                readonly display: Schema.Literals<readonly ["block", "inline"]>;
+                readonly kind: Schema.Literal<"math">;
+                readonly math: Schema.String;
+            }>, Schema.Struct<{
+                readonly kind: Schema.Literal<"text">;
+                readonly text: Schema.String;
+            }>]>>;
+            readonly order: Schema.Int;
+            readonly statementKey: Schema.String;
+        }>>;
+    }>, Schema.Struct<{
+        readonly kind: Schema.Literal<"multiple-choice">;
+        readonly options: Schema.$Array<Schema.Struct<{
+            readonly isCorrect: Schema.Boolean;
+            readonly label: Schema.NonEmptyArray<Schema.Union<readonly [Schema.Struct<{
+                readonly display: Schema.Literals<readonly ["block", "inline"]>;
+                readonly kind: Schema.Literal<"math">;
+                readonly math: Schema.String;
+            }>, Schema.Struct<{
+                readonly kind: Schema.Literal<"text">;
+                readonly text: Schema.String;
+            }>]>>;
+            readonly optionKey: Schema.String;
+            readonly order: Schema.Int;
+        }>>;
+    }>, Schema.Struct<{
+        readonly kind: Schema.Literal<"single-choice">;
+        readonly options: Schema.$Array<Schema.Struct<{
+            readonly isCorrect: Schema.Boolean;
+            readonly label: Schema.NonEmptyArray<Schema.Union<readonly [Schema.Struct<{
+                readonly display: Schema.Literals<readonly ["block", "inline"]>;
+                readonly kind: Schema.Literal<"math">;
+                readonly math: Schema.String;
+            }>, Schema.Struct<{
+                readonly kind: Schema.Literal<"text">;
+                readonly text: Schema.String;
+            }>]>>;
+            readonly optionKey: Schema.String;
+            readonly order: Schema.Int;
+        }>>;
+    }>]>;
+    readonly sourcePath: Schema.brand<Schema.String, "@NakafaAI/AksaraQuestionKey">;
+    readonly sourceRevision: Schema.Trimmed;
+    readonly stimulusKey: Schema.optionalKey<Schema.String>;
+}>;
+export type TryoutContentInput = typeof TryoutContentInputSchema.Type;
+/** Serializes every current question-pair identity field in stable order. */
+export declare function canonicalizeTryoutContent(input: TryoutContentInput): string;
+/** Hashes one complete current question pair through its canonical identity. */
+export declare function hashTryoutContent(input: TryoutContentInput): string & import("effect/Brand").Brand<"@NakafaAI/AksaraTryoutContentHash">;