mythik 0.0.1 → 0.1.0

package/dist/contract/rules/fields-valid.js

@@ -0,0 +1,39 @@
+import { matchEndpoint } from '../matcher.js';
+import { suggest } from '../../utils/levenshtein.js';
+export const fieldsValidRule = {
+    name: 'fields-valid',
+    description: 'POST/PUT body fields must exist in crud insertable/updatable definitions',
+    check(context) {
+        const findings = [];
+        for (const fetch of context.fetches) {
+            if (fetch.method !== 'POST' && fetch.method !== 'PUT')
+                continue;
+            if (fetch.bodyFields.length === 0)
+                continue;
+            const result = matchEndpoint(fetch.path, fetch.method, context.endpoints, context.catalogs, context.authConfigured);
+            if (!result.matched || !result.endpoint?.crud)
+                continue;
+            const allowedFields = fetch.method === 'POST'
+                ? result.endpoint.crud.insertable
+                : result.endpoint.crud.updatable;
+            for (const field of fetch.bodyFields) {
+                if (!allowedFields.includes(field)) {
+                    const fieldList = fetch.method === 'POST' ? 'insertable' : 'updatable';
+                    const suggested = suggest(field, allowedFields);
+                    findings.push({
+                        level: 'error',
+                        rule: 'fields-valid',
+                        message: `${fetch.method} ${fetch.path} body field "${field}" not in ${fieldList}`,
+                        screen: fetch.screen,
+                        endpoint: fetch.path,
+                        suggestion: suggested
+                            ? `Did you mean "${suggested}"? ${fieldList}: ${allowedFields.join(', ')}`
+                            : `${fieldList}: ${allowedFields.join(', ')}`,
+                    });
+                }
+            }
+        }
+        return findings;
+    },
+};
+//# sourceMappingURL=fields-valid.js.map

package/dist/contract/rules/fields-valid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields-valid.js","sourceRoot":"","sources":["../../../src/contract/rules/fields-valid.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAErD,MAAM,CAAC,MAAM,eAAe,GAAiB;IAC3C,IAAI,EAAE,cAAc;IACpB,WAAW,EAAE,0EAA0E;IAEvF,KAAK,CAAC,OAAwB;QAC5B,MAAM,QAAQ,GAAsB,EAAE,CAAC;QAEvC,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpC,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK;gBAAE,SAAS;YAChE,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAS;YAE5C,MAAM,MAAM,GAAG,aAAa,CAC1B,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,cAAc,CACtF,CAAC;YACF,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI;gBAAE,SAAS;YAExD,MAAM,aAAa,GAAG,KAAK,CAAC,MAAM,KAAK,MAAM;gBAC3C,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU;gBACjC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC;YAEnC,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;gBACrC,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;oBACnC,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,WAAW,CAAC;oBACvE,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;oBAEhD,QAAQ,CAAC,IAAI,CAAC;wBACZ,KAAK,EAAE,OAAO;wBACd,IAAI,EAAE,cAAc;wBACpB,OAAO,EAAE,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,IAAI,gBAAgB,KAAK,YAAY,SAAS,EAAE;wBAClF,MAAM,EAAE,KAAK,CAAC,MAAM;wBACpB,QAAQ,EAAE,KAAK,CAAC,IAAI;wBACpB,UAAU,EAAE,SAAS;4BACnB,CAAC,CAAC,iBAAiB,SAAS,MAAM,SAAS,KAAK,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;4BAC1E,CAAC,CAAC,GAAG,SAAS,KAAK,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;qBAChD,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF,CAAC"}

package/dist/contract/rules/params-match.d.ts

@@ -0,0 +1,3 @@
+import type { ContractRule } from '../types.js';
+export declare const paramsMatchRule: ContractRule;
+//# sourceMappingURL=params-match.d.ts.map

package/dist/contract/rules/params-match.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"params-match.d.ts","sourceRoot":"","sources":["../../../src/contract/rules/params-match.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAoC,MAAM,aAAa,CAAC;AAMlF,eAAO,MAAM,eAAe,EAAE,YAwC7B,CAAC"}

package/dist/contract/rules/params-match.js

