@hypersoniclabs/helix-cli 0.1.6 → 0.1.23

package/dist/deviceActionValidation.js

@@ -0,0 +1,460 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deviceActionAstBudgetError = deviceActionAstBudgetError;
+exports.validateDeviceInteractionDisabledWhen = validateDeviceInteractionDisabledWhen;
+exports.validateDeviceInteractionAction = validateDeviceInteractionAction;
+exports.validateDeviceScreenTimeline = validateDeviceScreenTimeline;
+const MAX_DEVICE_ACTION_AST_DEPTH = 32;
+const MAX_DEVICE_ACTION_AST_NODES = 512;
+const MAX_DEVICE_ACTION_CASES = 8;
+const MAX_DEVICE_ACTION_REQUIRES = 8;
+const MAX_DEVICE_ACTION_EFFECTS = 32;
+const MAX_DEVICE_ACTION_OPERANDS = 16;
+function object(value) {
+    return value && typeof value === 'object' && !Array.isArray(value)
+        ? value
+        : {};
+}
+function scalar(value) {
+    return (typeof value === 'number' ||
+        typeof value === 'string' ||
+        typeof value === 'boolean');
+}
+function isObject(value) {
+    return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
+}
+function isNonEmptyString(value) {
+    return typeof value === 'string' && value.length > 0;
+}
+/**
+ * Bound the complete interaction-action tree before recursive shape and type
+ * validation. JSON files cannot contain cycles, but callers and tests may pass
+ * an in-memory definition through this helper, so the guard fails closed for
+ * both recursive references and adversarially deep input.
+ */
+function deviceActionAstBudgetError(input) {
+    if (!isObject(input) || !Array.isArray(input.interactions))
+        return null;
+    const stack = [];
+    for (const interaction of input.interactions) {
+        if (!isObject(interaction))
+            continue;
+        if (interaction.action !== undefined) {
+            stack.push({ value: interaction.action, depth: 1 });
+        }
+    }
+    const active = new WeakSet();
+    const visited = new WeakSet();
+    let nodes = 0;
+    while (stack.length > 0) {
+        const entry = stack.pop();
+        if (!entry.value || typeof entry.value !== 'object')
+            continue;
+        if (entry.leaving) {
+            active.delete(entry.value);
+            continue;
+        }
+        if (entry.depth > MAX_DEVICE_ACTION_AST_DEPTH) {
+            return `action AST exceeds depth ${MAX_DEVICE_ACTION_AST_DEPTH}`;
+        }
+        if (active.has(entry.value))
+            return 'action AST contains a cycle';
+        if (visited.has(entry.value))
+            continue;
+        active.add(entry.value);
+        visited.add(entry.value);
+        nodes += 1;
+        if (nodes > MAX_DEVICE_ACTION_AST_NODES) {
+            return `action AST exceeds ${MAX_DEVICE_ACTION_AST_NODES} nodes`;
+        }
+        const children = Array.isArray(entry.value)
+            ? entry.value
+            : Object.values(entry.value);
+        stack.push({ ...entry, leaving: true });
+        for (const child of children) {
+            if (child && typeof child === 'object') {
+                stack.push({ value: child, depth: entry.depth + 1 });
+            }
+        }
+    }
+    return null;
+}
+function stateScalarType(value) {
+    const type = String(object(value).type ?? '');
+    if (type === 'integer' || type === 'float')
+        return 'number';
+    if (type === 'string' || type === 'enum')
+        return 'string';
+    if (type === 'boolean')
+        return 'boolean';
+    return undefined;
+}
+function controlScalarType(interaction) {
+    const kind = String(object(interaction.control).kind ?? '');
+    if (kind === 'number')
+        return 'number';
+    if (kind === 'choice' || kind === 'text')
+        return 'string';
+    return undefined;
+}
+function actionArgScalarType(interaction, name) {
+    if (name === 'value')
+        return controlScalarType(interaction);
+    const spec = object(object(object(interaction.action).args)[name]);
+    const type = String(spec.type ?? '');
+    return type === 'number' || type === 'string' || type === 'boolean'
+        ? type
+        : undefined;
+}
+function validateActionExpr(raw, interaction, state, errors, path) {
+    if (!isObject(raw)) {
+        errors.push(`${path}: action expression must be an object`);
+        return undefined;
+    }
+    const kind = String(raw.kind ?? '');
+    if (kind === 'lit') {
+        if (!scalar(raw.value) ||
+            (typeof raw.value === 'number' && !Number.isFinite(raw.value))) {
+            errors.push(`${path}: lit requires a finite scalar value`);
+            return undefined;
+        }
+        return typeof raw.value;
+    }
+    if (kind === 'state') {
+        if (!isNonEmptyString(raw.key)) {
+            errors.push(`${path}: state key must be a non-empty string`);
+            return undefined;
+        }
+        const key = raw.key;
+        const type = stateScalarType(state[key]);
+        if (!type)
+            errors.push(`${path}: unknown state key "${key}"`);
+        return type;
+    }
+    if (kind === 'arg') {
+        if (!isNonEmptyString(raw.name)) {
+            errors.push(`${path}: action arg name must be a non-empty string`);
+            return undefined;
+        }
+        const name = raw.name;
+        const type = actionArgScalarType(interaction, name);
+        if (!type)
+            errors.push(`${path}: unknown action arg "${name}"`);
+        return type;
+    }
+    if (kind === 'serverTime')
+        return 'number';
+    if (!['add', 'sub', 'mul'].includes(kind)) {
+        errors.push(`${path}: unsupported action expression kind "${kind}"`);
+        return undefined;
+    }
+    const args = Array.isArray(raw.args) ? raw.args : [];
+    if (args.length < 1 || args.length > MAX_DEVICE_ACTION_OPERANDS) {
+        errors.push(`${path}.args: ${kind} requires 1..${MAX_DEVICE_ACTION_OPERANDS} operands`);
+    }
+    args.forEach((arg, index) => {
+        if (validateActionExpr(arg, interaction, state, errors, `${path}.args.${index}`) !== 'number') {
+            errors.push(`${path}.args.${index}: ${kind} requires a number`);
+        }
+    });
+    return 'number';
+}
+function validateActionCondition(raw, interaction, state, errors, path) {
+    if (!isObject(raw)) {
+        errors.push(`${path}: action condition must be an object`);
+        return;
+    }
+    const op = String(raw.op ?? '');
+    if (op === 'true' || op === 'false')
+        return;
+    if (op === 'and' || op === 'or') {
+        const parts = Array.isArray(raw.of) ? raw.of : [];
+        if (parts.length < 1 || parts.length > MAX_DEVICE_ACTION_OPERANDS) {
+            errors.push(`${path}.of: ${op} requires 1..${MAX_DEVICE_ACTION_OPERANDS} conditions`);
+        }
+        parts.forEach((part, index) => validateActionCondition(part, interaction, state, errors, `${path}.of.${index}`));
+        return;
+    }
+    if (op === 'not') {
+        validateActionCondition(raw.of, interaction, state, errors, `${path}.of`);
+        return;
+    }
+    if (!['eq', 'ne', 'gt', 'lt', 'gte', 'lte'].includes(op)) {
+        errors.push(`${path}: unsupported action condition op "${op}"`);
+        return;
+    }
+    const left = validateActionExpr(raw.left, interaction, state, errors, `${path}.left`);
+    const right = validateActionExpr(raw.right, interaction, state, errors, `${path}.right`);
+    if (left && right && left !== right) {
+        errors.push(`${path}: compares ${left} with ${right}`);
+    }
+    if (op !== 'eq' && op !== 'ne' &&
+        (left !== 'number' || right !== 'number')) {
+        errors.push(`${path}: ${op} requires numbers`);
+    }
+}
+/**
+ * The authored `disabledWhen`/`disabledReason` pair on an interaction.
+ *
+ * A disabled row stays PRESENT and renders disabled with its reason shown; the
+ * failure this prevents is a row that greys out with nothing readable on it, so
+ * the reason is required whenever the condition is. The condition reuses the
+ * action-condition vocabulary validated below, because it evaluates against the
+ * same live state the interaction's own action does.
+ */
+function validateDeviceInteractionDisabledWhen(interaction, state, errors) {
+    if (interaction.disabledWhen === undefined)
+        return;
+    const id = String(interaction.id ?? '');
+    const prefix = `interactions.${id}.disabledWhen`;
+    validateActionCondition(interaction.disabledWhen, interaction, state, errors, prefix);
+    const reason = interaction.disabledReason;
+    if (typeof reason !== 'string' || !reason.trim()) {
+        errors.push(`${prefix}: disabledReason must be a non-empty string`);
+    }
+}
+function validateDeviceInteractionAction(interaction, state, errors) {
+    if (interaction.action === undefined)
+        return;
+    const id = String(interaction.id ?? '');
+    const prefix = `interactions.${id}.action`;
+    if (!isObject(interaction.action)) {
+        errors.push(`${prefix}: action must be an object`);
+        return;
+    }
+    const action = interaction.action;
+    if (action.args !== undefined && !isObject(action.args)) {
+        errors.push(`${prefix}.args: must be an object`);
+    }
+    const args = object(action.args);
+    if (args.value !== undefined) {
+        errors.push(`${prefix}.args: "value" is reserved for the control`);
+    }
+    for (const [name, rawSpec] of Object.entries(args)) {
+        const specPath = `${prefix}.args.${name}`;
+        if (!name.trim() || !isObject(rawSpec)) {
+            errors.push(`${specPath}: requires a scalar argument schema`);
+            continue;
+        }
+        const spec = rawSpec;
+        if (spec.type === 'number') {
+            if (!Number.isFinite(spec.min) || !Number.isFinite(spec.max)) {
+                errors.push(`${specPath}: number args require finite min and max`);
+            }
+            else if (Number(spec.max) < Number(spec.min)) {
+                errors.push(`${specPath}: max must be >= min`);
+            }
+            if (spec.integer !== undefined && typeof spec.integer !== 'boolean') {
+                errors.push(`${specPath}.integer: must be boolean`);
+            }
+        }
+        else if (spec.type === 'string') {
+            if (spec.maxLength !== undefined &&
+                (!Number.isInteger(spec.maxLength) ||
+                    Number(spec.maxLength) < 1 ||
+                    Number(spec.maxLength) > 4096)) {
+                errors.push(`${specPath}.maxLength: must be 1..4096`);
+            }
+            if (spec.values !== undefined) {
+                const values = Array.isArray(spec.values) ? spec.values : [];
+                if (values.length < 1 || values.length > 64 ||
+                    values.some((value) => typeof value !== 'string' || !value.length || value.length > 512)) {
+                    errors.push(`${specPath}.values: must contain 1..64 non-empty strings up to 512 characters`);
+                }
+                else if (new Set(values).size !== values.length) {
+                    errors.push(`${specPath}: duplicate values`);
+                }
+            }
+        }
+        else if (spec.type !== 'boolean') {
+            errors.push(`${specPath}.type: unsupported action arg type "${String(spec.type)}"`);
+        }
+    }
+    if (action.requires !== undefined && !Array.isArray(action.requires)) {
+        errors.push(`${prefix}.requires: must be an array`);
+    }
+    const requires = Array.isArray(action.requires) ? action.requires : [];
+    if (requires.length > MAX_DEVICE_ACTION_REQUIRES) {
+        errors.push(`${prefix}.requires: exceeds ${MAX_DEVICE_ACTION_REQUIRES} guards`);
+    }
+    const requirementKeys = new Set();
+    for (const rawRequirement of requires) {
+        if (!isObject(rawRequirement)) {
+            errors.push(`${prefix}.requires: guards must be objects`);
+            continue;
+        }
+        if (!isNonEmptyString(rawRequirement.arg) ||
+            !isNonEmptyString(rawRequirement.stateKey)) {
+            errors.push(`${prefix}.requires: guard arg and stateKey must be non-empty strings`);
+            continue;
+        }
+        const arg = rawRequirement.arg;
+        const stateKey = rawRequirement.stateKey;
+        const pair = `${arg}\u0000${stateKey}`;
+        if (requirementKeys.has(pair)) {
+            errors.push(`${prefix}.requires: duplicate ${arg}/${stateKey}`);
+        }
+        requirementKeys.add(pair);
+        const argType = actionArgScalarType(interaction, arg);
+        const targetType = stateScalarType(state[stateKey]);
+        if (!argType)
+            errors.push(`${prefix}.requires: unknown arg "${arg}"`);
+        if (!targetType) {
+            errors.push(`${prefix}.requires: unknown state key "${stateKey}"`);
+        }
+        if (argType && targetType && argType !== targetType) {
+            errors.push(`${prefix}.requires: ${arg} does not match state.${stateKey}`);
+        }
+    }
+    if (!Array.isArray(action.cases)) {
+        errors.push(`${prefix}.cases: must be an array`);
+        return;
+    }
+    if (action.cases.length < 1 || action.cases.length > MAX_DEVICE_ACTION_CASES) {
+        errors.push(`${prefix}.cases: must contain 1..${MAX_DEVICE_ACTION_CASES} cases`);
+    }
+    const caseCount = action.cases.length;
+    action.cases.forEach((rawCase, caseIndex) => {
+        const casePath = `${prefix}.cases.${caseIndex}`;
+        if (!isObject(rawCase)) {
+            errors.push(`${casePath}: case must be an object`);
+            return;
+        }
+        if (rawCase.when === undefined && caseIndex !== caseCount - 1) {
+            errors.push(`${casePath}: default case must be last`);
+        }
+        if (rawCase.when !== undefined) {
+            validateActionCondition(rawCase.when, interaction, state, errors, `${casePath}.when`);
+        }
+        if (!Array.isArray(rawCase.do)) {
+            errors.push(`${casePath}.do: must be an array`);
+            return;
+        }
+        if (rawCase.do.length > MAX_DEVICE_ACTION_EFFECTS) {
+            errors.push(`${casePath}.do: exceeds ${MAX_DEVICE_ACTION_EFFECTS} effects`);
+        }
+        rawCase.do.forEach((rawStep, stepIndex) => {
+            const stepPath = `${casePath}.do.${stepIndex}`;
+            if (!isObject(rawStep)) {
+                errors.push(`${stepPath}: effect must be an object`);
+                return;
+            }
+            if (!isNonEmptyString(rawStep.key)) {
+                errors.push(`${stepPath}: state key must be a non-empty string`);
+                return;
+            }
+            const key = rawStep.key;
+            const targetType = stateScalarType(state[key]);
+            if (!targetType) {
+                errors.push(`${stepPath}: unknown state key "${key}"`);
+                return;
+            }
+            if (rawStep.step === 'toggleState') {
+                if (targetType !== 'boolean') {
+                    errors.push(`${stepPath}: toggleState requires boolean state`);
+                }
+                return;
+            }
+            if (rawStep.step !== 'setState') {
+                errors.push(`${stepPath}: unsupported action effect "${String(rawStep.step)}"`);
+                return;
+            }
+            const valueType = validateActionExpr(rawStep.value, interaction, state, errors, `${stepPath}.value`);
+            if (valueType && valueType !== targetType) {
+                errors.push(`${stepPath}: cannot write ${valueType} to ${targetType} state`);
+            }
+        });
+    });
+}
+function validateDeviceScreenTimeline(component, state, interactions, errors) {
+    if (component.timeline === undefined)
+        return;
+    const componentId = isNonEmptyString(component.id) ? component.id : '';
+    const prefix = `components.${componentId}.timeline`;
+    if (!isNonEmptyString(component.id)) {
+        errors.push(`${prefix}: component id must be a non-empty string`);
+    }
+    if (!isObject(component.timeline)) {
+        errors.push(`${prefix}: timeline must be an object`);
+        return;
+    }
+    const timeline = component.timeline;
+    const stateFields = {
+        positionStateKey: 'number',
+        updatedAtStateKey: 'number',
+        durationStateKey: 'number',
+        sourceRevisionStateKey: 'integer',
+        timelineRevisionStateKey: 'integer',
+    };
+    for (const [field, expected] of Object.entries(stateFields)) {
+        if (!isNonEmptyString(timeline[field])) {
+            errors.push(`${prefix}.${field}: state key must be a non-empty string`);
+            continue;
+        }
+        const key = timeline[field];
+        const type = String(object(state[key]).type ?? '');
+        const valid = expected === 'number'
+            ? type === 'integer' || type === 'float'
+            : type === 'integer';
+        if (!valid) {
+            errors.push(`${prefix}.${field}: requires ${expected} state`);
+        }
+    }
+    const interactionFields = [
+        'powerInteraction',
+        'sourceInteraction',
+        'playbackInteraction',
+        'stopInteraction',
+        'seekInteraction',
+        'metadataInteraction',
+        'endedInteraction',
+    ];
+    for (const field of interactionFields) {
+        if (!isNonEmptyString(timeline[field])) {
+            errors.push(`${prefix}.${field}: interaction id must be a non-empty string`);
+            continue;
+        }
+        const id = timeline[field];
+        const interaction = interactions.get(id);
+        if (!interaction) {
+            errors.push(`${prefix}.${field}: unknown interaction "${id}"`);
+        }
+        else if (!isObject(interaction.action)) {
+            errors.push(`${prefix}.${field}: interaction "${id}" needs an action transition`);
+        }
+    }
+    const requireRevision = (field, arg, stateField) => {
+        const id = isNonEmptyString(timeline[field]) ? timeline[field] : '';
+        const interaction = interactions.get(id);
+        const action = object(interaction?.action);
+        const stateKey = isNonEmptyString(timeline[stateField])
+            ? timeline[stateField]
+            : '';
+        const requirements = Array.isArray(action.requires)
+            ? action.requires.map(object)
+            : [];
+        if (!requirements.some((requirement) => requirement.arg === arg && requirement.stateKey === stateKey)) {
+            errors.push(`${prefix}.${field}: interaction "${id}" must require ${arg} == state.${stateKey}`);
+        }
+        const argSpec = object(object(action.args)[arg]);
+        if (argSpec.type !== 'number' || argSpec.integer !== true) {
+            errors.push(`${prefix}.${field}: interaction "${id}" must declare ${arg} as an integer action arg`);
+        }
+    };
+    for (const field of interactionFields) {
+        requireRevision(field, 'expectedSourceRevision', 'sourceRevisionStateKey');
+    }
+    for (const field of [
+        'seekInteraction',
+        'metadataInteraction',
+        'endedInteraction',
+    ]) {
+        requireRevision(field, 'expectedTimelineRevision', 'timelineRevisionStateKey');
+        const id = isNonEmptyString(timeline[field]) ? timeline[field] : '';
+        const interaction = interactions.get(id);
+        if (interaction && interaction.surface !== 'internal') {
+            errors.push(`${prefix}.${field}: interaction "${id}" must be internal`);
+        }
+    }
+}
+//# sourceMappingURL=deviceActionValidation.js.map

