@jigx/sdk-tools 1.2.0-next.3 → 1.2.0-next.5

package/dist/migrator/converters/databases.js

@@ -0,0 +1,45 @@
+import { isPlainObject } from '../normalize.js';
+import { str } from '../ts-printer.js';
+/**
+ * `databases/default.jigx` → `app.addDatabase.default.table(...)`.
+ *
+ * Only the `default` database with `null` table definitions has a typed builder.
+ */
+export function convertDatabase(entry) {
+    const { id, entity } = entry;
+    if (id !== 'default' || !isPlainObject(entity)) {
+        return {
+            type: 'skip',
+            gapId: 'databases:unsupported-shape',
+            reason: 'only the default database is typed',
+        };
+    }
+    const { databaseId, tables, ...rest } = entity;
+    const extraKeys = Object.keys(rest);
+    const idMatches = databaseId === undefined || databaseId === id;
+    const tablesTyped = tables === undefined ||
+        (isPlainObject(tables) && Object.values(tables).every((t) => t === null));
+    if (extraKeys.length > 0 || !idMatches || !tablesTyped) {
+        return {
+            type: 'skip',
+            gapId: 'databases:unsupported-shape',
+            reason: 'database keys other than null tables have no typed builder',
+        };
+    }
+    const names = isPlainObject(tables) ? Object.keys(tables) : [];
+    if (names.length === 0)
+        return { type: 'statements', statements: [] };
+    const args = names.map((name) => `    ${str(name)},\n`).join('');
+    return {
+        type: 'statements',
+        statements: [
+            {
+                code: `app.addDatabase.default.table(\n${args}  )`,
+                run: (app) => {
+                    app.addDatabase.default.table(...names);
+                },
+            },
+        ],
+    };
+}
+//# sourceMappingURL=databases.js.map

package/dist/migrator/converters/databases.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"databases.js","sourceRoot":"","sources":["../../../src/migrator/converters/databases.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAE/C,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AAGtC;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,KAAkB;IAChD,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,KAAK,CAAA;IAC5B,IAAI,EAAE,KAAK,SAAS,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;QAC/C,OAAO;YACL,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,6BAA6B;YACpC,MAAM,EAAE,oCAAoC;SAC7C,CAAA;IACH,CAAC;IACD,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAA;IAC9C,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACnC,MAAM,SAAS,GAAG,UAAU,KAAK,SAAS,IAAI,UAAU,KAAK,EAAE,CAAA;IAC/D,MAAM,WAAW,GACf,MAAM,KAAK,SAAS;QACpB,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAA;IAC3E,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,WAAW,EAAE,CAAC;QACvD,OAAO;YACL,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,6BAA6B;YACpC,MAAM,EAAE,4DAA4D;SACrE,CAAA;IACH,CAAC;IACD,MAAM,KAAK,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IAC9D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,UAAU,EAAE,EAAE,EAAE,CAAA;IACrE,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAChE,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,UAAU,EAAE;YACV;gBACE,IAAI,EAAE,mCAAmC,IAAI,KAAK;gBAClD,GAAG,EAAE,CAAC,GAAG,EAAE,EAAE;oBACX,GAAG,CAAC,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,CAAA;gBACzC,CAAC;aACF;SACF;KACF,CAAA;AACH,CAAC"}

package/dist/migrator/converters/datasources.d.ts