@@ -0,0 +1,40 @@
+import { matchEndpoint } from '../matcher.js';
+import { suggest } from '../../utils/levenshtein.js';
+const ALWAYS_VALID_PARAMS = new Set(['page', 'pageSize']);
+export const paramsMatchRule = {
+    name: 'params-match',
+    description: 'Query params in fetch URLs must match endpoint param definitions',
+    check(context) {
+        const findings = [];
+        for (const fetch of context.fetches) {
+            if (fetch.queryParams.length === 0)
+                continue;
+            const result = matchEndpoint(fetch.path, fetch.method, context.endpoints, context.catalogs, context.authConfigured);
+            if (!result.matched || !result.endpoint)
+                continue;
+            const declaredParams = Object.keys(result.endpoint.params);
+            if (declaredParams.length === 0)
+                continue;
+            for (const param of fetch.queryParams) {
+                if (ALWAYS_VALID_PARAMS.has(param))
+                    continue;
+                if (declaredParams.includes(param))
+                    continue;
+                const suggested = suggest(param, declaredParams);
+                const paramList = declaredParams.map(p => `${p} (${result.endpoint.params[p].type})`).join(', ');
+                findings.push({
+                    level: 'warning',
+                    rule: 'params-match',
+                    message: `${fetch.method} ${fetch.path} sends param "${param}" — not declared in endpoint`,
+                    screen: fetch.screen,
+                    endpoint: fetch.path,
+                    suggestion: suggested
+                        ? `Did you mean "${suggested}"? Available: ${paramList}`
+                        : `Available params: ${paramList}`,
+                });
+            }
+        }
+        return findings;
+    },
+};
+//# sourceMappingURL=params-match.js.map

package/dist/contract/rules/params-match.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"params-match.js","sourceRoot":"","sources":["../../../src/contract/rules/params-match.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAErD,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;AAE1D,MAAM,CAAC,MAAM,eAAe,GAAiB;IAC3C,IAAI,EAAE,cAAc;IACpB,WAAW,EAAE,kEAAkE;IAE/E,KAAK,CAAC,OAAwB;QAC5B,MAAM,QAAQ,GAAsB,EAAE,CAAC;QAEvC,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpC,IAAI,KAAK,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAS;YAE7C,MAAM,MAAM,GAAG,aAAa,CAC1B,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,cAAc,CACtF,CAAC;YACF,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ;gBAAE,SAAS;YAElD,MAAM,cAAc,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YAC3D,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAS;YAE1C,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;gBACtC,IAAI,mBAAmB,CAAC,GAAG,CAAC,KAAK,CAAC;oBAAE,SAAS;gBAC7C,IAAI,cAAc,CAAC,QAAQ,CAAC,KAAK,CAAC;oBAAE,SAAS;gBAE7C,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;gBACjD,MAAM,SAAS,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,QAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAElG,QAAQ,CAAC,IAAI,CAAC;oBACZ,KAAK,EAAE,SAAS;oBAChB,IAAI,EAAE,cAAc;oBACpB,OAAO,EAAE,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,IAAI,iBAAiB,KAAK,8BAA8B;oBAC1F,MAAM,EAAE,KAAK,CAAC,MAAM;oBACpB,QAAQ,EAAE,KAAK,CAAC,IAAI;oBACpB,UAAU,EAAE,SAAS;wBACnB,CAAC,CAAC,iBAAiB,SAAS,iBAAiB,SAAS,EAAE;wBACxD,CAAC,CAAC,qBAAqB,SAAS,EAAE;iBACrC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF,CAAC"}

package/dist/contract/rules/permissions-consistent.d.ts

@@ -0,0 +1,3 @@
+import type { ContractRule } from '../types.js';
+export declare const permissionsConsistentRule: ContractRule;
+//# sourceMappingURL=permissions-consistent.d.ts.map

package/dist/contract/rules/permissions-consistent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissions-consistent.d.ts","sourceRoot":"","sources":["../../../src/contract/rules/permissions-consistent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAoC,MAAM,aAAa,CAAC;AAGlF,eAAO,MAAM,yBAAyB,EAAE,YAwDvC,CAAC"}

package/dist/contract/rules/permissions-consistent.js

