aimeat 2.1.0 → 2.2.0

package/dist/src/models/odps-schemas.d.ts

@@ -0,0 +1,305 @@
+/**
+ * @file src/models/odps-schemas.ts
+ * @description The ODPS (Open Data Product Specification, Linux Foundation) authoring contract for an
+ *   EXCHANGE offering. AIMEAT derives most of an ODPS v4.1 document from what the node already knows
+ *   (title, price, plans, licence, provider, observed usage — see services/exchange-odps.ts); these are the
+ *   fields ODPS defines that the node CANNOT derive and a provider may therefore declare on the listing:
+ *   the product framing (value proposition, categories, standards, use cases, sample), the SLA + data-quality
+ *   COMMITMENTS (objectives, which are promises no observation can substitute for), and the legal data holder.
+ *   Everything here is optional — an offering without it still projects a valid ODPS v4.1 document.
+ *   PROVENANCE lives here too: the provider's attestation about where the data came from, on what legal
+ *   basis, how long it is kept, and (for derived data) the upstream lineage it was built from.
+ * @structure ODPS enums (product type · SLA/DQ dimensions + units) · ProvenanceSchema · OdpsExtrasSchema ·
+ *   inferred types (Provenance · OdpsExtras · OdpsSlaDimension · OdpsQualityDimension · OdpsDataHolder)
+ * @usage
+ *   const parsed = OdpsExtrasSchema.safeParse(req.body.odps);
+ *   if (!parsed.success) return res.status(400).json(error(nodeId, 'INVALID_ODPS', parsed.error.message));
+ * @version-history
+ *   v1.1.0 — 2026-07-25 — Pinned to ODPS v4.1 (the version the addendum's Q2 named): `language` (v4.1
+ *     keys details + pricing by ISO 639-1 code), `governanceProfile`, `portfolioPriority`, TOON format.
+ *   v1.0.0 — 2026-07-25 — Initial ODPS authoring contract + provenance attestation (TARGET-045 §4,
+ *     addendum Q2/Q3): closes the drift where `odpsVersion` was declared but never written.
+ */
+import { z } from 'zod';
+/** ODPS v4.1 `product.details.type` — what KIND of data product this is. */
+export declare const ODPS_PRODUCT_TYPES: readonly ["raw data", "derived data", "dataset", "reports", "analytic view", "3D visualisation", "algorithm", "decision support", "automated decision-making", "data-enhanced product", "data-driven service", "data-enabled performance", "bi-directional"];
+/** ODPS v4.1 SLA dimensions (`product.SLA.declarative[].dimensions[].dimension`). */
+export declare const ODPS_SLA_DIMENSIONS: readonly ["latency", "uptime", "responseTime", "errorRate", "endOfSupport", "endOfLife", "updateFrequency", "timeToDetect", "timeToNotify", "timeToRepair", "emailResponseTime"];
+/** ODPS v4.1 SLA objective units. */
+export declare const ODPS_SLA_UNITS: readonly ["percent", "milliseconds", "seconds", "minutes", "days", "weeks", "months", "years", "never", "date", "null"];
+/** ODPS v4.1 data-quality dimensions. */
+export declare const ODPS_QUALITY_DIMENSIONS: readonly ["accuracy", "completeness", "conformity", "consistency", "coverage", "timeliness", "validity", "uniqueness"];
+/** ODPS v4.1 output file formats a data product can be delivered in (v4.1 adds TOON). */
+export declare const ODPS_OUTPUT_FORMATS: readonly ["TOON", "JSON", "XML", "CSV", "Excel", "zip", "plain text", "GraphQL", "MCP"];
+/** ODPS v4.1 `details.governanceProfile` — how strictly the product is governed. */
+export declare const ODPS_GOVERNANCE_PROFILES: readonly ["structured", "enforced", "automated", "audit_ready"];
+/** ODPS v4.1 `details.portfolioPriority` — how important the product is in its owner's portfolio. */
+export declare const ODPS_PORTFOLIO_PRIORITIES: readonly ["critical", "high", "medium", "low"];
+/** One hop of upstream lineage for DERIVED data — where a component came from and what was done to it. */
+export declare const ProvenanceLineageHopSchema: z.ZodObject<{
+    source: z.ZodString;
+    transform: z.ZodOptional<z.ZodString>;
+    at: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * The provider's provenance attestation. A PROMISE by the provider, not a platform guarantee — but a
+ * structured, attributed one (the provider is a GHII/GAII/GEAI) that a buyer can hold them to. Maps onto
+ * ODPS `license.governance` + the AIMEAT extension block; absent provenance is legal, it just reads as
+ * "unstated" to every buyer looking at the listing.
+ */
+export declare const ProvenanceSchema: z.ZodObject<{
+    source: z.ZodOptional<z.ZodString>;
+    legalBasis: z.ZodOptional<z.ZodString>;
+    consentStatus: z.ZodOptional<z.ZodString>;
+    retention: z.ZodOptional<z.ZodString>;
+    transformations: z.ZodOptional<z.ZodString>;
+    snapshotHash: z.ZodOptional<z.ZodString>;
+    lineage: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        source: z.ZodString;
+        transform: z.ZodOptional<z.ZodString>;
+        at: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    odpsVersion: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** An SLA COMMITMENT on the offering (what the provider promises, as opposed to what the node observed). */
+export declare const OdpsSlaDimensionSchema: z.ZodObject<{
+    dimension: z.ZodEnum<{
+        latency: "latency";
+        uptime: "uptime";
+        responseTime: "responseTime";
+        errorRate: "errorRate";
+        endOfSupport: "endOfSupport";
+        endOfLife: "endOfLife";
+        updateFrequency: "updateFrequency";
+        timeToDetect: "timeToDetect";
+        timeToNotify: "timeToNotify";
+        timeToRepair: "timeToRepair";
+        emailResponseTime: "emailResponseTime";
+    }>;
+    objective: z.ZodNumber;
+    unit: z.ZodEnum<{
+        percent: "percent";
+        milliseconds: "milliseconds";
+        seconds: "seconds";
+        minutes: "minutes";
+        days: "days";
+        weeks: "weeks";
+        months: "months";
+        years: "years";
+        never: "never";
+        date: "date";
+        null: "null";
+    }>;
+    description: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** A data-quality COMMITMENT on the offering. */
+export declare const OdpsQualityDimensionSchema: z.ZodObject<{
+    dimension: z.ZodEnum<{
+        accuracy: "accuracy";
+        completeness: "completeness";
+        conformity: "conformity";
+        consistency: "consistency";
+        coverage: "coverage";
+        timeliness: "timeliness";
+        validity: "validity";
+        uniqueness: "uniqueness";
+    }>;
+    objective: z.ZodNumber;
+    unit: z.ZodEnum<{
+        number: "number";
+        percentage: "percentage";
+    }>;
+    description: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** The legal entity behind the offering. AIMEAT knows the ACCOUNT (a GHII); only the provider knows the company. */
+export declare const OdpsDataHolderSchema: z.ZodObject<{
+    legalName: z.ZodString;
+    businessID: z.ZodOptional<z.ZodString>;
+    taxID: z.ZodOptional<z.ZodString>;
+    vatID: z.ZodOptional<z.ZodString>;
+    email: z.ZodOptional<z.ZodString>;
+    URL: z.ZodOptional<z.ZodString>;
+    telephone: z.ZodOptional<z.ZodString>;
+    contactName: z.ZodOptional<z.ZodString>;
+    addressRegion: z.ZodOptional<z.ZodString>;
+    businessDomain: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    addressCountry: z.ZodOptional<z.ZodString>;
+    addressLocality: z.ZodOptional<z.ZodString>;
+    postalCode: z.ZodOptional<z.ZodString>;
+    streetAddress: z.ZodOptional<z.ZodString>;
+    logoURL: z.ZodOptional<z.ZodString>;
+    slogan: z.ZodOptional<z.ZodString>;
+    parentOrganization: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** Licence terms ODPS carries that AIMEAT's three-flag `usageTerms` does not (jurisdiction, exclusivity, exit). */
+export declare const OdpsLicenseExtrasSchema: z.ZodObject<{
+    geographicalArea: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    permanent: z.ZodOptional<z.ZodBoolean>;
+    exclusive: z.ZodOptional<z.ZodBoolean>;
+    restrictions: z.ZodOptional<z.ZodString>;
+    applicableLaws: z.ZodOptional<z.ZodString>;
+    warranties: z.ZodOptional<z.ZodString>;
+    damages: z.ZodOptional<z.ZodString>;
+    confidentiality: z.ZodOptional<z.ZodString>;
+    forceMajeure: z.ZodOptional<z.ZodString>;
+    terminationNoticePeriodDays: z.ZodOptional<z.ZodNumber>;
+    terminationConditions: z.ZodOptional<z.ZodString>;
+    continuityConditions: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Everything ODPS defines that the node cannot derive from the offering itself. All optional: a listing
+ * without any of it still projects a schema-valid ODPS v4.1 document, just a thinner one.
+ */
+export declare const OdpsExtrasSchema: z.ZodObject<{
+    language: z.ZodOptional<z.ZodString>;
+    productType: z.ZodOptional<z.ZodEnum<{
+        "raw data": "raw data";
+        "derived data": "derived data";
+        dataset: "dataset";
+        reports: "reports";
+        "analytic view": "analytic view";
+        "3D visualisation": "3D visualisation";
+        algorithm: "algorithm";
+        "decision support": "decision support";
+        "automated decision-making": "automated decision-making";
+        "data-enhanced product": "data-enhanced product";
+        "data-driven service": "data-driven service";
+        "data-enabled performance": "data-enabled performance";
+        "bi-directional": "bi-directional";
+    }>>;
+    governanceProfile: z.ZodOptional<z.ZodEnum<{
+        structured: "structured";
+        enforced: "enforced";
+        automated: "automated";
+        audit_ready: "audit_ready";
+    }>>;
+    portfolioPriority: z.ZodOptional<z.ZodEnum<{
+        critical: "critical";
+        high: "high";
+        medium: "medium";
+        low: "low";
+    }>>;
+    valueProposition: z.ZodOptional<z.ZodString>;
+    productSeries: z.ZodOptional<z.ZodString>;
+    categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    standards: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    useCases: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        title: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        url: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    outputFileFormats: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        TOON: "TOON";
+        JSON: "JSON";
+        XML: "XML";
+        CSV: "CSV";
+        Excel: "Excel";
+        zip: "zip";
+        "plain text": "plain text";
+        GraphQL: "GraphQL";
+        MCP: "MCP";
+    }>>>;
+    contentSample: z.ZodOptional<z.ZodString>;
+    logoURL: z.ZodOptional<z.ZodString>;
+    brandSlogan: z.ZodOptional<z.ZodString>;
+    productVersion: z.ZodOptional<z.ZodString>;
+    versionNotes: z.ZodOptional<z.ZodString>;
+    issues: z.ZodOptional<z.ZodString>;
+    documentationURL: z.ZodOptional<z.ZodString>;
+    supportEmail: z.ZodOptional<z.ZodString>;
+    supportHours: z.ZodOptional<z.ZodString>;
+    valueAddedTaxIncluded: z.ZodOptional<z.ZodBoolean>;
+    valueAddedTaxPercentage: z.ZodOptional<z.ZodNumber>;
+    recommendedDataProducts: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    sla: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        dimension: z.ZodEnum<{
+            latency: "latency";
+            uptime: "uptime";
+            responseTime: "responseTime";
+            errorRate: "errorRate";
+            endOfSupport: "endOfSupport";
+            endOfLife: "endOfLife";
+            updateFrequency: "updateFrequency";
+            timeToDetect: "timeToDetect";
+            timeToNotify: "timeToNotify";
+            timeToRepair: "timeToRepair";
+            emailResponseTime: "emailResponseTime";
+        }>;
+        objective: z.ZodNumber;
+        unit: z.ZodEnum<{
+            percent: "percent";
+            milliseconds: "milliseconds";
+            seconds: "seconds";
+            minutes: "minutes";
+            days: "days";
+            weeks: "weeks";
+            months: "months";
+            years: "years";
+            never: "never";
+            date: "date";
+            null: "null";
+        }>;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    dataQuality: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        dimension: z.ZodEnum<{
+            accuracy: "accuracy";
+            completeness: "completeness";
+            conformity: "conformity";
+            consistency: "consistency";
+            coverage: "coverage";
+            timeliness: "timeliness";
+            validity: "validity";
+            uniqueness: "uniqueness";
+        }>;
+        objective: z.ZodNumber;
+        unit: z.ZodEnum<{
+            number: "number";
+            percentage: "percentage";
+        }>;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    dataHolder: z.ZodOptional<z.ZodObject<{
+        legalName: z.ZodString;
+        businessID: z.ZodOptional<z.ZodString>;
+        taxID: z.ZodOptional<z.ZodString>;
+        vatID: z.ZodOptional<z.ZodString>;
+        email: z.ZodOptional<z.ZodString>;
+        URL: z.ZodOptional<z.ZodString>;
+        telephone: z.ZodOptional<z.ZodString>;
+        contactName: z.ZodOptional<z.ZodString>;
+        addressRegion: z.ZodOptional<z.ZodString>;
+        businessDomain: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        addressCountry: z.ZodOptional<z.ZodString>;
+        addressLocality: z.ZodOptional<z.ZodString>;
+        postalCode: z.ZodOptional<z.ZodString>;
+        streetAddress: z.ZodOptional<z.ZodString>;
+        logoURL: z.ZodOptional<z.ZodString>;
+        slogan: z.ZodOptional<z.ZodString>;
+        parentOrganization: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    license: z.ZodOptional<z.ZodObject<{
+        geographicalArea: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        permanent: z.ZodOptional<z.ZodBoolean>;
+        exclusive: z.ZodOptional<z.ZodBoolean>;
+        restrictions: z.ZodOptional<z.ZodString>;
+        applicableLaws: z.ZodOptional<z.ZodString>;
+        warranties: z.ZodOptional<z.ZodString>;
+        damages: z.ZodOptional<z.ZodString>;
+        confidentiality: z.ZodOptional<z.ZodString>;
+        forceMajeure: z.ZodOptional<z.ZodString>;
+        terminationNoticePeriodDays: z.ZodOptional<z.ZodNumber>;
+        terminationConditions: z.ZodOptional<z.ZodString>;
+        continuityConditions: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ProvenanceLineageHop = z.infer<typeof ProvenanceLineageHopSchema>;
+export type Provenance = z.infer<typeof ProvenanceSchema>;
+export type OdpsSlaDimension = z.infer<typeof OdpsSlaDimensionSchema>;
+export type OdpsQualityDimension = z.infer<typeof OdpsQualityDimensionSchema>;
+export type OdpsDataHolder = z.infer<typeof OdpsDataHolderSchema>;
+export type OdpsLicenseExtras = z.infer<typeof OdpsLicenseExtrasSchema>;
+export type OdpsExtras = z.infer<typeof OdpsExtrasSchema>;
+//# sourceMappingURL=odps-schemas.d.ts.map

package/dist/src/models/odps-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"odps-schemas.d.ts","sourceRoot":"","sources":["../../../src/models/odps-schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,4EAA4E;AAC5E,eAAO,MAAM,kBAAkB,8PAIrB,CAAC;AAEX,qFAAqF;AACrF,eAAO,MAAM,mBAAmB,kLAGtB,CAAC;AAEX,qCAAqC;AACrC,eAAO,MAAM,cAAc,yHAEjB,CAAC;AAEX,yCAAyC;AACzC,eAAO,MAAM,uBAAuB,wHAE1B,CAAC;AAEX,yFAAyF;AACzF,eAAO,MAAM,mBAAmB,yFAA0F,CAAC;AAE3H,oFAAoF;AACpF,eAAO,MAAM,wBAAwB,iEAAkE,CAAC;AAExG,qGAAqG;AACrG,eAAO,MAAM,yBAAyB,gDAAiD,CAAC;AAMxF,0GAA0G;AAC1G,eAAO,MAAM,0BAA0B;;;;iBAIrC,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;iBAiB3B,CAAC;AAEH,4GAA4G;AAC5G,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAKjC,CAAC;AAEH,iDAAiD;AACjD,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;iBAKrC,CAAC;AAEH,oHAAoH;AACpH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;iBAmB/B,CAAC;AAEH,mHAAmH;AACnH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;iBAalC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA6C3B,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC"}

package/dist/src/models/odps-schemas.js

@@ -0,0 +1,182 @@
+/**
+ * @file src/models/odps-schemas.ts
+ * @description The ODPS (Open Data Product Specification, Linux Foundation) authoring contract for an
+ *   EXCHANGE offering. AIMEAT derives most of an ODPS v4.1 document from what the node already knows
+ *   (title, price, plans, licence, provider, observed usage — see services/exchange-odps.ts); these are the
+ *   fields ODPS defines that the node CANNOT derive and a provider may therefore declare on the listing:
+ *   the product framing (value proposition, categories, standards, use cases, sample), the SLA + data-quality
+ *   COMMITMENTS (objectives, which are promises no observation can substitute for), and the legal data holder.
+ *   Everything here is optional — an offering without it still projects a valid ODPS v4.1 document.
+ *   PROVENANCE lives here too: the provider's attestation about where the data came from, on what legal
+ *   basis, how long it is kept, and (for derived data) the upstream lineage it was built from.
+ * @structure ODPS enums (product type · SLA/DQ dimensions + units) · ProvenanceSchema · OdpsExtrasSchema ·
+ *   inferred types (Provenance · OdpsExtras · OdpsSlaDimension · OdpsQualityDimension · OdpsDataHolder)
+ * @usage
+ *   const parsed = OdpsExtrasSchema.safeParse(req.body.odps);
+ *   if (!parsed.success) return res.status(400).json(error(nodeId, 'INVALID_ODPS', parsed.error.message));
+ * @version-history
+ *   v1.1.0 — 2026-07-25 — Pinned to ODPS v4.1 (the version the addendum's Q2 named): `language` (v4.1
+ *     keys details + pricing by ISO 639-1 code), `governanceProfile`, `portfolioPriority`, TOON format.
+ *   v1.0.0 — 2026-07-25 — Initial ODPS authoring contract + provenance attestation (TARGET-045 §4,
+ *     addendum Q2/Q3): closes the drift where `odpsVersion` was declared but never written.
+ */
+import { z } from 'zod';
+/** ODPS v4.1 `product.details.type` — what KIND of data product this is. */
+export const ODPS_PRODUCT_TYPES = [
+    'raw data', 'derived data', 'dataset', 'reports', 'analytic view', '3D visualisation', 'algorithm',
+    'decision support', 'automated decision-making', 'data-enhanced product', 'data-driven service',
+    'data-enabled performance', 'bi-directional',
+];
+/** ODPS v4.1 SLA dimensions (`product.SLA.declarative[].dimensions[].dimension`). */
+export const ODPS_SLA_DIMENSIONS = [
+    'latency', 'uptime', 'responseTime', 'errorRate', 'endOfSupport', 'endOfLife', 'updateFrequency',
+    'timeToDetect', 'timeToNotify', 'timeToRepair', 'emailResponseTime',
+];
+/** ODPS v4.1 SLA objective units. */
+export const ODPS_SLA_UNITS = [
+    'percent', 'milliseconds', 'seconds', 'minutes', 'days', 'weeks', 'months', 'years', 'never', 'date', 'null',
+];
+/** ODPS v4.1 data-quality dimensions. */
+export const ODPS_QUALITY_DIMENSIONS = [
+    'accuracy', 'completeness', 'conformity', 'consistency', 'coverage', 'timeliness', 'validity', 'uniqueness',
+];
+/** ODPS v4.1 output file formats a data product can be delivered in (v4.1 adds TOON). */
+export const ODPS_OUTPUT_FORMATS = ['TOON', 'JSON', 'XML', 'CSV', 'Excel', 'zip', 'plain text', 'GraphQL', 'MCP'];
+/** ODPS v4.1 `details.governanceProfile` — how strictly the product is governed. */
+export const ODPS_GOVERNANCE_PROFILES = ['structured', 'enforced', 'automated', 'audit_ready'];
+/** ODPS v4.1 `details.portfolioPriority` — how important the product is in its owner's portfolio. */
+export const ODPS_PORTFOLIO_PRIORITIES = ['critical', 'high', 'medium', 'low'];
+const shortText = z.string().trim().min(1).max(400);
+const longText = z.string().trim().min(1).max(4000);
+const shortList = z.array(z.string().trim().min(1).max(120)).max(30);
+/** One hop of upstream lineage for DERIVED data — where a component came from and what was done to it. */
+export const ProvenanceLineageHopSchema = z.object({
+    source: shortText,
+    transform: shortText.optional(),
+    at: z.string().trim().max(40).optional(),
+});
+/**
+ * The provider's provenance attestation. A PROMISE by the provider, not a platform guarantee — but a
+ * structured, attributed one (the provider is a GHII/GAII/GEAI) that a buyer can hold them to. Maps onto
+ * ODPS `license.governance` + the AIMEAT extension block; absent provenance is legal, it just reads as
+ * "unstated" to every buyer looking at the listing.
+ */
+export const ProvenanceSchema = z.object({
+    /** Where the data comes from (system, register, API, collection method). */
+    source: shortText.optional(),
+    /** The lawful basis for holding + reselling it (e.g. "GDPR Art. 6(1)(f) legitimate interest", "public register"). */
+    legalBasis: shortText.optional(),
+    /** Consent state of the underlying subjects, when the data is personal. */
+    consentStatus: shortText.optional(),
+    /** How long the provider retains it. */
+    retention: shortText.optional(),
+    /** What was done to the raw material to make this product (cleaning, joining, enrichment, model inference). */
+    transformations: longText.optional(),
+    /** SHA-256 content identity of the snapshot this promise is about (hex or `sha256:` prefixed). */
+    snapshotHash: z.string().trim().regex(/^(sha256:)?[a-fA-F0-9]{64}$/, 'snapshotHash must be a SHA-256 hex digest').optional(),
+    /** Upstream chain for derived data (OpenLineage-style, kept deliberately small + human-readable). */
+    lineage: z.array(ProvenanceLineageHopSchema).max(20).optional(),
+    /** Which ODPS version this listing's descriptor follows. Defaulted by the node on write. */
+    odpsVersion: z.string().trim().max(10).optional(),
+});
+/** An SLA COMMITMENT on the offering (what the provider promises, as opposed to what the node observed). */
+export const OdpsSlaDimensionSchema = z.object({
+    dimension: z.enum(ODPS_SLA_DIMENSIONS),
+    objective: z.number(),
+    unit: z.enum(ODPS_SLA_UNITS),
+    description: shortText.optional(),
+});
+/** A data-quality COMMITMENT on the offering. */
+export const OdpsQualityDimensionSchema = z.object({
+    dimension: z.enum(ODPS_QUALITY_DIMENSIONS),
+    objective: z.number(),
+    unit: z.enum(['percentage', 'number']),
+    description: shortText.optional(),
+});
+/** The legal entity behind the offering. AIMEAT knows the ACCOUNT (a GHII); only the provider knows the company. */
+export const OdpsDataHolderSchema = z.object({
+    legalName: shortText,
+    businessID: z.string().trim().max(60).optional(),
+    taxID: z.string().trim().max(60).optional(),
+    vatID: z.string().trim().max(60).optional(),
+    email: z.string().trim().email().max(200).optional(),
+    URL: z.string().trim().url().max(400).optional(),
+    telephone: z.string().trim().max(60).optional(),
+    contactName: shortText.optional(),
+    addressRegion: z.string().trim().max(120).optional(),
+    businessDomain: shortText.optional(),
+    description: longText.optional(),
+    addressCountry: z.string().trim().max(60).optional(),
+    addressLocality: z.string().trim().max(120).optional(),
+    postalCode: z.string().trim().max(20).optional(),
+    streetAddress: shortText.optional(),
+    logoURL: z.string().trim().url().max(400).optional(),
+    slogan: shortText.optional(),
+    parentOrganization: shortText.optional(),
+});
+/** Licence terms ODPS carries that AIMEAT's three-flag `usageTerms` does not (jurisdiction, exclusivity, exit). */
+export const OdpsLicenseExtrasSchema = z.object({
+    geographicalArea: shortList.optional(),
+    permanent: z.boolean().optional(),
+    exclusive: z.boolean().optional(),
+    restrictions: longText.optional(),
+    applicableLaws: shortText.optional(),
+    warranties: longText.optional(),
+    damages: longText.optional(),
+    confidentiality: longText.optional(),
+    forceMajeure: longText.optional(),
+    terminationNoticePeriodDays: z.number().int().min(0).max(3650).optional(),
+    terminationConditions: longText.optional(),
+    continuityConditions: longText.optional(),
+});
+/**
+ * Everything ODPS defines that the node cannot derive from the offering itself. All optional: a listing
+ * without any of it still projects a schema-valid ODPS v4.1 document, just a thinner one.
+ */
+export const OdpsExtrasSchema = z.object({
+    /**
+     * ISO 639-1 code for the language the listing text is written in. ODPS v4.1 keys `details` and
+     * `pricingPlans.declarative` by language; AIMEAT carries one free-text title/description, so this says
+     * which key it belongs under. Defaults to `en`. The same string is never duplicated under a second
+     * language — a claimed translation that does not exist is worse than none.
+     */
+    language: z.string().trim().regex(/^[a-z]{2}$/, 'language must be an ISO 639-1 two-letter code').optional(),
+    /** Overrides the node's default product type (derived from the offering kind). */
+    productType: z.enum(ODPS_PRODUCT_TYPES).optional(),
+    /** v4.1: governance maturity applied to this product. */
+    governanceProfile: z.enum(ODPS_GOVERNANCE_PROFILES).optional(),
+    /** v4.1: importance of this product in the provider's portfolio. */
+    portfolioPriority: z.enum(ODPS_PORTFOLIO_PRIORITIES).optional(),
+    /** ODPS caps the value proposition at 512 characters. */
+    valueProposition: z.string().trim().min(1).max(512).optional(),
+    productSeries: shortText.optional(),
+    categories: shortList.optional(),
+    standards: shortList.optional(),
+    /** Use cases as ODPS models them: a title, an optional description and an optional link. */
+    useCases: z.array(z.object({
+        title: shortText,
+        description: longText.optional(),
+        url: z.string().trim().url().max(400).optional(),
+    })).max(20).optional(),
+    outputFileFormats: z.array(z.enum(ODPS_OUTPUT_FORMATS)).max(8).optional(),
+    /** URL of a real output sample, so a buyer sees the goods before contracting (ODPS requires a URI here). */
+    contentSample: z.string().trim().url().max(400).optional(),
+    logoURL: z.string().trim().url().max(400).optional(),
+    brandSlogan: shortText.optional(),
+    productVersion: z.string().trim().max(40).optional(),
+    versionNotes: longText.optional(),
+    issues: longText.optional(),
+    documentationURL: z.string().trim().url().max(400).optional(),
+    supportEmail: z.string().trim().email().max(200).optional(),
+    supportHours: shortText.optional(),
+    /** VAT treatment of the listed price — applied to every pricing plan in the projected document. */
+    valueAddedTaxIncluded: z.boolean().optional(),
+    valueAddedTaxPercentage: z.number().int().min(0).max(100).optional(),
+    /** Related products a buyer may also want (ODPS cross-sell hook): offering ids or URLs. */
+    recommendedDataProducts: shortList.optional(),
+    sla: z.array(OdpsSlaDimensionSchema).max(11).optional(),
+    dataQuality: z.array(OdpsQualityDimensionSchema).max(8).optional(),
+    dataHolder: OdpsDataHolderSchema.optional(),
+    license: OdpsLicenseExtrasSchema.optional(),
+});
+//# sourceMappingURL=odps-schemas.js.map

package/dist/src/models/odps-schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"odps-schemas.js","sourceRoot":"","sources":["../../../src/models/odps-schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,4EAA4E;AAC5E,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,UAAU,EAAE,cAAc,EAAE,SAAS,EAAE,SAAS,EAAE,eAAe,EAAE,kBAAkB,EAAE,WAAW;IAClG,kBAAkB,EAAE,2BAA2B,EAAE,uBAAuB,EAAE,qBAAqB;IAC/F,0BAA0B,EAAE,gBAAgB;CACpC,CAAC;AAEX,qFAAqF;AACrF,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,SAAS,EAAE,QAAQ,EAAE,cAAc,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,EAAE,iBAAiB;IAChG,cAAc,EAAE,cAAc,EAAE,cAAc,EAAE,mBAAmB;CAC3D,CAAC;AAEX,qCAAqC;AACrC,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,SAAS,EAAE,cAAc,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM;CACpG,CAAC;AAEX,yCAAyC;AACzC,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,UAAU,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY;CACnG,CAAC;AAEX,yFAAyF;AACzF,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,KAAK,CAAU,CAAC;AAE3H,oFAAoF;AACpF,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,CAAU,CAAC;AAExG,qGAAqG;AACrG,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAU,CAAC;AAExF,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AACpD,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACpD,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAErE,0GAA0G;AAC1G,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,MAAM,EAAE,SAAS;IACjB,SAAS,EAAE,SAAS,CAAC,QAAQ,EAAE;IAC/B,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;CACzC,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,4EAA4E;IAC5E,MAAM,EAAE,SAAS,CAAC,QAAQ,EAAE;IAC5B,qHAAqH;IACrH,UAAU,EAAE,SAAS,CAAC,QAAQ,EAAE;IAChC,2EAA2E;IAC3E,aAAa,EAAE,SAAS,CAAC,QAAQ,EAAE;IACnC,wCAAwC;IACxC,SAAS,EAAE,SAAS,CAAC,QAAQ,EAAE;IAC/B,+GAA+G;IAC/G,eAAe,EAAE,QAAQ,CAAC,QAAQ,EAAE;IACpC,kGAAkG;IAClG,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,6BAA6B,EAAE,2CAA2C,CAAC,CAAC,QAAQ,EAAE;IAC5H,qGAAqG;IACrG,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC/D,4FAA4F;IAC5F,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;CAClD,CAAC,CAAC;AAEH,4GAA4G;AAC5G,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC;IACtC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC;IAC5B,WAAW,EAAE,SAAS,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAC;AAEH,iDAAiD;AACjD,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC;IAC1C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IACtC,WAAW,EAAE,SAAS,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAC;AAEH,oHAAoH;AACpH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,SAAS,EAAE,SAAS;IACpB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;IAChD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC3C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC3C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IACpD,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IAChD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC/C,WAAW,EAAE,SAAS,CAAC,QAAQ,EAAE;IACjC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IACpD,cAAc,EAAE,SAAS,CAAC,QAAQ,EAAE;IACpC,WAAW,EAAE,QAAQ,CAAC,QAAQ,EAAE;IAChC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;IACpD,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IACtD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;IAChD,aAAa,EAAE,SAAS,CAAC,QAAQ,EAAE;IACnC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IACpD,MAAM,EAAE,SAAS,CAAC,QAAQ,EAAE;IAC5B,kBAAkB,EAAE,SAAS,CAAC,QAAQ,EAAE;CACzC,CAAC,CAAC;AAEH,mHAAmH;AACnH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,gBAAgB,EAAE,SAAS,CAAC,QAAQ,EAAE;IACtC,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACjC,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACjC,YAAY,EAAE,QAAQ,CAAC,QAAQ,EAAE;IACjC,cAAc,EAAE,SAAS,CAAC,QAAQ,EAAE;IACpC,UAAU,EAAE,QAAQ,CAAC,QAAQ,EAAE;IAC/B,OAAO,EAAE,QAAQ,CAAC,QAAQ,EAAE;IAC5B,eAAe,EAAE,QAAQ,CAAC,QAAQ,EAAE;IACpC,YAAY,EAAE,QAAQ,CAAC,QAAQ,EAAE;IACjC,2BAA2B,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;IACzE,qBAAqB,EAAE,QAAQ,CAAC,QAAQ,EAAE;IAC1C,oBAAoB,EAAE,QAAQ,CAAC,QAAQ,EAAE;CAC1C,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC;;;;;OAKG;IACH,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,YAAY,EAAE,+CAA+C,CAAC,CAAC,QAAQ,EAAE;IAC3G,kFAAkF;IAClF,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,QAAQ,EAAE;IAClD,yDAAyD;IACzD,iBAAiB,EAAE,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC,QAAQ,EAAE;IAC9D,oEAAoE;IACpE,iBAAiB,EAAE,CAAC,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC,QAAQ,EAAE;IAC/D,yDAAyD;IACzD,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IAC9D,aAAa,EAAE,SAAS,CAAC,QAAQ,EAAE;IACnC,UAAU,EAAE,SAAS,CAAC,QAAQ,EAAE;IAChC,SAAS,EAAE,SAAS,CAAC,QAAQ,EAAE;IAC/B,4FAA4F;IAC5F,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;QACzB,KAAK,EAAE,SAAS;QAChB,WAAW,EAAE,QAAQ,CAAC,QAAQ,EAAE;QAChC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;KACjD,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;IACtB,iBAAiB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACzE,4GAA4G;IAC5G,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IAC1D,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IACpD,WAAW,EAAE,SAAS,CAAC,QAAQ,EAAE;IACjC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;IACpD,YAAY,EAAE,QAAQ,CAAC,QAAQ,EAAE;IACjC,MAAM,EAAE,QAAQ,CAAC,QAAQ,EAAE;IAC3B,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IAC7D,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IAC3D,YAAY,EAAE,SAAS,CAAC,QAAQ,EAAE;IAClC,mGAAmG;IACnG,qBAAqB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC7C,uBAAuB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IACpE,2FAA2F;IAC3F,uBAAuB,EAAE,SAAS,CAAC,QAAQ,EAAE;IAC7C,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;IACvD,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAClE,UAAU,EAAE,oBAAoB,CAAC,QAAQ,EAAE;IAC3C,OAAO,EAAE,uBAAuB,CAAC,QAAQ,EAAE;CAC5C,CAAC,CAAC"}