@@ -0,0 +1,46 @@
+import { type LegacyEntry } from '../read-solution.js';
+import { type NodePathSegment } from '../report.js';
+import { type EntityConversion } from './types.js';
+/** Where a datasource is declared: `datasources/<id>.jigx` or a jig's `datasources` map. */
+export type DatasourceScope = 'app' | 'screen';
+/** A key skipped inside a verified datasource; `path` is relative to the datasource. */
+interface DatasourceGap {
+    /** Reason slug: the gap id is `datasources:<slug>` or `jig:datasource-<slug>`. */
+    readonly slug: string;
+    readonly reason: string;
+    readonly skippedNodes: number;
+    readonly path: readonly NodePathSegment[];
+}
+export type DatasourceConversion = {
+    readonly type: 'skip';
+    readonly slug: string;
+    readonly reason: string;
+} | {
+    readonly type: 'typed';
+    /** The `<parentExpr>.addDatasource.<factory>(…)` statement at the register-body indent. */
+    readonly code: (parentExpr: string) => string;
+    /** Replays the verified calls on an `ApplicationBuilder` or a screen builder. */
+    readonly attach: (host: unknown) => void;
+    readonly gaps: readonly DatasourceGap[];
+};
+/**
+ * Converts one legacy datasource into a typed `addDatasource.<factory>(…)` call chain.
+ *
+ * - `datasource.sqlite` (local or dynamic): `entity`/`entityPackaged`, `parameter`,
+ *   `queryParameter`, `rewriteQuery`, `isDocument`, `jsonProperties`, `query`
+ * - `datasource.static`: `data` in the factory input
+ * - `datasource.reference` (screen scope only): `descriptor` plus `param` per input
+ *
+ * Optional keys and options that do not verify are skipped one by one (`key-<key>`,
+ * `option-<key>`); the whole datasource is then verified against the pruned legacy.
+ * A datasource with no typed constructor, or whose required parts do not verify, is skipped.
+ */
+export declare function convertDatasourceDefinition(options: {
+    readonly key: string;
+    readonly legacy: unknown;
+    readonly scope: DatasourceScope;
+}): DatasourceConversion;
+/** `datasources/<id>.jigx` → `app.addDatasource.<factory>(…)`; gaps are `datasources:<slug>`. */
+export declare function convertDatasource(entry: LegacyEntry): EntityConversion;
+export {};
+//# sourceMappingURL=datasources.d.ts.map

package/dist/migrator/converters/datasources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"datasources.d.ts","sourceRoot":"","sources":["../../../src/migrator/converters/datasources.ts"],"names":[],"mappings":"AAqBA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,EAAc,KAAK,eAAe,EAAE,MAAM,cAAc,CAAA;AAE/D,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAElD,4FAA4F;AAC5F,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,QAAQ,CAAA;AAE9C,wFAAwF;AACxF,UAAU,aAAa;IACrB,kFAAkF;IAClF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,IAAI,EAAE,SAAS,eAAe,EAAE,CAAA;CAC1C;AAED,MAAM,MAAM,oBAAoB,GAC5B;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACzE;IACE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;IACtB,2FAA2F;IAC3F,QAAQ,CAAC,IAAI,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,CAAA;IAC7C,iFAAiF;IACjF,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IACxC,QAAQ,CAAC,IAAI,EAAE,SAAS,aAAa,EAAE,CAAA;CACxC,CAAA;AA6bL;;;;;;;;;;;GAWG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE;IACnD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAA;CAChC,GAAG,oBAAoB,CAmBvB;AAED,iGAAiG;AACjG,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,WAAW,GAAG,gBAAgB,CAwBtE"}

package/dist/migrator/converters/datasources.js