package/dist/deviceActionValidation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deviceActionValidation.js","sourceRoot":"","sources":["../src/deviceActionValidation.ts"],"names":[],"mappings":"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"}

package/dist/distribution.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Canonical universal-item distribution vocabulary.
+ *
+ * An item definition says what the item is. A distribution is one creator-
+ * authorized primary acquisition route. Keeping this builder network-free
+ * lets `--dry-run` exercise exactly the payload the real command sends.
+ */
+export declare const ITEM_EDITION_MODES: readonly ["standard", "collectible"];
+export type ItemEditionMode = (typeof ITEM_EDITION_MODES)[number];
+export declare const ITEM_DISTRIBUTION_CHANNELS: readonly ["marketplace", "world"];
+export type ItemDistributionChannel = (typeof ITEM_DISTRIBUTION_CHANNELS)[number];
+export declare const DISTRIBUTION_KEY_PATTERN: RegExp;
+/**
+ * Derive the durable caller intent for one distribution request.
+ *
+ * The route API requires an `intentId` and treats it as an idempotency key:
+ * an exact retry returns the same distribution, while reusing one with
+ * different input conflicts. Deriving it from the request itself gives that
+ * property for free — re-running the same command cannot mint a second
+ * identical route, which is the whole hazard of a duplicated listing — while a
+ * genuinely different route hashes to a different id.
+ *
+ * The value is shaped as a v4 UUID because that is what the API validates. It
+ * is derived, not random, so `--intent-id` remains available for a caller that
+ * wants to retry across a changed request or force a distinct route.
+ */
+export declare function distributionIntentId(fields: ItemDistributionFields): string;
+export type ItemDistributionInput = {
+    itemId?: string;
+    /** Override the derived idempotency key; omit for the deterministic default. */
+    intentId?: string;
+    channel: ItemDistributionChannel;
+    priceLix: number;
+    worldId?: string;
+    worldSlug?: string;
+    key?: string;
+    maxPerPlayer?: number | null;
+    maxClaims?: number | null;
+    startsAt?: string | null;
+    endsAt?: string | null;
+};
+export type ItemDistributionFields = {
+    intentId?: string;
+    itemId?: string;
+    channel: ItemDistributionChannel;
+    priceLix: number;
+    worldId?: string;
+    /** Offline plan only; the CLI resolves it to worldId before a network write. */
+    worldSlug?: string;
+    key?: string;
+    maxPerPlayer?: number | null;
+    maxClaims?: number | null;
+    startsAt?: string | null;
+    endsAt?: string | null;
+};
+export type ItemDistributionUpdateInput = {
+    priceLix?: number;
+    maxPerPlayer?: number | null;
+    maxClaims?: number | null;
+    startsAt?: string | null;
+    endsAt?: string | null;
+};
+export type ItemDistributionPatch = ItemDistributionUpdateInput;
+export declare function buildItemDistribution(input: ItemDistributionInput): ItemDistributionFields;
+export declare function buildItemDistributionUpdate(input: ItemDistributionUpdateInput): ItemDistributionPatch;
+export declare function editionFields(collectibleSupply?: number): {
+    editionMode: ItemEditionMode;
+    collectibleSupply?: number;
+};