aimeat 3.2.0 → 3.3.0

package/dist/src/services/datapackage/ext-capability.d.ts

@@ -0,0 +1,85 @@
+/**
+ * @file src/services/datapackage/ext-capability.ts
+ * @description `ctx.datapackage` — the data-package contract as a HOST capability, because a
+ *   sandboxed extension cannot load a shared library and the deterministic producers live there.
+ *
+ *   WHY A HOST CAPABILITY AND NOT A LIBRARY. Extension actions run in QuickJS with no module
+ *   loader: the guest sees `ctx` and nothing else, and `ctx.fetch` answers with `text`, so even
+ *   pulling the library over HTTP and eval'ing it is not a road. That was the open question in the
+ *   spec, and this is the decided answer — the library's WORK (schema inference, validation, the
+ *   content hash, canonical CSV, the storage writes, the catalogue entry) happens on the host, and
+ *   the guest calls it. The browser binding and the MCP tools reach the SAME functions in
+ *   ./store.js, so a package built by an extension, an app and an agent is byte-identical.
+ *
+ *   PUBLISH THROWS WHEN THE GATE REFUSES. It does not return `{ ok: false }`, and that is not an
+ *   ergonomic preference: the scheduler and the workflow engine both record a normal return as a
+ *   successful run, so a producer whose data failed validation would show green having published
+ *   nothing. A throw is the only shape that reaches the owner on every road. `validate()` is the
+ *   separate, non-throwing call for a producer that wants to look before it leaps.
+ *
+ *   THE SIZE CEILING IS THE BRIDGE, not the file limit. Rows cross as one JSON string through
+ *   `vm.getString`, inside a sandbox whose memory ceiling is tens of megabytes, so the payload is
+ *   capped at the same 8 MB as `ctx.files` — one number for "what may cross in one call", refused
+ *   with a message naming the alternative rather than left to exhaust the VM.
+ * @structure makeExtensionDataPackage — the ctx.datapackage factory
+ * @usage
+ *   const datapackage = makeExtensionDataPackage({ storage, config, ownerGhii, producedBy });
+ *   const ctx = buildExtensionCtx({ …, datapackage });
+ * @version-history
+ *   v1.0.0 -- 2026-08-15 -- Initial (TARGET-063 vaihe 1, A4).
+ */
+import type { AimeatConfig } from '../../config.js';
+import type { Storage } from '../../storage/interface.js';
+import type { PublishInput, TableSchema } from './contract.js';
+import { type ValidationIssue } from './table.js';
+import { type ProducedBy } from './store.js';
+/** What may cross the sandbox bridge in one call, as serialised JSON. Same number as ctx.files. */
+export declare const MAX_DATAPACKAGE_PAYLOAD_BYTES: number;
+export interface ExtensionDataPackage {
+    publish(input: PublishInput): Promise<{
+        packageId: string;
+        contentHash: string;
+        descriptorUrl: string;
+        unchanged: boolean;
+        resources: Array<{
+            name: string;
+            url: string;
+            rowCount: number;
+            bytes: number;
+        }>;
+    }>;
+    validate(resources: Array<{
+        name: string;
+        rows: Array<Record<string, unknown>>;
+        schema: 'infer' | TableSchema;
+    }>): Promise<{
+        ok: boolean;
+        issues: ValidationIssue[];
+        schemas: Record<string, TableSchema>;
+    }>;
+    inferSchema(rows: Array<Record<string, unknown>>): Promise<TableSchema>;
+    open(ref: string): Promise<unknown | null>;
+    rows(ref: string, resource: string, opts?: {
+        offset?: number;
+        limit?: number;
+        select?: string[];
+    }): Promise<{
+        rows: Array<Record<string, unknown>>;
+        total: number;
+        schema: TableSchema;
+    } | null>;
+    fail(name: string, message: string): Promise<void>;
+}
+export declare function makeExtensionDataPackage(deps: {
+    config: AimeatConfig;
+    storage: Storage;
+    /**
+     * WHOSE package this is. Always the owner's GHII, on every road — never the agent GAII and never
+     * `scheduler@node`. A package produced from the app, on a clock, by a workflow step or by an
+     * agent must land at ONE permanent address, or the producer is not interchangeable.
+     */
+    ownerGhii: string;
+    /** Who actually produced it, for the provenance block. The exact principal, not the owner. */
+    producedBy: ProducedBy;
+}): ExtensionDataPackage;
+//# sourceMappingURL=ext-capability.d.ts.map