@@ -0,0 +1,52 @@
+import { matchEndpoint } from '../matcher.js';
+export const permissionsConsistentRule = {
+    name: 'permissions-consistent',
+    description: 'If AppSpec grants a role access to a screen, endpoints used by that screen must allow that role',
+    check(context) {
+        if (!context.roleAccess)
+            return [];
+        const findings = [];
+        // Build screen → fetches map
+        const screenFetches = new Map();
+        for (const fetch of context.fetches) {
+            if (!screenFetches.has(fetch.screen)) {
+                screenFetches.set(fetch.screen, []);
+            }
+            screenFetches.get(fetch.screen).push(fetch);
+        }
+        // For each role, check that its screens' endpoints allow the role
+        for (const [role, screens] of Object.entries(context.roleAccess)) {
+            const accessibleScreens = screens.includes('*')
+                ? Array.from(screenFetches.keys())
+                : screens;
+            for (const screenId of accessibleScreens) {
+                const fetches = screenFetches.get(screenId);
+                if (!fetches)
+                    continue;
+                for (const fetch of fetches) {
+                    const result = matchEndpoint(fetch.path, fetch.method, context.endpoints, context.catalogs, context.authConfigured);
+                    if (!result.matched || !result.endpoint)
+                        continue;
+                    const policy = result.endpoint.policy;
+                    if (!policy || policy === 'public' || policy === 'authenticated')
+                        continue;
+                    const policyConfig = context.policies.get(policy);
+                    if (!policyConfig)
+                        continue;
+                    if (!policyConfig.roles.includes(role)) {
+                        findings.push({
+                            level: 'warning',
+                            rule: 'permissions-consistent',
+                            message: `Role "${role}" can access screen "${screenId}" but ${fetch.method} ${fetch.path} requires policy "${policy}" (roles: [${policyConfig.roles.join(', ')}])`,
+                            screen: screenId,
+                            endpoint: fetch.path,
+                            suggestion: `Role "${role}" can see the screen but API will deny the action (403)`,
+                        });
+                    }
+                }
+            }
+        }
+        return findings;
+    },
+};
+//# sourceMappingURL=permissions-consistent.js.map

package/dist/contract/rules/permissions-consistent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissions-consistent.js","sourceRoot":"","sources":["../../../src/contract/rules/permissions-consistent.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,MAAM,CAAC,MAAM,yBAAyB,GAAiB;IACrD,IAAI,EAAE,wBAAwB;IAC9B,WAAW,EAAE,iGAAiG;IAE9G,KAAK,CAAC,OAAwB;QAC5B,IAAI,CAAC,OAAO,CAAC,UAAU;YAAE,OAAO,EAAE,CAAC;QAEnC,MAAM,QAAQ,GAAsB,EAAE,CAAC;QAEvC,6BAA6B;QAC7B,MAAM,aAAa,GAAG,IAAI,GAAG,EAAkC,CAAC;QAChE,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;gBACrC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YACtC,CAAC;YACD,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC/C,CAAC;QAED,kEAAkE;QAClE,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;YACjE,MAAM,iBAAiB,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;gBAC7C,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC;gBAClC,CAAC,CAAC,OAAO,CAAC;YAEZ,KAAK,MAAM,QAAQ,IAAI,iBAAiB,EAAE,CAAC;gBACzC,MAAM,OAAO,GAAG,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;gBAC5C,IAAI,CAAC,OAAO;oBAAE,SAAS;gBAEvB,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;oBAC5B,MAAM,MAAM,GAAG,aAAa,CAC1B,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,cAAc,CACtF,CAAC;oBACF,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ;wBAAE,SAAS;oBAElD,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;oBACtC,IAAI,CAAC,MAAM,IAAI,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,eAAe;wBAAE,SAAS;oBAE3E,MAAM,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;oBAClD,IAAI,CAAC,YAAY;wBAAE,SAAS;oBAE5B,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;wBACvC,QAAQ,CAAC,IAAI,CAAC;4BACZ,KAAK,EAAE,SAAS;4BAChB,IAAI,EAAE,wBAAwB;4BAC9B,OAAO,EAAE,SAAS,IAAI,wBAAwB,QAAQ,SAAS,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,IAAI,qBAAqB,MAAM,cAAc,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;4BACnK,MAAM,EAAE,QAAQ;4BAChB,QAAQ,EAAE,KAAK,CAAC,IAAI;4BACpB,UAAU,EAAE,SAAS,IAAI,yDAAyD;yBACnF,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF,CAAC"}

