@crowdedkingdoms/crowdyjs 17.14.0-dev.1 → 18.0.0-dev.1

package/dist/kit/blueprints/loot.js

@@ -1,229 +0,0 @@
-import { kitPolicyJson, ownerEqualsCaller, ownerMirrorProperty, toSnakeCase, trustedAuthorityFields, } from './core.js';
-/** Compute the type/function names a loot blueprint (and its runtime helper) uses. */
-export function lootNames(typePrefix = '') {
-    const fnPrefix = typePrefix ? `${toSnakeCase(typePrefix)}_` : '';
-    return {
-        rollType: `${typePrefix}LootRoll`,
-        claimFn: `${fnPrefix}claim_roll`,
-        fnPrefix,
-    };
-}
-/** The roll function name for one table. */
-export function lootRollFn(tableId, typePrefix = '') {
-    const fnPrefix = typePrefix ? `${toSnakeCase(typePrefix)}_` : '';
-    return `${fnPrefix}roll_${toSnakeCase(tableId)}`;
-}
-/** Format a probability threshold as an expression float literal. */
-function floatLiteral(n) {
-    const s = String(n);
-    return s.includes('.') || s.includes('e') ? s : `${s}.0`;
-}
-/**
- * Unroll a weighted table into a nested-if chain over the stored roll seed:
- * `if(self.seed < t1, "a", if(self.seed < t2, "b", "c"))` with cumulative
- * normalized thresholds. Expressions are loop-free, so the selection chain
- * is generated at BUILD time — one `rand()` is stored first and every branch
- * reads that same seed, keeping the distribution exact.
- */
-function unrollItemChain(entries) {
-    const total = entries.reduce((sum, e) => sum + e.weight, 0);
-    let expr = JSON.stringify(entries[entries.length - 1].itemId);
-    for (let i = entries.length - 2; i >= 0; i--) {
-        // Threshold below which entries[0..i] win; nested back-to-front.
-        const cumulative = entries.slice(0, i + 1).reduce((sum, e) => sum + e.weight, 0);
-        expr = `if(self.seed < ${floatLiteral(cumulative / total)}, ${JSON.stringify(entries[i].itemId)}, ${expr})`;
-    }
-    return expr;
-}
-/** Unroll the per-item quantity chain, keyed on the already-rolled item id. */
-function unrollQtyChain(entries) {
-    const qtyExpr = (e) => {
-        const min = e.minQty ?? 1;
-        const max = e.maxQty ?? min;
-        return max > min ? `rand_int(${min}, ${max})` : String(min);
-    };
-    let expr = qtyExpr(entries[entries.length - 1]);
-    for (let i = entries.length - 2; i >= 0; i--) {
-        expr = `if(self.rolled_item_id == ${JSON.stringify(entries[i].itemId)}, ${qtyExpr(entries[i])}, ${expr})`;
-    }
-    return expr;
-}
-/**
- * Blueprint for **loot tables & drops**: weighted tables are unrolled into
- * pure expressions at blueprint-build time (the expression language is
- * loop-free), rolled server-side into durable `LootRoll` containers, and
- * claimed atomically into an item stack. Covers chest rolls, mob drops, and
- * gacha pulls.
- *
- * Flow: create a `LootRoll` (member) for a table → `roll_<table>` (trusted:
- * server scope by default, or an event automation via `drops`) stores a
- * single `rand()` seed and resolves item + quantity from it in one
- * transaction → the owner claims with `claim_roll`, which marks the roll
- * claimed AND grants the stack in the same invoke (no double-claim, no
- * client-chosen rewards).
- *
- * Runtime counterpart: `client.kit(appId).loot`.
- */
-export function lootBlueprint(options) {
-    const { typePrefix = '', tables, rollAuthority = 'server', drops = [], ownerIdKind: kind = 'int', } = options;
-    if (!tables.length) {
-        throw new Error('lootBlueprint requires at least one table');
-    }
-    for (const table of tables) {
-        if (table.entries.length < 1 || table.entries.length > 16) {
-            throw new Error(`lootBlueprint table '${table.tableId}' must have 1-16 entries (parser-limit-aware unrolling)`);
-        }
-        if (table.entries.some((e) => !(e.weight > 0))) {
-            throw new Error(`lootBlueprint table '${table.tableId}' entries must have weight > 0`);
-        }
-    }
-    const tableIds = new Set(tables.map((t) => t.tableId));
-    for (const drop of drops) {
-        if (!tableIds.has(drop.tableId)) {
-            throw new Error(`lootBlueprint drop '${drop.name}' references unknown table '${drop.tableId}'`);
-        }
-    }
-    const names = lootNames(typePrefix);
-    const droppedTables = new Set(drops.map((d) => d.tableId));
-    const propertyDefinitions = [
-        ownerMirrorProperty(names.rollType, kind),
-        {
-            containerTypeName: names.rollType,
-            key: 'table_id',
-            valueType: 'string',
-            defaultValueJson: '""',
-            description: 'The loot table this roll draws from.',
-        },
-        {
-            containerTypeName: names.rollType,
-            key: 'seed',
-            valueType: 'float',
-            defaultValueJson: '0',
-            description: 'The stored rand() seed the weighted selection reads (audit-friendly).',
-        },
-        {
-            containerTypeName: names.rollType,
-            key: 'rolled_item_id',
-            valueType: 'string',
-            defaultValueJson: '""',
-            description: 'The rolled item (empty until rolled; a roll cannot re-roll).',
-        },
-        {
-            containerTypeName: names.rollType,
-            key: 'rolled_qty',
-            valueType: 'int',
-            defaultValueJson: '0',
-            description: 'The rolled quantity.',
-        },
-        {
-            containerTypeName: names.rollType,
-            key: 'claimed',
-            valueType: 'bool',
-            defaultValueJson: 'false',
-            description: 'True once claimed into a stack (single-claim guard).',
-        },
-    ];
-    const functions = tables.map((table) => {
-        const auth = trustedAuthorityFields(rollAuthority, `self.table_id == ${JSON.stringify(table.tableId)} && self.rolled_item_id == ""`);
-        return {
-            name: lootRollFn(table.tableId, typePrefix),
-            containerTypeName: names.rollType,
-            returnType: 'string',
-            mutations: [
-                { target: 'self', property: 'seed', expression: 'rand()' },
-                {
-                    target: 'self',
-                    property: 'rolled_item_id',
-                    expression: unrollItemChain(table.entries),
-                },
-                {
-                    target: 'self',
-                    property: 'rolled_qty',
-                    expression: unrollQtyChain(table.entries),
-                },
-            ],
-            returnExpression: 'self.rolled_item_id',
-            ...auth,
-            ...(droppedTables.has(table.tableId) ? { autonomousInvocable: true } : {}),
-            description: `Roll the '${table.tableId}' loot table: stores one rand() seed, then resolves item and quantity from it in one transaction (unrolled weighted selection).`,
-        };
-    });
-    functions.push({
-        name: names.claimFn,
-        containerTypeName: names.rollType,
-        returnType: 'int',
-        parameters: [
-            {
-                name: 'to_stack_id',
-                valueType: 'container_ref',
-                required: true,
-                description: "A caller-owned stack of the rolled item that receives the quantity.",
-            },
-        ],
-        mutations: [
-            { target: 'self', property: 'claimed', expression: 'true' },
-            {
-                target: 'ref($to_stack_id)',
-                property: 'quantity',
-                expression: 'ref($to_stack_id).quantity + self.rolled_qty',
-            },
-        ],
-        returnExpression: 'self.rolled_qty',
-        invokePolicyJson: kitPolicyJson({
-            type: 'condition',
-            expression: [
-                ownerEqualsCaller('self.owner_user_id', kind),
-                'not(self.claimed)',
-                'self.rolled_item_id != ""',
-                'ref($to_stack_id).item_id == self.rolled_item_id',
-                ownerEqualsCaller('ref($to_stack_id).owner_user_id', kind),
-            ].join(' && '),
-        }),
-        description: 'Claim a rolled loot into a stack: the claimed flag and the grant commit atomically, so a roll can never be claimed twice.',
-    });
-    const automations = [];
-    const automationTriggers = [];
-    for (const drop of drops) {
-        automations.push({
-            name: drop.name,
-            functionName: lootRollFn(drop.tableId, typePrefix),
-            targetMode: 'type',
-            targetTypeName: names.rollType,
-            triggerType: 'event',
-            maxTargets: drop.maxTargets ?? 1,
-            selectorJson: JSON.stringify({
-                selfWhere: [
-                    { key: 'table_id', op: '==', value: drop.tableId },
-                    { key: 'rolled_item_id', op: '==', value: '' },
-                ],
-                pick: 'random',
-            }),
-            description: `Event-triggered '${drop.tableId}' drop: rolls a pooled unrolled LootRoll when the event fires.`,
-        });
-        automationTriggers.push({
-            automationName: drop.name,
-            onEvent: drop.onEvent,
-            ...(drop.functionName !== undefined ? { functionName: drop.functionName } : {}),
-            ...(drop.containerTypeName !== undefined
-                ? { containerTypeName: drop.containerTypeName }
-                : {}),
-            ...(drop.propertyKey !== undefined ? { propertyKey: drop.propertyKey } : {}),
-            ...(drop.writeSource !== undefined ? { writeSource: drop.writeSource } : {}),
-            ...(drop.debounceMs !== undefined ? { debounceMs: drop.debounceMs } : {}),
-        });
-    }
-    return {
-        name: names.rollType,
-        containerTypes: [
-            {
-                typeName: names.rollType,
-                displayName: names.rollType,
-                instantiableBy: 'member',
-                description: 'One durable loot roll: seeded, resolved, and claimed entirely server-side.',
-            },
-        ],
-        propertyDefinitions,
-        functions,
-        ...(automations.length ? { automations, automationTriggers } : {}),
-    };
-}