package/dist/src/services/datapackage/ext-capability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ext-capability.d.ts","sourceRoot":"","sources":["../../../../src/services/datapackage/ext-capability.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,EAA6B,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7E,OAAO,EAAwD,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAEnG,mGAAmG;AACnG,eAAO,MAAM,6BAA6B,QAAkB,CAAC;AAE7D,MAAM,WAAW,oBAAoB;IACjC,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC;QAClC,SAAS,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAC;QAClF,SAAS,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACpF,CAAC,CAAC;IACH,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QAAC,MAAM,EAAE,OAAO,GAAG,WAAW,CAAA;KAAE,CAAC,GAC5G,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,eAAe,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;KAAE,CAAC,CAAC;IAC9F,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACxE,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAC3C,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAC7F,OAAO,CAAC;QAAE,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,WAAW,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IACjG,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtD;AAaD,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAC3C,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,8FAA8F;IAC9F,UAAU,EAAE,UAAU,CAAC;CAC1B,GAAG,oBAAoB,CA+DvB"}

package/dist/src/services/datapackage/ext-capability.js

@@ -0,0 +1,72 @@
+import { inferSchema, validateRows } from './table.js';
+import { openPackage, publishPackage, readRows, recordFailure } from './store.js';
+/** What may cross the sandbox bridge in one call, as serialised JSON. Same number as ctx.files. */
+export const MAX_DATAPACKAGE_PAYLOAD_BYTES = 8 * 1024 * 1024;
+/** Refuse an oversized payload at the boundary, naming what to do instead. */
+function guardSize(what, value) {
+    const bytes = Buffer.byteLength(JSON.stringify(value ?? null), 'utf8');
+    if (bytes > MAX_DATAPACKAGE_PAYLOAD_BYTES) {
+        throw new Error(`${what} is ${Math.round(bytes / 1024)} kB, over the ${MAX_DATAPACKAGE_PAYLOAD_BYTES / 1024 / 1024} MB sandbox `
+            + 'bridge limit. Publish the table in periods (one package version per window) rather than one '
+            + 'unbounded version, or produce it from a road with no sandbox between it and the data.');
+    }
+}
+export function makeExtensionDataPackage(deps) {
+    const { config, storage, ownerGhii, producedBy } = deps;
+    const store = { storage, config };
+    return {
+        async publish(input) {
+            guardSize('the package payload', input);
+            const out = await publishPackage(store, ownerGhii, input, producedBy);
+            if (!out.ok) {
+                // THROW, do not return a verdict. See the file header: an unattended road records a
+                // normal return as success, so a returned refusal is a green run that published
+                // nothing. The first coordinates travel in the message because a producer reading a
+                // log needs the row and the column, not a count.
+                const head = out.issues.slice(0, 5)
+                    .map(i => `${i.resource} row ${i.row}, ${i.field}: ${i.message}`)
+                    .join('; ');
+                throw new Error(`${out.code}: ${out.message}${head ? ` — ${head}` : ''}`);
+            }
+            return {
+                packageId: out.descriptor.aimeat.packageId,
+                contentHash: out.contentHash,
+                descriptorUrl: out.descriptorUrl,
+                unchanged: out.unchanged,
+                resources: out.resources,
+            };
+        },
+        async validate(resources) {
+            guardSize('the resources to validate', resources);
+            const issues = [];
+            const schemas = {};
+            for (const r of Array.isArray(resources) ? resources : []) {
+                const schema = r.schema === 'infer' ? inferSchema(r.rows ?? []) : r.schema;
+                schemas[r.name] = schema;
+                issues.push(...validateRows(r.name, r.rows ?? [], schema));
+            }
+            return { ok: issues.length === 0, issues, schemas };
+        },
+        async inferSchema(rows) {
+            guardSize('the rows to infer from', rows);
+            // A PROPOSAL. It is returned so the producer can look at it, adjust it and declare it;
+            // publishing with `schema: 'infer'` records `schemaSource: 'inferred'` in the descriptor
+            // so a consumer can see that nobody confirmed the types.
+            return inferSchema(Array.isArray(rows) ? rows : []);
+        },
+        async open(ref) {
+            const opened = await openPackage(store, String(ref || ''), config.nodeId);
+            return opened ? { ...opened.descriptor, descriptorUrl: opened.descriptorUrl } : null;
+        },
+        async rows(ref, resource, opts) {
+            return readRows(store, String(ref || ''), config.nodeId, String(resource || ''), opts ?? {});
+        },
+        async fail(name, message) {
+            // The producer saying so itself, for the case it can detect and the road cannot: an
+            // upstream that answered with an empty body, a source that returned yesterday's file.
+            // The run should ALSO throw; this is what leaves the reason on the package.
+            await recordFailure(store, ownerGhii, String(name || ''), String(message || 'the run failed'));
+        },
+    };
+}
+//# sourceMappingURL=ext-capability.js.map