@@ -0,0 +1,445 @@
+import { isDeepStrictEqual } from 'node:util';
+import { ApplicationBuilder, DATA_PROVIDER, DATASOURCE_TYPE, DatasourceReferenceBuilder, isPrimitiveOrExpression, ParameterValueSchema, ScreenBaseBuilderNew, SqliteDatasourceBuilder, StaticDatasourceBuilder, } from '@jigx/core-sdk';
+import { firstLine, messageSlug, toJsonValue } from '../nodes/index.js';
+import { dropUndefined, isPlainObject, normalizeEntity } from '../normalize.js';
+import { pruneAt } from '../prune.js';
+import { countNodes } from '../report.js';
+import { lit, str } from '../ts-printer.js';
+const INDENT = '  ';
+const CHAIN_INDENT = `${INDENT}  `;
+const SQLITE_KEYS = [
+    'type',
+    'options',
+    'parameters',
+    'datasourceId',
+    'instanceId',
+];
+const SQLITE_PROVIDERS = {
+    [DATA_PROVIDER.LOCAL]: 'local',
+    [DATA_PROVIDER.DYNAMIC]: 'dynamic',
+};
+function skipped(slug, reason) {
+    return { type: 'skip', slug, reason };
+}
+function comparable(value) {
+    return dropUndefined(toJsonValue(value));
+}
+function buildWith(factory, steps) {
+    try {
+        const builder = factory.create();
+        for (const step of steps)
+            step.apply(builder);
+        const built = toJsonValue(builder.build());
+        return { type: 'built', value: isPlainObject(built) ? built : {} };
+    }
+    catch (error) {
+        return { type: 'error', message: firstLine(error) };
+    }
+}
+function application(host) {
+    if (host instanceof ApplicationBuilder || host instanceof ScreenBaseBuilderNew)
+        return host;
+    throw new Error('A datasource host must be an ApplicationBuilder or a screen builder');
+}
+function screen(host) {
+    if (host instanceof ScreenBaseBuilderNew)
+        return host;
+    throw new Error('A datasource reference needs a screen builder');
+}
+function primitiveRecord(value) {
+    if (!isPlainObject(value))
+        return undefined;
+    const out = {};
+    for (const [name, item] of Object.entries(value)) {
+        if (!isPrimitiveOrExpression(item))
+            return undefined;
+        out[name] = item;
+    }
+    return out;
+}
+function isInlineData(value) {
+    return (Array.isArray(value) &&
+        value.every((item) => item === null ||
+            typeof item === 'string' ||
+            typeof item === 'number' ||
+            typeof item === 'boolean' ||
+            isPlainObject(item)));
+}
+/** Typed `.entity(…)`/`.entityPackaged(…)` call for one legacy sqlite entity. */
+function entityStep(entity) {
+    if (typeof entity === 'string') {
+        return {
+            code: `entity(${str(entity)})`,
+            apply: (builder) => {
+                builder.entity(entity);
+            },
+        };
+    }
+    if (!isPlainObject(entity) || typeof entity.entity !== 'string')
+        return undefined;
+    const name = entity.entity;
+    const keys = Object.keys(entity);
+    if (keys.length === 2 && typeof entity.package === 'string') {
+        const packageName = entity.package;
+        return {
+            code: `entityPackaged(${str(name)}, ${str(packageName)})`,
+            apply: (builder) => {
+                builder.entityPackaged(name, packageName);
+            },
+        };
+    }
+    if (!keys.every((key) => ['entity', 'function', 'functionParameters'].includes(key))) {
+        return undefined;
+    }
+    const fn = entity.function;
+    if (fn !== undefined && typeof fn !== 'string')
+        return undefined;
+    const params = entity.functionParameters === undefined ? undefined : primitiveRecord(entity.functionParameters);
+    if (entity.functionParameters !== undefined && params === undefined)
+        return undefined;
+    const input = {
+        entity: name,
+        ...(fn === undefined ? {} : { fn }),
+        ...(params === undefined ? {} : { params }),
+    };
+    return {
+        code: `entity(${lit(input, CHAIN_INDENT)})`,
+        apply: (builder) => {
+            builder.entity(structuredClone(input));
+        },
+    };
+}
+/** Typed sqlite calls for one optional legacy option; `undefined` when it has none. */
+function optionSteps(key, value) {
+    if (key === 'queryParameters') {
+        const params = primitiveRecord(value);
+        if (!params || Object.keys(params).length === 0)
+            return undefined;
+        return Object.entries(params).map(([name, item]) => ({
+            code: `queryParameter(${str(name)}, ${lit(item, CHAIN_INDENT)})`,
+            apply: (builder) => {
+                builder.queryParameter(name, item);
+            },
+        }));
+    }
+    if ((key === 'rewriteQuery' || key === 'isDocument') && typeof value === 'boolean') {
+        return [
+            {
+                code: `${key}(${String(value)})`,
+                apply: (builder) => {
+                    if (key === 'rewriteQuery')
+                        builder.rewriteQuery(value);
+                    else
+                        builder.isDocument(value);
+                },
+            },
+        ];
+    }
+    if (key === 'jsonProperties' &&
+        Array.isArray(value) &&
+        value.every((item) => typeof item === 'string')) {
+        const columns = value;
+        return [
+            {
+                code: `jsonProperties(${columns.map((column) => str(column)).join(', ')})`,
+                apply: (builder) => {
+                    builder.jsonProperties(...columns);
+                },
+            },
+        ];
+    }
+    return undefined;
+}
+function parameterDefault(value) {
+    const parsed = ParameterValueSchema.safeParse(value);
+    return parsed.success ? parsed.data : undefined;
+}
+/** Typed `.parameter(…)` calls for the legacy `parameters` map; `undefined` when one has none. */
+function parameterSteps(value) {
+    if (!isPlainObject(value) || Object.keys(value).length === 0)
+        return undefined;
+    const steps = [];
+    for (const [name, parameter] of Object.entries(value)) {
+        if (!isPlainObject(parameter) || typeof parameter.type !== 'string')
+            return undefined;
+        if (!Object.keys(parameter).every((key) => ['type', 'required', 'default'].includes(key))) {
+            return undefined;
+        }
+        const { type, required } = parameter;
+        if (required !== undefined && typeof required !== 'boolean')
+            return undefined;
+        const defaultValue = parameterDefault(parameter.default);
+        if (parameter.default !== undefined && defaultValue === undefined)
+            return undefined;
+        const options = {
+            ...(required === undefined ? {} : { required }),
+            ...(defaultValue === undefined ? {} : { defaultValue }),
+        };
+        const hasOptions = Object.keys(options).length > 0;
+        steps.push({
+            code: `parameter(${str(name)}, ${str(type)}${hasOptions ? `, ${lit(options, CHAIN_INDENT)}` : ''})`,
+            apply: (builder) => {
+                builder.parameter(name, type, hasOptions ? structuredClone(options) : undefined);
+            },
+        });
+    }
+    return steps;
+}
+/** Verifies the whole datasource against the pruned legacy and returns the typed conversion. */
+function finish(options) {
+    const { key, legacy, factory, steps, gaps } = options;
+    const whole = buildWith(factory, steps);
+    if (whole.type === 'error') {
+        return skipped(`throws-${messageSlug(whole.message)}`, `the typed datasource throws: ${whole.message}`);
+    }
+    const pruned = pruneAt({ value: legacy, path: [], gaps });
+    const equal = isDeepStrictEqual(normalizeEntity({ kind: 'datasources', id: key, entity: whole.value }), normalizeEntity({ kind: 'datasources', id: key, entity: comparable(pruned) }));
+    if (!equal) {
+        return skipped('output-differs', 'the typed datasource does not reproduce the legacy datasource');
+    }
+    return {
+        type: 'typed',
+        gaps,
+        code: (parentExpr) => `${parentExpr}.addDatasource.${factory.name}(${lit(factory.input, INDENT)})${steps
+            .map((step) => `\n${CHAIN_INDENT}.${step.code}`)
+            .join('')}`,
+        attach: (host) => {
+            const builder = factory.createOn(host);
+            for (const step of steps)
+                step.apply(builder);
+        },
+    };
+}
+function keyGap(key, value, reason) {
+    return {
+        slug: `key-${key}`,
+        reason,
+        skippedNodes: countNodes({ value, asRoot: false }),
+        path: [key],
+    };
+}
+function optionGap(key, value, reason) {
+    return {
+        slug: `option-${key}`,
+        reason,
+        skippedNodes: countNodes({ value, asRoot: false }),
+        path: ['options', key],
+    };
+}
+function convertSqlite(key, legacy) {
+    const { options, instanceId } = legacy;
+    if (!isPlainObject(options))
+        return skipped('shape', 'sqlite options must be a mapping');
+    const provider = typeof options.provider === 'string' ? SQLITE_PROVIDERS[options.provider] : undefined;
+    if (!provider)
+        return skipped('option-provider', 'only local and dynamic sqlite providers are typed');
+    const gaps = [];
+    for (const [name, value] of Object.entries(legacy)) {
+        if (!SQLITE_KEYS.includes(name))
+            gaps.push(keyGap(name, value, `no typed sqlite call for "${name}"`));
+    }
+    if (instanceId !== undefined && typeof instanceId !== 'string') {
+        gaps.push(keyGap('instanceId', instanceId, 'instanceId is not a string'));
+    }
+    const input = {
+        datasourceId: key,
+        provider,
+        ...(typeof instanceId === 'string' && instanceId !== key ? { instanceId } : {}),
+    };
+    const factory = {
+        name: 'sqlite',
+        input,
+        create: () => new SqliteDatasourceBuilder(structuredClone(input)),
+        createOn: (host) => application(host).addDatasource.sqlite(structuredClone(input)),
+    };
+    const entities = Array.isArray(options.entities) ? options.entities : [];
+    const entitySteps = entities.map((entity) => entityStep(entity));
+    if (!Array.isArray(options.entities) || entitySteps.some((step) => step === undefined)) {
+        return skipped('option-entities', 'an entity has no typed .entity() form');
+    }
+    const { query } = options;
+    if (typeof query !== 'string' || query.trim() === '') {
+        return skipped('option-query', 'the query is not a non-empty string');
+    }
+    const queryStep = {
+        code: `query(${lit(query, CHAIN_INDENT)})`,
+        apply: (builder) => {
+            builder.query(query);
+        },
+    };
+    const head = entitySteps.filter((step) => step !== undefined);
+    try {
+        const builder = factory.create();
+        for (const step of head)
+            step.apply(builder);
+    }
+    catch (error) {
+        return skipped('option-entities', `.entity() throws: ${firstLine(error)}`);
+    }
+    const base = buildWith(factory, [...head, queryStep]);
+    if (base.type === 'error') {
+        return skipped('option-query', `the typed datasource does not build: ${base.message}`);
+    }
+    const builtOptions = isPlainObject(base.value.options) ? base.value.options : {};
+    for (const name of ['provider', 'entities', 'query']) {
+        if (!isDeepStrictEqual(comparable(builtOptions[name]), comparable(options[name]))) {
+            return skipped(`option-${name}`, `the typed calls do not reproduce "${name}"`);
+        }
+    }
+    const middle = [];
+    const verifies = (candidate, read, legacyValue) => {
+        const result = buildWith(factory, [...head, ...candidate, queryStep]);
+        return (result.type === 'built' &&
+            isDeepStrictEqual(comparable(read(result.value)), comparable(legacyValue)));
+    };
+    if (legacy.parameters !== undefined) {
+        const steps = parameterSteps(legacy.parameters);
+        if (steps && verifies(steps, (built) => built.parameters, legacy.parameters)) {
+            middle.push(...steps);
+        }
+        else {
+            gaps.push(keyGap('parameters', legacy.parameters, 'no typed .parameter() calls reproduce "parameters"'));
+        }
+    }
+    for (const [name, value] of Object.entries(options)) {
+        if (name === 'provider' || name === 'entities' || name === 'query')
+            continue;
+        const steps = optionSteps(name, value);
+        const read = (built) => isPlainObject(built.options) ? built.options[name] : undefined;
+        if (steps && verifies(steps, read, value))
+            middle.push(...steps);
+        else
+            gaps.push(optionGap(name, value, `no typed sqlite call reproduces "${name}"`));
+    }
+    return finish({ key, legacy, factory, steps: [...head, ...middle, queryStep], gaps });
+}
+function convertStatic(key, legacy) {
+    const { options } = legacy;
+    if (!isPlainObject(options))
+        return skipped('shape', 'static options must be a mapping');
+    const gaps = [];
+    for (const [name, value] of Object.entries(legacy)) {
+        if (!['type', 'options', 'datasourceId', 'instanceId'].includes(name)) {
+            gaps.push(keyGap(name, value, `no typed static datasource input for "${name}"`));
+        }
+    }
+    if (legacy.instanceId !== undefined && legacy.instanceId !== key) {
+        gaps.push(keyGap('instanceId', legacy.instanceId, 'the static datasource input has no instanceId'));
+    }
+    for (const [name, value] of Object.entries(options)) {
+        if (name !== 'data')
+            gaps.push(optionGap(name, value, `no typed static datasource input for "${name}"`));
+    }
+    const { data } = options;
+    if (!isInlineData(data))
+        return skipped('option-data', 'data is not a list of values or objects');
+    const input = { datasourceId: key, data };
+    const factory = {
+        name: 'static',
+        input,
+        create: () => new StaticDatasourceBuilder(structuredClone(input)),
+        createOn: (host) => application(host).addDatasource.static(structuredClone(input)),
+    };
+    return finish({ key, legacy, factory, steps: [], gaps });
+}
+function convertReference(key, legacy) {
+    const { datasourceId, inputs } = legacy;
+    if (typeof datasourceId !== 'string')
+        return skipped('key-datasourceId', 'a reference needs a datasourceId');
+    const packageName = typeof legacy.package === 'string' ? legacy.package : undefined;
+    const gaps = [];
+    for (const [name, value] of Object.entries(legacy)) {
+        if (['type', 'datasourceId', 'inputs'].includes(name))
+            continue;
+        if (name === 'package' && packageName !== undefined)
+            continue;
+        if (name === 'instanceId' && value === key)
+            continue;
+        gaps.push(keyGap(name, value, `no typed reference input for "${name}"`));
+    }
+    const steps = [];
+    if (inputs !== undefined) {
+        const params = primitiveRecord(inputs);
+        if (params && Object.keys(params).length > 0) {
+            for (const [name, value] of Object.entries(params)) {
+                steps.push({
+                    code: `param(${str(name)}, ${lit(value, CHAIN_INDENT)})`,
+                    apply: (builder) => {
+                        builder.param(name, value);
+                    },
+                });
+            }
+        }
+        else {
+            gaps.push(keyGap('inputs', inputs, 'no typed .param() calls reproduce "inputs"'));
+        }
+    }
+    const input = {
+        instanceId: key,
+        descriptor: { datasourceId, ...(packageName === undefined ? {} : { packageName }) },
+    };
+    const factory = {
+        name: 'reference',
+        input,
+        create: () => new DatasourceReferenceBuilder(structuredClone(input)),
+        createOn: (host) => screen(host).addDatasource.reference(structuredClone(input)),
+    };
+    return finish({ key, legacy, factory, steps, gaps });
+}
+/**
+ * Converts one legacy datasource into a typed `addDatasource.<factory>(…)` call chain.
+ *
+ * - `datasource.sqlite` (local or dynamic): `entity`/`entityPackaged`, `parameter`,
+ *   `queryParameter`, `rewriteQuery`, `isDocument`, `jsonProperties`, `query`
+ * - `datasource.static`: `data` in the factory input
+ * - `datasource.reference` (screen scope only): `descriptor` plus `param` per input
+ *
+ * Optional keys and options that do not verify are skipped one by one (`key-<key>`,
+ * `option-<key>`); the whole datasource is then verified against the pruned legacy.
+ * A datasource with no typed constructor, or whose required parts do not verify, is skipped.
+ */
+export function convertDatasourceDefinition(options) {
+    const { key, legacy, scope } = options;
+    if (!isPlainObject(legacy))
+        return skipped('shape', 'a datasource must be a YAML mapping');
+    if (legacy.datasourceId !== undefined &&
+        legacy.datasourceId !== key &&
+        legacy.type !== DATASOURCE_TYPE.REFERENCE) {
+        return skipped('key-datasourceId', 'datasourceId differs from its key');
+    }
+    if (legacy.type === DATASOURCE_TYPE.SQLITE)
+        return convertSqlite(key, legacy);
+    if (legacy.type === DATASOURCE_TYPE.STATIC)
+        return convertStatic(key, legacy);
+    if (legacy.type === DATASOURCE_TYPE.REFERENCE && scope === 'screen') {
+        return convertReference(key, legacy);
+    }
+    return skipped(`type-${messageSlug(String(legacy.type))}`, `no typed ${scope === 'app' ? 'app.addDatasource' : 'screen.addDatasource'} factory for ${String(legacy.type)}`);
+}
+/** `datasources/<id>.jigx` → `app.addDatasource.<factory>(…)`; gaps are `datasources:<slug>`. */
+export function convertDatasource(entry) {
+    const { id, entity } = entry;
+    const result = convertDatasourceDefinition({ key: id, legacy: entity, scope: 'app' });
+    if (result.type === 'skip') {
+        return { type: 'skip', gapId: `datasources:${result.slug}`, reason: result.reason };
+    }
+    return {
+        type: 'statements',
+        gaps: result.gaps.map(({ slug, reason, skippedNodes, path }) => ({
+            gapId: `datasources:${slug}`,
+            nodeType: 'datasources',
+            reason,
+            skippedNodes,
+            path,
+        })),
+        statements: [
+            {
+                code: result.code('app'),
+                run: (app) => {
+                    result.attach(app);
+                },
+            },
+        ],
+    };
+}
+//# sourceMappingURL=datasources.js.map

package/dist/migrator/converters/datasources.js.map

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

package/dist/migrator/converters/functions.d.ts

@@ -0,0 +1,13 @@
+import { type LegacyEntry } from '../read-solution.js';
+import { type EntityConversion } from './types.js';
+/**
+ * `functions/<id>.jigx` (REST) → `app.addFunction.rest({ functionId, method, url, … })`,
+ * one `fn.params.<location>(…)` call per parameter and one typed call per function key.
+ *
+ * Every call is verified on a scratch builder. A parameter that does not verify is skipped
+ * as `functions:param-<location>-<reason>`, a key as `functions:key-<key>`; the rest of the
+ * function stays typed. The whole function is then verified against the pruned legacy.
+ * A non-REST provider or a constructor that cannot reproduce the legacy is an entity-level gap.
+ */
+export declare function convertFunction(entry: LegacyEntry): EntityConversion;
+//# sourceMappingURL=functions.d.ts.map

package/dist/migrator/converters/functions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"functions.d.ts","sourceRoot":"","sources":["../../../src/migrator/converters/functions.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAGtD,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAsSlD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,WAAW,GAAG,gBAAgB,CAsKpE"}