package/dist/contract/types.d.ts

@@ -0,0 +1,66 @@
+/** A fetch/dataSource reference found in a screen spec */
+export interface FetchReference {
+    screen: string;
+    path: string;
+    method: string;
+    queryParams: string[];
+    bodyFields: string[];
+    rawUrl: string;
+    elementId?: string;
+}
+/** An endpoint declared in an api-spec */
+export interface EndpointInfo {
+    path: string;
+    method: string;
+    params: Record<string, {
+        type: string;
+    }>;
+    crud?: {
+        insertable: string[];
+        updatable: string[];
+    };
+    policy?: string;
+    source: string;
+}
+/** Everything the rules need */
+export interface ContractContext {
+    endpoints: Map<string, EndpointInfo>;
+    catalogs: Set<string>;
+    policies: Map<string, {
+        roles: string[];
+    }>;
+    fetches: FetchReference[];
+    roleAccess?: Record<string, string[]>;
+    authConfigured: boolean;
+}
+/** A single finding from a rule */
+export interface ContractFinding {
+    level: 'error' | 'warning';
+    rule: string;
+    message: string;
+    screen?: string;
+    endpoint?: string;
+    suggestion?: string;
+    /** Number of duplicate findings collapsed into this one. Default: 1. */
+    count?: number;
+}
+/** A contract rule — independent, pluggable */
+export interface ContractRule {
+    name: string;
+    description: string;
+    check(context: ContractContext): ContractFinding[];
+}
+/** Result of running all contract rules */
+export interface ContractResult {
+    valid: boolean;
+    findings: ContractFinding[];
+    summary: {
+        screens: number;
+        fetchReferences: number;
+        endpointsCovered: number;
+        rulesRun: number;
+        errors: number;
+        warnings: number;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/contract/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/contract/types.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,0CAA0C;AAC1C,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzC,IAAI,CAAC,EAAE;QAAE,UAAU,EAAE,MAAM,EAAE,CAAC;QAAC,SAAS,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,gCAAgC;AAChC,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACrC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACtB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IAC3C,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACtC,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,mCAAmC;AACnC,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,+CAA+C;AAC/C,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,OAAO,EAAE,eAAe,GAAG,eAAe,EAAE,CAAC;CACpD;AAED,2CAA2C;AAC3C,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,OAAO,EAAE;QACP,OAAO,EAAE,MAAM,CAAC;QAChB,eAAe,EAAE,MAAM,CAAC;QACxB,gBAAgB,EAAE,MAAM,CAAC;QACzB,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;CACH"}

package/dist/contract/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/contract/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/contract/types.ts"],"names":[],"mappings":""}

package/dist/data/data-sources.d.ts

@@ -0,0 +1,26 @@
+import type { StateStore } from '../state/store.js';
+import type { Resolver } from '../expressions/resolver.js';
+import type { ActionDefinition, DataSourceConfig } from '../types.js';
+export interface DataSourcesEngineConfig {
+    store: StateStore;
+    resolver: Resolver;
+    dataSources: Record<string, DataSourceConfig>;
+    /** Override for testing — defaults to global fetch. */
+    fetcher?: (url: string, options?: RequestInit) => Promise<{
+        ok: boolean;
+        status: number;
+        json: () => Promise<unknown>;
+    }>;
+}
+export interface DataSourcesEngine {
+    /** Start reactive data fetching. Performs initial fetch for sources with initialFetch:true. */
+    mount: () => void;
+    /** Force re-fetch a specific dataSource by id. */
+    refresh: (id: string) => Promise<void>;
+    /** Stop all reactivity and clean up. */
+    unmount: () => void;
+    /** Returns an ActionDefinition for registering refreshDataSource in the dispatcher. */
+    getActionDefinition: () => ActionDefinition;
+}
+export declare function createDataSourcesEngine(config: DataSourcesEngineConfig): DataSourcesEngine;
+//# sourceMappingURL=data-sources.d.ts.map

package/dist/data/data-sources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-sources.d.ts","sourceRoot":"","sources":["../../src/data/data-sources.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEtE,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,UAAU,CAAC;IAClB,QAAQ,EAAE,QAAQ,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC9C,uDAAuD;IACvD,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;KAAE,CAAC,CAAC;CAC1H;AAED,MAAM,WAAW,iBAAiB;IAChC,+FAA+F;IAC/F,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,kDAAkD;IAClD,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,wCAAwC;IACxC,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,uFAAuF;IACvF,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;CAC7C;AAkBD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,uBAAuB,GAAG,iBAAiB,CA+N1F"}

package/dist/data/data-sources.js

@@ -0,0 +1,218 @@
+import { scanDeps } from '../renderer/deps.js';
+/** Values that are treated as "inactive filter" and omitted from query strings. */
+function isInactiveParam(value) {
+    return value === null || value === undefined || value === '' || value === 'all';
+}
+/** Serialize resolved params into a query string, omitting inactive values. */
+function buildQueryString(params) {
+    const parts = [];
+    for (const [key, value] of Object.entries(params)) {
+        if (!isInactiveParam(value)) {
+            parts.push(`${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`);
+        }
+    }
+    return parts.length > 0 ? `?${parts.join('&')}` : '';
+}
+export function createDataSourcesEngine(config) {
+    const { store, resolver, dataSources } = config;
+    const fetcher = config.fetcher ?? globalThis.fetch?.bind(globalThis);
+    let mounted = false;
+    let unsubscribe = null;
+    const debounceTimers = new Map();
+    // Pre-compute dependency sets for each dataSource (params + url + headers)
+    const depsMap = new Map();
+    // Pre-compute URL-only deps separately for skip-on-undefined check (v49 Item E)
+    const urlDepsMap = new Map();
+    for (const [id, ds] of Object.entries(dataSources)) {
+        const deps = new Set();
+        // Scan params for $state dependencies
+        if (ds.params) {
+            for (const paramDeps of scanDeps(ds.params)) {
+                deps.add(paramDeps);
+            }
+        }
+        // Scan URL for $template/${path} dependencies
+        const urlDeps = scanDeps(ds.url);
+        for (const urlDep of urlDeps) {
+            deps.add(urlDep);
+        }
+        urlDepsMap.set(id, urlDeps);
+        // Scan headers
+        if (ds.headers) {
+            for (const headerDep of scanDeps(ds.headers)) {
+                deps.add(headerDep);
+            }
+        }
+        depsMap.set(id, deps);
+    }
+    /** Execute a fetch for one dataSource. */
+    async function fetchDataSource(id) {
+        const ds = dataSources[id];
+        const target = ds.target;
+        const loadingPath = `${target.slice(1)}Loading`;
+        const errorPath = `${target.slice(1)}Error`;
+        const deferredPath = `${target.slice(1)}Deferred`;
+        // Skip-on-undefined-URL-deps (v49 Item E): if URL template depends on
+        // unresolved state, defer to reactive subscription. Sets deferred=true so
+        // consumers can render "waiting for prerequisite" UI distinct from loading.
+        const urlDeps = urlDepsMap.get(id);
+        if (urlDeps && urlDeps.size > 0) {
+            for (const dep of urlDeps) {
+                const value = store.get(dep);
+                if (value === undefined || value === null || value === '') {
+                    store.set(`/${deferredPath}`, true);
+                    store.set(`/${loadingPath}`, false);
+                    return;
+                }
+            }
+        }
+        // URL deps resolved (or no deps) — clear deferred flag and proceed
+        store.set(`/${deferredPath}`, false);
+        // Set loading state
+        store.set(`/${loadingPath}`, true);
+        store.set(`/${errorPath}`, null);
+        // Clear target if emptyWhileLoading
+        if (ds.emptyWhileLoading) {
+            store.set(target, null);
+        }
+        try {
+            // Resolve URL
+            const resolvedUrl = String(resolver.resolve(ds.url));
+            // Resolve params and build query string
+            let queryString = '';
+            if (ds.params) {
+                const resolvedParams = {};
+                for (const [key, expr] of Object.entries(ds.params)) {
+                    resolvedParams[key] = resolver.resolve(expr);
+                }
+                queryString = buildQueryString(resolvedParams);
+            }
+            const fullUrl = resolvedUrl + queryString;
+            // Resolve headers
+            const options = {
+                method: ds.method ?? 'GET',
+            };
+            if (ds.headers) {
+                options.headers = resolver.resolve(ds.headers);
+            }
+            const response = await fetcher(fullUrl, options);
+            if (!response.ok) {
+                store.set(`/${loadingPath}`, false);
+                store.set(`/${errorPath}`, { status: response.status, message: `HTTP ${response.status}` });
+                return;
+            }
+            const data = await response.json();
+            store.set(target, data);
+            store.set(`/${loadingPath}`, false);
+        }
+        catch (err) {
+            store.set(`/${loadingPath}`, false);
+            store.set(`/${errorPath}`, {
+                message: err instanceof Error ? err.message : 'Unknown error',
+            });
+        }
+    }
+    /** Schedule a fetch with optional debounce. */
+    function scheduleFetch(id) {
+        const ds = dataSources[id];
+        const debounce = ds.debounce ?? 0;
+        // Clear existing timer
+        const existingTimer = debounceTimers.get(id);
+        if (existingTimer !== undefined) {
+            clearTimeout(existingTimer);
+        }
+        if (debounce > 0) {
+            const timer = setTimeout(() => {
+                debounceTimers.delete(id);
+                fetchDataSource(id);
+            }, debounce);
+            debounceTimers.set(id, timer);
+        }
+        else {
+            fetchDataSource(id);
+        }
+    }
+    /** Check if a changed path overlaps with any dependency of a dataSource. */
+    function pathOverlaps(depPath, changedPath) {
+        return (depPath === changedPath ||
+            depPath.startsWith(changedPath + '/') ||
+            changedPath.startsWith(depPath + '/'));
+    }
+    function mount() {
+        if (mounted)
+            return;
+        mounted = true;
+        // Initial fetch for all dataSources with initialFetch !== false
+        for (const [id, ds] of Object.entries(dataSources)) {
+            if (ds.initialFetch !== false) {
+                fetchDataSource(id);
+            }
+        }
+        // Subscribe to state changes for reactive re-fetching
+        unsubscribe = store.subscribe((_state, changedPath) => {
+            if (!mounted)
+                return;
+            for (const [id, ds] of Object.entries(dataSources)) {
+                // Skip manual-trigger dataSources
+                const trigger = ds.trigger ?? 'auto';
+                if (trigger !== 'auto')
+                    continue;
+                // Check if changed path overlaps with this dataSource's dependencies
+                const deps = depsMap.get(id);
+                if (!deps)
+                    continue;
+                // Skip if the change is to our own target (avoid infinite loops)
+                if (changedPath === ds.target || changedPath.startsWith(ds.target + '/'))
+                    continue;
+                // Skip loading/error state changes
+                const loadingPath = `/${ds.target.slice(1)}Loading`;
+                const errorPath = `/${ds.target.slice(1)}Error`;
+                if (changedPath === loadingPath || changedPath === errorPath)
+                    continue;
+                let isDirty = false;
+                for (const dep of deps) {
+                    if (pathOverlaps(dep, changedPath)) {
+                        isDirty = true;
+                        break;
+                    }
+                }
+                if (isDirty) {
+                    scheduleFetch(id);
+                }
+            }
+        });
+    }
+    async function refresh(id) {
+        if (!dataSources[id]) {
+            throw new Error(`Unknown dataSource: "${id}"`);
+        }
+        if (!mounted)
+            return; // v49 Item E: no-op after unmount
+        await fetchDataSource(id);
+    }
+    function unmount() {
+        mounted = false;
+        if (unsubscribe) {
+            unsubscribe();
+            unsubscribe = null;
+        }
+        // Clear all pending debounce timers
+        for (const timer of debounceTimers.values()) {
+            clearTimeout(timer);
+        }
+        debounceTimers.clear();
+    }
+    function getActionDefinition() {
+        return {
+            name: 'refreshDataSource',
+            handler: async (params) => {
+                const id = params.id;
+                if (!id)
+                    throw new Error('refreshDataSource requires "id" param');
+                await refresh(id);
+            },
+        };
+    }
+    return { mount, refresh, unmount, getActionDefinition };
+}
+//# sourceMappingURL=data-sources.js.map

package/dist/data/data-sources.js.map

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

package/dist/data/fetch.d.ts

@@ -0,0 +1,29 @@
+import type { StateStore } from '../state/store.js';
+import type { ResolveFn } from '../types.js';
+export interface FetchConfig {
+    source: string;
+    on: 'mount' | 'manual';
+    method?: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+    body?: Record<string, unknown>;
+    headers?: Record<string, string>;
+    loading?: unknown;
+    error?: unknown;
+    empty?: unknown;
+}
+export interface FetchEngineConfig {
+    store: StateStore;
+    resolve: ResolveFn;
+    /** Override for testing — defaults to global fetch */
+    fetcher?: (url: string, options?: RequestInit) => Promise<{
+        ok: boolean;
+        status: number;
+        json: () => Promise<unknown>;
+    }>;
+}
+export interface FetchEngine {
+    execute: (key: string, config: FetchConfig, params?: Record<string, unknown>) => Promise<void>;
+    executeAll: (configs: Record<string, FetchConfig>, params?: Record<string, unknown>) => Promise<void>;
+    getStatus: (key: string) => 'idle' | 'loading' | 'success' | 'error' | 'empty';
+}
+export declare function createFetchEngine(config: FetchEngineConfig): FetchEngine;
+//# sourceMappingURL=fetch.d.ts.map

package/dist/data/fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../src/data/fetch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,OAAO,GAAG,QAAQ,CAAC;IACvB,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC;IACrD,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,UAAU,CAAC;IAClB,OAAO,EAAE,SAAS,CAAC;IACnB,sDAAsD;IACtD,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;KAAE,CAAC,CAAC;CAC1H;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/F,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtG,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;CAChF;AAYD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,WAAW,CAgExE"}

package/dist/data/fetch.js

@@ -0,0 +1,63 @@
+/**
+ * Interpolate URL template: "api/patients/{id}" with params { id: "123" } → "api/patients/123"
+ */
+function interpolateUrl(template, params) {
+    return template.replace(/\{(\w+)\}/g, (_, key) => {
+        const value = params[key];
+        return value !== undefined ? String(value) : `{${key}}`;
+    });
+}
+export function createFetchEngine(config) {
+    const { store, resolve } = config;
+    const fetcher = config.fetcher ?? globalThis.fetch?.bind(globalThis);
+    async function execute(key, fetchConfig, params) {
+        const url = interpolateUrl(fetchConfig.source, params ?? {});
+        const method = fetchConfig.method ?? 'GET';
+        // Set loading state
+        store.set(`/fetch/${key}/status`, 'loading');
+        store.set(`/fetch/${key}/error`, null);
+        try {
+            const options = { method };
+            if (fetchConfig.headers) {
+                options.headers = fetchConfig.headers;
+            }
+            if (fetchConfig.body && method !== 'GET') {
+                options.headers = { ...options.headers, 'Content-Type': 'application/json' };
+                // Resolve expressions in body
+                const resolvedBody = {};
+                for (const [k, v] of Object.entries(fetchConfig.body)) {
+                    resolvedBody[k] = resolve(v);
+                }
+                options.body = JSON.stringify(resolvedBody);
+            }
+            const response = await fetcher(url, options);
+            if (!response.ok) {
+                store.set(`/fetch/${key}/status`, 'error');
+                store.set(`/fetch/${key}/error`, { status: response.status, message: `HTTP ${response.status}` });
+                return;
+            }
+            const data = await response.json();
+            // Check if empty
+            const isEmpty = data === null || data === undefined
+                || (Array.isArray(data) && data.length === 0)
+                || (typeof data === 'object' && !Array.isArray(data) && Object.keys(data).length === 0);
+            store.set(`/${key}`, data);
+            store.set(`/fetch/${key}/status`, isEmpty ? 'empty' : 'success');
+        }
+        catch (err) {
+            store.set(`/fetch/${key}/status`, 'error');
+            store.set(`/fetch/${key}/error`, {
+                message: err instanceof Error ? err.message : 'Unknown error',
+            });
+        }
+    }
+    async function executeAll(configs, params) {
+        const mountConfigs = Object.entries(configs).filter(([, c]) => c.on === 'mount');
+        await Promise.all(mountConfigs.map(([key, c]) => execute(key, c, params)));
+    }
+    function getStatus(key) {
+        return store.get(`/fetch/${key}/status`) ?? 'idle';
+    }
+    return { execute, executeAll, getStatus };
+}
+//# sourceMappingURL=fetch.js.map

package/dist/data/fetch.js.map

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