package/dist/src/services/datapackage/ext-capability.js.map

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

package/dist/src/services/datapackage/odata.d.ts

@@ -0,0 +1,92 @@
+/**
+ * @file src/services/datapackage/odata.ts
+ * @description The OData v4 projection of a data package: CSDL metadata from the Table Schema, and
+ *   the readable subset of the query language applied to rows. Pure — no HTTP, no storage.
+ *
+ *   WHY OData AT ALL, when the CSV already sits at a permanent address. Excel, Power BI and Tableau
+ *   have a native "OData feed" connector: a person pastes one URL and the workbook REFRESHES ITSELF
+ *   afterwards. A CSV link is a download, and a download is a copy that starts going stale the moment
+ *   it lands. This is the difference between a dataset somebody uses once and one they keep.
+ *
+ *   AN UNSUPPORTED QUERY OPTION IS AN ERROR, NEVER AN IGNORED ONE. This is the rule the whole file
+ *   is shaped around. If a client sends `$filter=weird(x)` and the server ignores it, the client
+ *   receives MORE ROWS THAN IT ASKED FOR and treats them as the answer — a silent wrong result that
+ *   looks exactly like a right one. So anything this implementation does not understand answers 501
+ *   naming what it does understand. A visibly missing feature is cheap; a filter that quietly did
+ *   nothing is a wrong number in somebody's report.
+ *
+ *   ONE SCHEMA, MANY PROJECTIONS. The Table Schema in the descriptor is the only place columns and
+ *   types are declared. The CSDL here, the CSV header, the ODPS product sheet and an agent's view of
+ *   the package are all derived from it, so none of them can drift from the data.
+ * @structure toCsdl · parseQuery · applyQuery · ODATA_SUPPORTED
+ * @usage
+ *   const xml = toCsdl(descriptor, 'https://…/v1/odata/alice/pkg');
+ *   const q = parseQuery(searchParams, resource.schema);
+ *   if (!q.ok) return 501;
+ *   const page = applyQuery(rows, q.value);
+ * @version-history
+ *   v1.0.0 -- 2026-08-15 -- Initial (TARGET-063 vaihe 1, the OData surface).
+ */
+import type { Descriptor, TableSchema } from './contract.js';
+/** Every system query option this implementation honours. Anything else is refused by name. */
+export declare const ODATA_SUPPORTED: readonly ["$select", "$top", "$skip", "$filter", "$orderby", "$count", "$format"];
+/** The synthetic key. A CSV row has no identity of its own, and OData requires an entity key — so
+ *  one is supplied rather than a natural column being promoted to a role it cannot fill. It is the
+ *  row's ordinal WITHIN THIS IMMUTABLE VERSION, which is stable precisely because the version is. */
+export declare const ROW_KEY = "RowId";
+/** A CSDL identifier: letters, digits and underscore, not starting with a digit. A column called
+ *  `first name` or `2026` is legal in a CSV and illegal here, so it is mapped rather than rejected —
+ *  and the mapping is recorded in the descriptor's own field name, which does not change. */
+export declare function edmName(raw: string): string;
+/**
+ * The CSDL v4 document (`$metadata`) for one package version.
+ *
+ * `Nullable="true"` on every property except the key, deliberately: a Table Schema's `primaryKey` is
+ * the only statement anybody made about required-ness, and claiming a column is non-nullable because
+ * it happened to be full in this version would be a promise the next version breaks.
+ */
+export declare function toCsdl(descriptor: Descriptor, namespace: string): string;
+export interface FilterNode {
+    field: string;
+    op: 'eq' | 'ne' | 'gt' | 'ge' | 'lt' | 'le' | 'contains' | 'startswith' | 'endswith';
+    value: string | number | boolean | null;
+}
+export interface ParsedQuery {
+    select?: string[];
+    top?: number;
+    skip: number;
+    /** ANDed together. `or` is not supported, and saying so is the point — see the file header. */
+    filters: FilterNode[];
+    orderby: Array<{
+        field: string;
+        desc: boolean;
+    }>;
+    count: boolean;
+}
+export type ParseResult = {
+    ok: true;
+    value: ParsedQuery;
+} | {
+    ok: false;
+    code: 'NOT_IMPLEMENTED' | 'BAD_REQUEST';
+    message: string;
+};
+/**
+ * Read the system query options, refusing everything not understood.
+ *
+ * The `edmName` mapping runs in both directions here: a client saw `first_name` in the metadata and
+ * sends `$filter=first_name eq 'x'`, while the row still holds `first name`. Resolving through the
+ * schema means the client only ever has to know the names the metadata gave it.
+ */
+export declare function parseQuery(params: URLSearchParams, schema: TableSchema): ParseResult;
+export interface QueryPage {
+    rows: Array<Record<string, unknown>>;
+    /** Rows matching the filter, BEFORE $top/$skip — what `$count=true` reports. */
+    matched: number;
+}
+/**
+ * Apply the parsed query. `RowId` is assigned before filtering, so a row keeps the same key whatever
+ * a client asks for — a key that shifted with the query would make the entity identity meaningless.
+ */
+export declare function applyQuery(rows: Array<Record<string, unknown>>, q: ParsedQuery, schema: TableSchema): QueryPage;
+//# sourceMappingURL=odata.d.ts.map