package/dist/kit/blueprints/matches.d.ts

@@ -1,84 +0,0 @@
-import { type KitBlueprint, type KitOwnerIdKind, type KitTrustedAuthority } from './core.js';
-/** Options for {@link matchesBlueprint}. */
-export interface MatchesBlueprintOptions {
-    /** Prefix for the type/function names. Defaults to none. */
-    typePrefix?: string;
-    /**
-     * Who may submit points to a `Score` row. Defaults to `'host'` (the
-     * elected host referees); use `'server'` or `'automation'` for
-     * server-refereed modes. Never plain players.
-     */
-    scoreAuthority?: KitTrustedAuthority;
-    /**
-     * When set, gives each turn a real wall-clock deadline. `begin_turn` bumps
-     * `turn_seq` and arms a one-shot timer — deduped per match, so arming the
-     * next turn replaces the previous deadline — that invokes `expire_turn`
-     * after `delayMs`. `expire_turn` records `turn_expired_seq` and pings the
-     * match channel, so the current turn is out of time exactly when
-     * `turn_expired_seq >= turn_seq`.
-     *
-     * That comparison is also the stale-fire guard: a timer already claimed
-     * when the player beat the clock fires against an older `turn_seq`, writes
-     * a lower `turn_expired_seq`, and can never satisfy it.
-     *
-     * Prefer this to {@link turnTick} — one timer per active match beats
-     * re-scanning every match on an interval, and the deadline is exact rather
-     * than rounded to the tick.
-     */
-    turnTimer?: {
-        delayMs: number;
-    };
-    /**
-     * Adds a `turn_tick` interval automation that increments each active
-     * match's `tick_count`, so turn logic can compare
-     * `tick_count - turn_started_tick >= N`.
-     *
-     * @deprecated Counters were a workaround for expressions having no
-     * `now()`; one-shot timers made that unnecessary. Use {@link turnTimer},
-     * which gives an exact deadline and arms work per match instead of
-     * scanning all of them every interval. Still honoured, and slated for
-     * removal in the next major.
-     */
-    turnTick?: {
-        intervalMs: number;
-    };
-    /** Owner-mirror typing (see the kit convention). Defaults to `'int'`. */
-    ownerIdKind?: KitOwnerIdKind;
-}
-/** Names derived by {@link matchesBlueprint} for a given prefix. */
-export interface MatchesNames {
-    metaType: string;
-    scoreType: string;
-    startFn: string;
-    advanceRoundFn: string;
-    scoreFn: string;
-    endFn: string;
-    beginTurnFn: string;
-    expireTurnFn: string;
-    turnTickFn: string;
-    turnTickAutomation: string;
-}
-/** Compute the type/function names a matches blueprint (and its runtime helper) uses. */
-export declare function matchesNames(typePrefix?: string): MatchesNames;
-/**
- * Blueprint for **matches** (lobbies, rounds, turns, scoring) — the
- * session-layer wrapper every session game needs. Sessions ARE the match
- * primitive (participants + current turn); this adds a session-scoped
- * `MatchMeta` (lobby state, round, winner, notification channel) and
- * per-player `Score` rows.
- *
- * Lifecycle functions (`start_match` / `advance_round` / `end_match`) are
- * creator-or-host gated and declare a **channel notification** — Buddy pings
- * every channel member post-commit with `"match_changed"`, and clients
- * re-pull the meta (the notify-to-pull pattern; `kit.matches.onMatchChanged`
- * wraps the subscription). Turn order itself uses the platform's
- * `gameModelSetSessionTurn` (the runtime helper calls it — turn authority is
- * enforced by the service, not an expression).
- *
- * End-of-match hooks: attach an event automation to `end_match`
- * (`function_invoked`) to submit leaderboard scores or adjust ratings.
- *
- * Runtime counterpart: `client.kit(appId).matches`.
- */
-export declare function matchesBlueprint(options?: MatchesBlueprintOptions): KitBlueprint;
-//# sourceMappingURL=matches.d.ts.map

package/dist/kit/blueprints/matches.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"matches.d.ts","sourceRoot":"","sources":["../../../src/kit/blueprints/matches.ts"],"names":[],"mappings":"AAMA,OAAO,EAML,KAAK,YAAY,EAEjB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACzB,MAAM,WAAW,CAAC;AAEnB,4CAA4C;AAC5C,MAAM,WAAW,uBAAuB;IACtC,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,cAAc,CAAC,EAAE,mBAAmB,CAAC;IACrC;;;;;;;;;;;;;;;OAeG;IACH,SAAS,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAChC;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,EAAE;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAClC,yEAAyE;IACzE,WAAW,CAAC,EAAE,cAAc,CAAC;CAC9B;AAED,oEAAoE;AACpE,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,yFAAyF;AACzF,wBAAgB,YAAY,CAAC,UAAU,SAAK,GAAG,YAAY,CAc1D;AA4BD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,uBAA4B,GAAG,YAAY,CAuTpF"}

package/dist/kit/blueprints/matches.js

@@ -1,349 +0,0 @@
-import { kitPolicyJson, ownerMirrorProperty, toSnakeCase, trustedAuthorityFields, } from './core.js';
-/** Compute the type/function names a matches blueprint (and its runtime helper) uses. */
-export function matchesNames(typePrefix = '') {
-    const fnPrefix = typePrefix ? `${toSnakeCase(typePrefix)}_` : '';
-    return {
-        metaType: `${typePrefix}MatchMeta`,
-        scoreType: `${typePrefix}Score`,
-        startFn: `${fnPrefix}start_match`,
-        advanceRoundFn: `${fnPrefix}advance_round`,
-        scoreFn: `${fnPrefix}score_points`,
-        endFn: `${fnPrefix}end_match`,
-        beginTurnFn: `${fnPrefix}begin_turn`,
-        expireTurnFn: `${fnPrefix}expire_turn`,
-        turnTickFn: `${fnPrefix}turn_tick`,
-        turnTickAutomation: `${fnPrefix.replace(/_/g, '-')}match-turn-tick`,
-    };
-}
-/** The channel ping every lifecycle function emits post-commit (notify-to-pull). */
-function matchChangedNotification() {
-    return {
-        kind: 'channel',
-        args: [
-            { name: 'channel_id', expression: 'self.channel_id' },
-            { name: 'payload', expression: '"match_changed"' },
-        ],
-    };
-}
-/**
- * The one-shot deadline a turn arms for itself. Deduped per match container,
- * so opening the next turn replaces the pending deadline rather than stacking
- * another one; the seq travels as a parameter so the fire can tell whether the
- * turn it was armed for is still open.
- */
-function turnDeadlineTimer(names, delayMs) {
-    return {
-        functionName: names.expireTurnFn,
-        delayMsExpression: String(delayMs),
-        dedupeKeyExpression: 'concat("match_turn:", $self_container_id)',
-        params: [{ name: 'turn_seq', expression: 'self.turn_seq' }],
-    };
-}
-/**
- * Blueprint for **matches** (lobbies, rounds, turns, scoring) — the
- * session-layer wrapper every session game needs. Sessions ARE the match
- * primitive (participants + current turn); this adds a session-scoped
- * `MatchMeta` (lobby state, round, winner, notification channel) and
- * per-player `Score` rows.
- *
- * Lifecycle functions (`start_match` / `advance_round` / `end_match`) are
- * creator-or-host gated and declare a **channel notification** — Buddy pings
- * every channel member post-commit with `"match_changed"`, and clients
- * re-pull the meta (the notify-to-pull pattern; `kit.matches.onMatchChanged`
- * wraps the subscription). Turn order itself uses the platform's
- * `gameModelSetSessionTurn` (the runtime helper calls it — turn authority is
- * enforced by the service, not an expression).
- *
- * End-of-match hooks: attach an event automation to `end_match`
- * (`function_invoked`) to submit leaderboard scores or adjust ratings.
- *
- * Runtime counterpart: `client.kit(appId).matches`.
- */
-export function matchesBlueprint(options = {}) {
-    const { typePrefix = '', scoreAuthority = 'host', turnTimer, turnTick, ownerIdKind: kind = 'int', } = options;
-    const names = matchesNames(typePrefix);
-    const creatorOrHost = (stateCondition) => {
-        const rules = [
-            {
-                type: 'or',
-                rules: [
-                    { type: 'is_host' },
-                    { type: 'condition', expression: 'self.creator_user_id == $caller_user_id' },
-                ],
-            },
-            { type: 'condition', expression: stateCondition },
-        ];
-        return kitPolicyJson({ type: 'and', rules });
-    };
-    const propertyDefinitions = [
-        {
-            containerTypeName: names.metaType,
-            key: 'creator_user_id',
-            valueType: 'int',
-            defaultValueJson: '0',
-            description: 'The user who created the match (may start/advance/end it).',
-        },
-        {
-            containerTypeName: names.metaType,
-            key: 'mode',
-            valueType: 'string',
-            defaultValueJson: '""',
-            description: "App-defined mode label (e.g. 'ranked', 'ffa').",
-        },
-        {
-            containerTypeName: names.metaType,
-            key: 'state',
-            valueType: 'string',
-            defaultValueJson: '"lobby"',
-            description: "Match lifecycle: 'lobby' | 'active' | 'finished'.",
-        },
-        {
-            containerTypeName: names.metaType,
-            key: 'round',
-            valueType: 'int',
-            defaultValueJson: '0',
-            description: 'Current round (0 in the lobby).',
-        },
-        {
-            containerTypeName: names.metaType,
-            key: 'max_players',
-            valueType: 'int',
-            defaultValueJson: '0',
-            description: 'Advertised player cap (0 = unlimited).',
-        },
-        {
-            containerTypeName: names.metaType,
-            key: 'winner_user_id',
-            valueType: 'int',
-            defaultValueJson: '0',
-            description: 'Set by end_match (0 while unresolved).',
-        },
-        {
-            containerTypeName: names.metaType,
-            key: 'channel_id',
-            valueType: 'int',
-            defaultValueJson: '0',
-            description: 'The per-match channel lifecycle notifications ping (notify-to-pull).',
-        },
-        ...(turnTimer
-            ? [
-                {
-                    containerTypeName: names.metaType,
-                    key: 'turn_seq',
-                    valueType: 'int',
-                    defaultValueJson: '0',
-                    description: 'Monotonic turn counter bumped by begin_turn; each turn arms a deadline tagged with this value.',
-                },
-                {
-                    containerTypeName: names.metaType,
-                    key: 'turn_expired_seq',
-                    valueType: 'int',
-                    defaultValueJson: '0',
-                    description: 'Highest turn_seq whose deadline elapsed. The turn is out of time iff turn_expired_seq >= turn_seq.',
-                },
-            ]
-            : []),
-        ...(turnTick
-            ? [
-                {
-                    containerTypeName: names.metaType,
-                    key: 'tick_count',
-                    valueType: 'int',
-                    defaultValueJson: '0',
-                    description: 'Monotonic counter bumped by the turn-tick automation (the wall-clock-free timer).',
-                },
-            ]
-            : []),
-        ownerMirrorProperty(names.scoreType, kind),
-        {
-            containerTypeName: names.scoreType,
-            key: 'points',
-            valueType: 'int',
-            defaultValueJson: '0',
-            description: "One player's score in the match.",
-        },
-    ];
-    // expire_turn is declared before anything arms it, so the seed resolves the
-    // timer target in one pass instead of warning about a forward reference.
-    const expireTurnFunction = turnTimer
-        ? [
-            {
-                name: names.expireTurnFn,
-                containerTypeName: names.metaType,
-                returnType: 'int',
-                parameters: [
-                    {
-                        name: 'turn_seq',
-                        valueType: 'int',
-                        required: true,
-                        description: 'The turn this deadline was armed for.',
-                    },
-                ],
-                mutations: [
-                    {
-                        target: 'self',
-                        property: 'turn_expired_seq',
-                        expression: 'max(self.turn_expired_seq, $turn_seq)',
-                    },
-                ],
-                returnExpression: 'self.turn_expired_seq',
-                invokePolicyJson: kitPolicyJson({ type: 'is_automation' }),
-                autonomousInvocable: true,
-                notifications: [matchChangedNotification()],
-                description: 'Fired by the turn deadline: record that turn $turn_seq ran out and ping the match channel. max() keeps turn_expired_seq monotonic, so a deadline that was already claimed when the player beat the clock lands below turn_seq and is ignored.',
-            },
-        ]
-        : [];
-    const functions = [
-        ...expireTurnFunction,
-        {
-            name: names.startFn,
-            containerTypeName: names.metaType,
-            returnType: 'string',
-            mutations: [
-                { target: 'self', property: 'state', expression: '"active"' },
-                { target: 'self', property: 'round', expression: '1' },
-                ...(turnTimer
-                    ? [{ target: 'self', property: 'turn_seq', expression: '1' }]
-                    : []),
-            ],
-            returnExpression: 'self.state',
-            ...(turnTimer ? { timers: [turnDeadlineTimer(names, turnTimer.delayMs)] } : {}),
-            invokePolicyJson: creatorOrHost('self.state == "lobby"'),
-            notifications: [matchChangedNotification()],
-            description: turnTimer
-                ? 'Start the match (creator or host): lobby → active, round 1, and arm the first turn’s deadline; pings the match channel post-commit.'
-                : 'Start the match (creator or host): lobby → active, round 1; pings the match channel post-commit.',
-        },
-        {
-            name: names.advanceRoundFn,
-            containerTypeName: names.metaType,
-            returnType: 'int',
-            mutations: [{ target: 'self', property: 'round', expression: 'self.round + 1' }],
-            returnExpression: 'self.round',
-            invokePolicyJson: creatorOrHost('self.state == "active"'),
-            notifications: [matchChangedNotification()],
-            description: 'Advance to the next round (creator or host); pings the match channel post-commit.',
-        },
-        {
-            name: names.endFn,
-            containerTypeName: names.metaType,
-            returnType: 'string',
-            parameters: [
-                {
-                    name: 'winner_user_id',
-                    valueType: 'int',
-                    required: true,
-                    description: 'The winning user (0 for a draw).',
-                },
-            ],
-            mutations: [
-                { target: 'self', property: 'state', expression: '"finished"' },
-                { target: 'self', property: 'winner_user_id', expression: '$winner_user_id' },
-                // Advancing the seq strands any deadline still pending: it was armed
-                // for the previous turn, so its write can no longer reach turn_seq and
-                // a finished match never reads as out of time.
-                ...(turnTimer
-                    ? [{ target: 'self', property: 'turn_seq', expression: 'self.turn_seq + 1' }]
-                    : []),
-            ],
-            returnExpression: 'self.state',
-            invokePolicyJson: creatorOrHost('self.state == "active"'),
-            notifications: [matchChangedNotification()],
-            description: 'Finish the match and record the winner (creator or host); attach an event automation to this function for rating/leaderboard hooks.',
-        },
-        {
-            name: names.scoreFn,
-            containerTypeName: names.scoreType,
-            returnType: 'int',
-            parameters: [
-                {
-                    name: 'points',
-                    valueType: 'int',
-                    required: true,
-                    description: 'Signed points to add.',
-                },
-            ],
-            mutations: [
-                { target: 'self', property: 'points', expression: 'self.points + $points' },
-            ],
-            returnExpression: 'self.points',
-            ...trustedAuthorityFields(scoreAuthority),
-            description: "Add points to a player's Score row — trusted (host-refereed by default).",
-        },
-    ];
-    if (turnTimer) {
-        functions.push({
-            name: names.beginTurnFn,
-            containerTypeName: names.metaType,
-            returnType: 'int',
-            mutations: [{ target: 'self', property: 'turn_seq', expression: 'self.turn_seq + 1' }],
-            returnExpression: 'self.turn_seq',
-            timers: [turnDeadlineTimer(names, turnTimer.delayMs)],
-            invokePolicyJson: kitPolicyJson({
-                type: 'and',
-                rules: [
-                    {
-                        type: 'or',
-                        rules: [
-                            { type: 'is_host' },
-                            { type: 'condition', expression: 'self.creator_user_id == $caller_user_id' },
-                            { type: 'condition', expression: '$current_turn_user_id == $caller_user_id' },
-                        ],
-                    },
-                    { type: 'condition', expression: 'self.state == "active"' },
-                ],
-            }),
-            description: "Open a turn: bump turn_seq and arm this turn's deadline (host, creator, or the outgoing turn holder). Call it before handing the turn over so the incoming player is never left without a clock.",
-        });
-    }
-    const automations = [];
-    if (turnTick) {
-        functions.push({
-            name: names.turnTickFn,
-            containerTypeName: names.metaType,
-            returnType: 'int',
-            mutations: [
-                { target: 'self', property: 'tick_count', expression: 'self.tick_count + 1' },
-            ],
-            returnExpression: 'self.tick_count',
-            invokePolicyJson: kitPolicyJson({ type: 'is_automation' }),
-            autonomousInvocable: true,
-            description: 'Server-driven timer tick for active matches (counters instead of wall clocks — expressions have no now()).',
-        });
-        automations.push({
-            name: names.turnTickAutomation,
-            functionName: names.turnTickFn,
-            targetMode: 'type',
-            targetTypeName: names.metaType,
-            triggerType: 'schedule',
-            scheduleKind: 'interval',
-            intervalMs: turnTick.intervalMs,
-            maxTargets: 64,
-            selectorJson: JSON.stringify({
-                selfWhere: [{ key: 'state', op: '==', value: 'active' }],
-            }),
-            description: 'Bumps tick_count on active matches (turn-timeout timer source).',
-        });
-    }
-    return {
-        name: names.metaType,
-        containerTypes: [
-            {
-                typeName: names.metaType,
-                displayName: names.metaType,
-                instantiableBy: 'member',
-                description: 'Session-scoped match record: lobby state, round, winner, notification channel.',
-            },
-            {
-                typeName: names.scoreType,
-                displayName: names.scoreType,
-                instantiableBy: 'member',
-                description: "One player's session-scoped score row.",
-            },
-        ],
-        propertyDefinitions,
-        functions,
-        ...(automations.length ? { automations } : {}),
-    };
-}