package/dist/src/services/datapackage/odata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"odata.d.ts","sourceRoot":"","sources":["../../../../src/services/datapackage/odata.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,OAAO,KAAK,EAAE,UAAU,EAAiC,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5F,+FAA+F;AAC/F,eAAO,MAAM,eAAe,mFAAoF,CAAC;AAajH;;qGAEqG;AACrG,eAAO,MAAM,OAAO,UAAU,CAAC;AAQ/B;;6FAE6F;AAC7F,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG3C;AAED;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAqBxE;AAeD,MAAM,WAAW,UAAU;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,UAAU,GAAG,YAAY,GAAG,UAAU,CAAC;IACrF,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;CAC3C;AAED,MAAM,WAAW,WAAW;IACxB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,+FAA+F;IAC/F,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,OAAO,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACjD,KAAK,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,MAAM,WAAW,GACjB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,WAAW,CAAA;CAAE,GAChC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,iBAAiB,GAAG,aAAa,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAiB9E;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,WAAW,GAAG,WAAW,CAsFpF;AAmDD,MAAM,WAAW,SAAS;IACtB,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACrC,gFAAgF;IAChF,OAAO,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,GAAG,SAAS,CAqB/G"}

package/dist/src/services/datapackage/odata.js

@@ -0,0 +1,256 @@
+/** Every system query option this implementation honours. Anything else is refused by name. */
+export const ODATA_SUPPORTED = ['$select', '$top', '$skip', '$filter', '$orderby', '$count', '$format'];
+/** Frictionless type → EDM primitive. The one mapping; nothing else decides an OData type. */
+const EDM = {
+    string: 'Edm.String',
+    integer: 'Edm.Int64',
+    number: 'Edm.Double',
+    boolean: 'Edm.Boolean',
+    date: 'Edm.Date',
+    datetime: 'Edm.DateTimeOffset',
+    any: 'Edm.String',
+};
+/** The synthetic key. A CSV row has no identity of its own, and OData requires an entity key — so
+ *  one is supplied rather than a natural column being promoted to a role it cannot fill. It is the
+ *  row's ordinal WITHIN THIS IMMUTABLE VERSION, which is stable precisely because the version is. */
+export const ROW_KEY = 'RowId';
+/** XML text, escaped. A field name comes from the producer's data, so it is not trusted markup. */
+function xml(s) {
+    return String(s).replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;').replace(/'/g, '&apos;');
+}
+/** A CSDL identifier: letters, digits and underscore, not starting with a digit. A column called
+ *  `first name` or `2026` is legal in a CSV and illegal here, so it is mapped rather than rejected —
+ *  and the mapping is recorded in the descriptor's own field name, which does not change. */
+export function edmName(raw) {
+    const cleaned = String(raw).replace(/[^A-Za-z0-9_]/g, '_');
+    return /^[0-9]/.test(cleaned) ? `_${cleaned}` : (cleaned || '_');
+}
+/**
+ * The CSDL v4 document (`$metadata`) for one package version.
+ *
+ * `Nullable="true"` on every property except the key, deliberately: a Table Schema's `primaryKey` is
+ * the only statement anybody made about required-ness, and claiming a column is non-nullable because
+ * it happened to be full in this version would be a promise the next version breaks.
+ */
+export function toCsdl(descriptor, namespace) {
+    // A CSDL namespace is a DOTTED identifier ("AIMEAT.shortages"), so each segment is sanitised and
+    // the dots survive. Running edmName over the whole string turned the separator into an
+    // underscore, and the EntitySet then named a type in a namespace nobody had declared.
+    const ns = String(namespace).split('.').map(edmName).join('.');
+    const types = descriptor.resources.map(r => entityType(r, ns)).join('\n');
+    const sets = descriptor.resources
+        .map(r => `        <EntitySet Name="${xml(edmName(r.name))}" EntityType="${xml(ns)}.${xml(edmName(r.name))}"/>`)
+        .join('\n');
+    return `<?xml version="1.0" encoding="utf-8"?>
+<edmx:Edmx Version="4.0" xmlns:edmx="http://docs.oasis-open.org/odata/ns/edmx">
+  <edmx:DataServices>
+    <Schema Namespace="${xml(ns)}" xmlns="http://docs.oasis-open.org/odata/ns/edm">
+${types}
+      <EntityContainer Name="Container">
+${sets}
+      </EntityContainer>
+    </Schema>
+  </edmx:DataServices>
+</edmx:Edmx>
+`;
+}
+function entityType(resource, _ns) {
+    const props = resource.schema.fields
+        .map(f => `        <Property Name="${xml(edmName(f.name))}" Type="${EDM[f.type] ?? 'Edm.String'}" Nullable="true"/>`)
+        .join('\n');
+    return `      <EntityType Name="${xml(edmName(resource.name))}">
+        <Key><PropertyRef Name="${ROW_KEY}"/></Key>
+        <Property Name="${ROW_KEY}" Type="Edm.Int64" Nullable="false"/>
+${props}
+      </EntityType>`;
+}
+const COMPARISON = /^\s*([A-Za-z_][A-Za-z0-9_]*)\s+(eq|ne|gt|ge|lt|le)\s+(.+?)\s*$/;
+const FUNCTION = /^\s*(contains|startswith|endswith)\s*\(\s*([A-Za-z_][A-Za-z0-9_]*)\s*,\s*(.+?)\s*\)\s*$/;
+/** An OData literal: a quoted string (with '' for an embedded quote), a number, true/false, null. */
+function literal(raw) {
+    const s = raw.trim();
+    if (/^'.*'$/s.test(s))
+        return s.slice(1, -1).replace(/''/g, "'");
+    if (/^-?\d+$/.test(s))
+        return parseInt(s, 10);
+    if (/^-?\d*\.\d+([eE][+-]?\d+)?$/.test(s))
+        return parseFloat(s);
+    if (s === 'true')
+        return true;
+    if (s === 'false')
+        return false;
+    if (s === 'null')
+        return null;
+    return undefined; // not a literal this implementation reads
+}
+/**
+ * Read the system query options, refusing everything not understood.
+ *
+ * The `edmName` mapping runs in both directions here: a client saw `first_name` in the metadata and
+ * sends `$filter=first_name eq 'x'`, while the row still holds `first name`. Resolving through the
+ * schema means the client only ever has to know the names the metadata gave it.
+ */
+export function parseQuery(params, schema) {
+    // Every field, addressable by the name the metadata published.
+    const byEdm = new Map(schema.fields.map(f => [edmName(f.name), f.name]));
+    byEdm.set(ROW_KEY, ROW_KEY);
+    for (const key of params.keys()) {
+        if (!key.startsWith('$'))
+            continue; // a custom parameter is the caller's business
+        if (!ODATA_SUPPORTED.includes(key)) {
+            return {
+                ok: false, code: 'NOT_IMPLEMENTED',
+                message: `${key} is not implemented on this feed. Supported: ${ODATA_SUPPORTED.join(', ')}. `
+                    + 'It is refused rather than ignored, because an ignored query option returns more rows '
+                    + 'than you asked for and looks like an answer.',
+            };
+        }
+    }
+    const out = { skip: 0, filters: [], orderby: [], count: false };
+    const select = params.get('$select');
+    if (select) {
+        const names = [];
+        for (const raw of select.split(',').map(s => s.trim()).filter(Boolean)) {
+            const real = byEdm.get(raw);
+            if (!real)
+                return { ok: false, code: 'BAD_REQUEST', message: `$select names no such property: ${raw}` };
+            names.push(real);
+        }
+        out.select = names;
+    }
+    for (const [name, target] of [['$top', 'top'], ['$skip', 'skip']]) {
+        const raw = params.get(name);
+        if (raw === null)
+            continue;
+        const n = Number(raw);
+        if (!Number.isInteger(n) || n < 0) {
+            return { ok: false, code: 'BAD_REQUEST', message: `${name} must be a non-negative integer, got "${raw}"` };
+        }
+        if (target === 'top')
+            out.top = n;
+        else
+            out.skip = n;
+    }
+    const count = params.get('$count');
+    if (count !== null) {
+        if (count !== 'true' && count !== 'false') {
+            return { ok: false, code: 'BAD_REQUEST', message: `$count must be true or false, got "${count}"` };
+        }
+        out.count = count === 'true';
+    }
+    const orderby = params.get('$orderby');
+    if (orderby) {
+        for (const clause of orderby.split(',').map(s => s.trim()).filter(Boolean)) {
+            const [field, dir] = clause.split(/\s+/);
+            const real = byEdm.get(field);
+            if (!real)
+                return { ok: false, code: 'BAD_REQUEST', message: `$orderby names no such property: ${field}` };
+            if (dir && dir !== 'asc' && dir !== 'desc') {
+                return { ok: false, code: 'BAD_REQUEST', message: `$orderby direction must be asc or desc, got "${dir}"` };
+            }
+            out.orderby.push({ field: real, desc: dir === 'desc' });
+        }
+    }
+    const filter = params.get('$filter');
+    if (filter) {
+        // `or` and `not` get their OWN refusal, ahead of everything else, because the split below is
+        // on `and`: an `or` left in would be silently torn into two ANDed clauses and match FEWER
+        // rows than asked for, with no symptom at all. Tested with string literals blanked first, so
+        // `name eq 'or'` is data rather than an operator.
+        const bare = filter.replace(/'(?:[^']|'')*'/g, "''");
+        if (/\bor\b/i.test(bare) || /\bnot\b/i.test(bare)) {
+            return {
+                ok: false, code: 'NOT_IMPLEMENTED',
+                message: '$filter supports `field op value` clauses joined by `and`, plus contains(), '
+                    + 'startswith() and endswith(). `or` and `not` are not implemented. Refused rather '
+                    + 'than partly applied: a filter this server half-understood would return the wrong '
+                    + 'rows and look like an answer.',
+            };
+        }
+        // Anything else fails per CLAUSE, which is where the message can name the offending text.
+        for (const clause of filter.split(/\s+and\s+/i)) {
+            const node = parseClause(clause, byEdm);
+            if ('message' in node)
+                return { ok: false, code: node.code, message: node.message };
+            out.filters.push(node);
+        }
+    }
+    return { ok: true, value: out };
+}
+function parseClause(clause, byEdm) {
+    const fn = FUNCTION.exec(clause);
+    if (fn) {
+        const real = byEdm.get(fn[2]);
+        if (!real)
+            return { code: 'BAD_REQUEST', message: `$filter names no such property: ${fn[2]}` };
+        const v = literal(fn[3]);
+        if (v === undefined)
+            return { code: 'BAD_REQUEST', message: `$filter value not understood: ${fn[3]}` };
+        return { field: real, op: fn[1], value: v };
+    }
+    const cmp = COMPARISON.exec(clause);
+    if (cmp) {
+        const real = byEdm.get(cmp[1]);
+        if (!real)
+            return { code: 'BAD_REQUEST', message: `$filter names no such property: ${cmp[1]}` };
+        const v = literal(cmp[3]);
+        if (v === undefined)
+            return { code: 'BAD_REQUEST', message: `$filter value not understood: ${cmp[3]}` };
+        return { field: real, op: cmp[2], value: v };
+    }
+    return {
+        code: 'NOT_IMPLEMENTED',
+        message: `$filter clause not understood: "${clause.trim()}". This feed reads `
+            + '`field eq|ne|gt|ge|lt|le value` and contains/startswith/endswith(field, \'value\'), joined by `and`.',
+    };
+}
+/** Comparable form: a date string sorts and compares correctly as a string because it is ISO 8601. */
+function cmpValue(a, b) {
+    if (a === null || a === undefined)
+        return b === null || b === undefined ? 0 : -1;
+    if (b === null || b === undefined)
+        return 1;
+    if (typeof a === 'number' && typeof b === 'number')
+        return a - b;
+    return String(a) < String(b) ? -1 : String(a) > String(b) ? 1 : 0;
+}
+function matches(row, f) {
+    const v = row[f.field];
+    switch (f.op) {
+        case 'eq': return cmpValue(v, f.value) === 0;
+        case 'ne': return cmpValue(v, f.value) !== 0;
+        case 'gt': return cmpValue(v, f.value) > 0;
+        case 'ge': return cmpValue(v, f.value) >= 0;
+        case 'lt': return cmpValue(v, f.value) < 0;
+        case 'le': return cmpValue(v, f.value) <= 0;
+        case 'contains': return String(v ?? '').includes(String(f.value));
+        case 'startswith': return String(v ?? '').startsWith(String(f.value));
+        case 'endswith': return String(v ?? '').endsWith(String(f.value));
+    }
+}
+/**
+ * Apply the parsed query. `RowId` is assigned before filtering, so a row keeps the same key whatever
+ * a client asks for — a key that shifted with the query would make the entity identity meaningless.
+ */
+export function applyQuery(rows, q, schema) {
+    let out = rows.map((r, i) => ({ [ROW_KEY]: i, ...r }));
+    for (const f of q.filters)
+        out = out.filter(r => matches(r, f));
+    const matched = out.length;
+    for (const o of [...q.orderby].reverse()) {
+        out = [...out].sort((a, b) => (o.desc ? -1 : 1) * cmpValue(a[o.field], b[o.field]));
+    }
+    out = out.slice(q.skip, q.top === undefined ? undefined : q.skip + q.top);
+    if (q.select) {
+        const keep = new Set([ROW_KEY, ...q.select]);
+        out = out.map(r => Object.fromEntries(Object.entries(r).filter(([k]) => keep.has(k))));
+    }
+    // Property names go back out as the metadata published them, which is what the client asked with.
+    const rename = new Map(schema.fields.map(f => [f.name, edmName(f.name)]));
+    return {
+        rows: out.map(r => Object.fromEntries(Object.entries(r).map(([k, v]) => [rename.get(k) ?? k, v]))),
+        matched,
+    };
+}
+//# sourceMappingURL=odata.js.map

package/dist/src/services/datapackage/odata.js.map

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

package/dist/src/services/datapackage/odps.d.ts

@@ -0,0 +1,24 @@
+import { type Descriptor } from './contract.js';
+/** Where the generated sheet sits, beside the descriptor it was projected from. */
+export declare const odpsYamlKey: (name: string, contentHash: string) => string;
+export interface OdpsProjectionInput {
+    descriptor: Descriptor;
+    ownerGhii: string;
+    baseUrl: string;
+    /** The permanent, session-free URL of each resource's CSV, keyed by resource name. */
+    resourceUrls: Record<string, string>;
+    descriptorUrl: string;
+    /** ISO 639-1 language the `details` block is keyed by. v4.1 requires the map. */
+    lang?: string;
+}
+/**
+ * Project one published version into an ODPS v4.1 document.
+ *
+ * Everything traces to the descriptor. `status` is 'production' because a published version at a
+ * permanent immutable address is exactly that — a draft is a thing that has not been published, and
+ * this function only ever sees published ones.
+ */
+export declare function descriptorToOdps(input: OdpsProjectionInput): Record<string, unknown>;
+/** The generated sheet as YAML — the format ODPS leads with. */
+export declare function odpsToYamlDocument(doc: Record<string, unknown>): string;
+//# sourceMappingURL=odps.d.ts.map

package/dist/src/services/datapackage/odps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"odps.d.ts","sourceRoot":"","sources":["../../../../src/services/datapackage/odps.ts"],"names":[],"mappings":"AA6BA,OAAO,EAAwB,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAEtE,mFAAmF;AACnF,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,EAAE,aAAa,MAAM,KAAG,MACJ,CAAC;AA0B7D,MAAM,WAAW,mBAAmB;IAChC,UAAU,EAAE,UAAU,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,sFAAsF;IACtF,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,aAAa,EAAE,MAAM,CAAC;IACtB,iFAAiF;IACjF,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoHpF;AAED,gEAAgE;AAChE,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAEvE"}