@haneinfo/metadata-schema 0.0.0-stage → 1.1.3

package/README.md

@@ -1,3 +1,76 @@
-# Temporary Holding Version
+# `@haneinfo/metadata-schema`
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+`@haneinfo/metadata-schema` exposes the Prisma DMMF used by an app through `GET /metadata/schema`.
+The response includes scalar and enum fields, relation metadata, database column names, and
+structured annotations parsed from Prisma `///` documentation comments.
+
+## Prisma documentation tags
+
+Tags are line-oriented and case-sensitive. A tag is recognised only when it starts a documentation
+line, after optional whitespace. A description can follow the tag on the same line, or appear on
+separate `///` lines. The original `documentation` value in the metadata response is preserved
+byte-for-byte; parsing adds structured properties without removing tag text.
+
+### `@internal`
+
+Place `@internal` in a model's documentation to exclude that model from the derived
+`availableScopes` list. The model and its metadata are still exposed in `models`; only the scope
+derivation filters it out.
+
+```prisma
+/// @internal
+/// Framework bookkeeping; not part of the public data scopes.
+model AuditLog {
+  id String @id @default(cuid())
+}
+```
+
+### `@cubeMeasure <hint>`
+
+Place `@cubeMeasure` on a scalar or enum field and provide one non-whitespace hint. The current
+recommended dictionary is `sum`, `avg`, `min`, `max`, and `count`, but `measureHint` is an open
+`string` so future Cube measures such as `countDistinct`, `countDistinctApprox`, and `runningTotal`
+can be used without a package type change. The parser does not validate whether the field type is
+appropriate for the hint. Consumers should ignore or warn on unknown hints rather than failing the
+whole query.
+
+```prisma
+model InvoiceLine {
+  id     String  @id @default(cuid())
+  /// @cubeMeasure sum Line amount in the invoice currency.
+  amount Decimal
+}
+```
+
+### `@cubeRef <app>.<Model>.<field>`
+
+Place `@cubeRef` on a field that refers to a field owned by another app. The three dot-separated
+parts are returned as `crossAppRef: { app, model, field }`. Parsing is syntactic only: the app,
+model, and field do not need to exist in the current repository. Cross-app joins are never inferred
+when this tag is absent.
+
+```prisma
+model Shipment {
+  id              String @id @default(cuid())
+  /// @cubeRef sales.Order.id
+  /// The order identifier is owned by the sales app.
+  salesOrderId    String @map("sales_order_id")
+}
+```
+
+Tags can be combined on one field and can be mixed with ordinary text:
+
+```prisma
+model Payment {
+  id        String  @id @default(cuid())
+  /// Payment amount in the settlement currency.
+  /// @cubeMeasure sum
+  /// @cubeRef billing.Invoice.total
+  amount    Decimal @map("amount_value")
+}
+```
+
+Malformed `@cubeMeasure` or `@cubeRef` lines are ignored and produce a warning. Lowercase variants
+such as `@cubemeasure` are ordinary text. If a tag appears more than once on a field, the first
+valid occurrence wins. A tag string embedded in the middle of a sentence is not a tag; move it to
+the beginning of a `///` documentation line.

package/dist/cube-tags.d.ts

@@ -0,0 +1,15 @@
+export interface CubeTags {
+    measureHint?: string;
+    crossAppRef?: {
+        app: string;
+        model: string;
+        field: string;
+    };
+}
+/**
+ * Parses Cube tags from Prisma documentation without changing the source documentation string.
+ * Tags are valid only when they begin a documentation line, matching the existing line-oriented
+ * convention used for `@internal` metadata in this package.
+ */
+export declare function parseCubeTags(documentation: string | undefined): CubeTags;
+//# sourceMappingURL=cube-tags.d.ts.map

package/dist/cube-tags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cube-tags.d.ts","sourceRoot":"","sources":["../src/cube-tags.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,QAAQ;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7D;AAMD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,CA+BzE"}

package/dist/cube-tags.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseCubeTags = parseCubeTags;
+const CUBE_MEASURE_TAG = /^\s*@cubeMeasure(?:\s+(\S+))?(?:\s+.*)?$/;
+const CUBE_REF_TAG = /^\s*@cubeRef(?:\s+(\S+))?(?:\s+.*)?$/;
+const CUBE_REF_VALUE = /^([^.\s]+)\.([^.\s]+)\.([^.\s]+)$/;
+/**
+ * Parses Cube tags from Prisma documentation without changing the source documentation string.
+ * Tags are valid only when they begin a documentation line, matching the existing line-oriented
+ * convention used for `@internal` metadata in this package.
+ */
+function parseCubeTags(documentation) {
+    if (!documentation)
+        return {};
+    const result = {};
+    const lines = documentation.replace(/\\n/g, '\n').split(/\r?\n/);
+    for (const line of lines) {
+        const measureMatch = line.match(CUBE_MEASURE_TAG);
+        if (measureMatch) {
+            const hint = measureMatch[1];
+            if (!hint || hint.startsWith('@')) {
+                console.warn('Ignoring malformed @cubeMeasure tag: expected a hint.');
+            }
+            else if (result.measureHint === undefined) {
+                result.measureHint = hint;
+            }
+            continue;
+        }
+        const refMatch = line.match(CUBE_REF_TAG);
+        if (refMatch) {
+            const value = refMatch[1];
+            const parts = value?.match(CUBE_REF_VALUE);
+            if (!parts) {
+                console.warn('Ignoring malformed @cubeRef tag: expected <app>.<Model>.<field>.');
+            }
+            else if (result.crossAppRef === undefined) {
+                result.crossAppRef = { app: parts[1], model: parts[2], field: parts[3] };
+            }
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=cube-tags.js.map

package/dist/cube-tags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cube-tags.js","sourceRoot":"","sources":["../src/cube-tags.ts"],"names":[],"mappings":";;AAcA,sCA+BC;AAxCD,MAAM,gBAAgB,GAAG,0CAA0C,CAAC;AACpE,MAAM,YAAY,GAAG,sCAAsC,CAAC;AAC5D,MAAM,cAAc,GAAG,mCAAmC,CAAC;AAE3D;;;;GAIG;AACH,SAAgB,aAAa,CAAC,aAAiC;IAC7D,IAAI,CAAC,aAAa;QAAE,OAAO,EAAE,CAAC;IAE9B,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,KAAK,GAAG,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAEjE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;QAClD,IAAI,YAAY,EAAE,CAAC;YACjB,MAAM,IAAI,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;YAC7B,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBAClC,OAAO,CAAC,IAAI,CAAC,uDAAuD,CAAC,CAAC;YACxE,CAAC;iBAAM,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;gBAC5C,MAAM,CAAC,WAAW,GAAG,IAAI,CAAC;YAC5B,CAAC;YACD,SAAS;QACX,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QAC1C,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;YAC1B,MAAM,KAAK,GAAG,KAAK,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;YAC3C,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,OAAO,CAAC,IAAI,CAAC,kEAAkE,CAAC,CAAC;YACnF,CAAC;iBAAM,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;gBAC5C,MAAM,CAAC,WAAW,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3E,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/data-dictionary.d.ts

@@ -0,0 +1,9 @@
+import type { SchemaMeta } from './meta.service';
+/**
+ * Renders a SchemaMeta (from MetaService.buildMeta()) into the docs/data-dictionary.md
+ * markdown format. Shared by both the build-time script and (indirectly, via the same
+ * SchemaMeta shape) the GET /metadata/schema runtime endpoint — see dev_docs 001
+ * "Metadata Schema API".
+ */
+export declare function renderDataDictionary(meta: SchemaMeta): string;
+//# sourceMappingURL=data-dictionary.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"data-dictionary.d.ts","sourceRoot":"","sources":["../src/data-dictionary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAOjD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CA6D7D"}

package/dist/data-dictionary.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderDataDictionary = renderDataDictionary;
+/** Normalise multi-line /// comments into a single clean string. */
+function doc(s) {
+    return (s ?? '').replace(/\\n/g, ' ').replace(/\n/g, ' ').trim();
+}
+/**
+ * Renders a SchemaMeta (from MetaService.buildMeta()) into the docs/data-dictionary.md
+ * markdown format. Shared by both the build-time script and (indirectly, via the same
+ * SchemaMeta shape) the GET /metadata/schema runtime endpoint — see dev_docs 001
+ * "Metadata Schema API".
+ */
+function renderDataDictionary(meta) {
+    const lines = [];
+    const push = (...args) => lines.push(...args);
+    push('# Data Dictionary', '', `> Auto-generated from Prisma schema on ${meta.generatedAt.slice(0, 10)}.`, "> Do not edit manually — run your app's schema:docs script to regenerate.", '', '---', '');
+    push('## Enums', '');
+    for (const e of meta.enums) {
+        push(`### ${e.name}`, '');
+        if (e.documentation)
+            push(`> ${doc(e.documentation)}`, '');
+        push('| Value | Description |', '|-------|-------------|');
+        for (const v of e.values) {
+            push(`| \`${v.name}\` | ${doc(v.documentation)} |`);
+        }
+        push('');
+    }
+    push('## Models', '');
+    for (const m of meta.models) {
+        push(`### ${m.name}`, '');
+        if (m.documentation)
+            push(`> ${doc(m.documentation)}`, '');
+        push(`**DB table:** \`${m.dbTable}\``, '', '| Field | Type | Required | Unique | Description |', '|-------|------|----------|--------|-------------|');
+        for (const f of m.fields) {
+            const required = f.isRequired ? '✓' : '';
+            const unique = f.isUnique || f.isId ? '✓' : '';
+            const type = f.isList ? `${f.type}[]` : f.type;
+            push(`| \`${f.name}\` | ${type} | ${required} | ${unique} | ${doc(f.documentation)} |`);
+        }
+        push('');
+        if (m.relations.length > 0) {
+            push('#### Relations', '', '| Relation Field | Target Model | Required | List |', '|----------------|--------------|----------|------|');
+            for (const relation of m.relations) {
+                const required = relation.isRequired ? '✓' : '';
+                const list = relation.isList ? '✓' : '';
+                push(`| \`${relation.fieldName}\` | \`${relation.targetModel}\` | ${required} | ${list} |`);
+            }
+            push('');
+        }
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=data-dictionary.js.map

package/dist/data-dictionary.js.map

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

package/dist/enum-i18n.d.ts

@@ -0,0 +1,8 @@
+import type { SchemaMeta } from './meta.service';
+export interface EnumTranslationGap {
+    locale: string;
+    key: string;
+    kind: 'missing' | 'orphaned';
+}
+export declare function collectEnumTranslationGaps(meta: Pick<SchemaMeta, 'enums'>, dictionaries: Record<string, Record<string, unknown>>): EnumTranslationGap[];
+//# sourceMappingURL=enum-i18n.d.ts.map

package/dist/enum-i18n.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enum-i18n.d.ts","sourceRoot":"","sources":["../src/enum-i18n.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,SAAS,GAAG,UAAU,CAAC;CAC9B;AAED,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,EAC/B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACpD,kBAAkB,EAAE,CAoBtB"}

package/dist/enum-i18n.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.collectEnumTranslationGaps = collectEnumTranslationGaps;
+function collectEnumTranslationGaps(meta, dictionaries) {
+    const expectedKeys = new Set(meta.enums.flatMap((enumMeta) => enumMeta.values.map((value) => `${enumMeta.name}.${value.name}`)));
+    return Object.entries(dictionaries).flatMap(([locale, dictionary]) => {
+        const actualKeys = new Set(Object.keys(dictionary).filter((key) => typeof dictionary[key] === 'string'));
+        const missing = [...expectedKeys]
+            .filter((key) => !actualKeys.has(key))
+            .map((key) => ({ locale, key, kind: 'missing' }));
+        const orphaned = [...actualKeys]
+            .filter((key) => !expectedKeys.has(key))
+            .map((key) => ({ locale, key, kind: 'orphaned' }));
+        return [...missing, ...orphaned];
+    });
+}
+//# sourceMappingURL=enum-i18n.js.map

package/dist/enum-i18n.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enum-i18n.js","sourceRoot":"","sources":["../src/enum-i18n.ts"],"names":[],"mappings":";;AAQA,gEAuBC;AAvBD,SAAgB,0BAA0B,CACxC,IAA+B,EAC/B,YAAqD;IAErD,MAAM,YAAY,GAAG,IAAI,GAAG,CAC1B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CAC9B,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,QAAQ,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CACjE,CACF,CAAC;IAEF,OAAO,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,EAAE;QACnE,MAAM,UAAU,GAAG,IAAI,GAAG,CACxB,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,UAAU,CAAC,GAAG,CAAC,KAAK,QAAQ,CAAC,CAC7E,CAAC;QACF,MAAM,OAAO,GAAG,CAAC,GAAG,YAAY,CAAC;aAC9B,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;aACrC,GAAG,CAAqB,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;QACxE,MAAM,QAAQ,GAAG,CAAC,GAAG,UAAU,CAAC;aAC7B,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;aACvC,GAAG,CAAqB,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC;QAEzE,OAAO,CAAC,GAAG,OAAO,EAAE,GAAG,QAAQ,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { METADATA_SCHEMA, type MetadataSchemaPort } from '@haneinfo/plugin-api';
+export * from './data-dictionary';
+export * from './enum-i18n';
+export * from './meta.controller';
+export * from './meta.module';
+export * from './meta.service';
+export * from './meta-scope.guard';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,KAAK,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAChF,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,26 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.METADATA_SCHEMA = void 0;
+var plugin_api_1 = require("@haneinfo/plugin-api");
+Object.defineProperty(exports, "METADATA_SCHEMA", { enumerable: true, get: function () { return plugin_api_1.METADATA_SCHEMA; } });
+__exportStar(require("./data-dictionary"), exports);
+__exportStar(require("./enum-i18n"), exports);
+__exportStar(require("./meta.controller"), exports);
+__exportStar(require("./meta.module"), exports);
+__exportStar(require("./meta.service"), exports);
+__exportStar(require("./meta-scope.guard"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,mDAAgF;AAAvE,6GAAA,eAAe,OAAA;AACxB,oDAAkC;AAClC,8CAA4B;AAC5B,oDAAkC;AAClC,gDAA8B;AAC9B,iDAA+B;AAC/B,qDAAmC"}

package/dist/meta-scope.guard.d.ts

@@ -0,0 +1,18 @@
+import { type ScopeMatcherPort } from '@haneinfo/plugin-api';
+import { type CanActivate, type ExecutionContext } from '@nestjs/common';
+/**
+ * Authorization guard for metadata schema access.
+ *
+ * Requirements:
+ * - Interactive users (human logins / JWT) have full access to schema introspection.
+ * - Machine users (API keys) must possess the `metadata:read` scope (or a wildcard like `metadata:*` or `*`).
+ * - Decoupled from concrete `@haneinfo/m2m-api-key` implementations via the neutral `SCOPE_MATCHER` token.
+ * - Strict Fail-Closed: if a machine credential is presented but no scope matcher capability
+ *   is registered, access is denied (403 Forbidden).
+ */
+export declare class MetadataScopeGuard implements CanActivate {
+    private readonly scopeMatcher?;
+    constructor(scopeMatcher?: ScopeMatcherPort | undefined);
+    canActivate(context: ExecutionContext): boolean;
+}
+//# sourceMappingURL=meta-scope.guard.d.ts.map

package/dist/meta-scope.guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-scope.guard.d.ts","sourceRoot":"","sources":["../src/meta-scope.guard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiC,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC5F,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,gBAAgB,EAKtB,MAAM,gBAAgB,CAAC;AAExB;;;;;;;;;GASG;AACH,qBACa,kBAAmB,YAAW,WAAW;IAIlD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;gBAAb,YAAY,CAAC,EAAE,gBAAgB,YAAA;IAGlD,WAAW,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO;CAkChD"}

package/dist/meta-scope.guard.js

@@ -0,0 +1,62 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MetadataScopeGuard = void 0;
+const plugin_api_1 = require("@haneinfo/plugin-api");
+const common_1 = require("@nestjs/common");
+/**
+ * Authorization guard for metadata schema access.
+ *
+ * Requirements:
+ * - Interactive users (human logins / JWT) have full access to schema introspection.
+ * - Machine users (API keys) must possess the `metadata:read` scope (or a wildcard like `metadata:*` or `*`).
+ * - Decoupled from concrete `@haneinfo/m2m-api-key` implementations via the neutral `SCOPE_MATCHER` token.
+ * - Strict Fail-Closed: if a machine credential is presented but no scope matcher capability
+ *   is registered, access is denied (403 Forbidden).
+ */
+let MetadataScopeGuard = class MetadataScopeGuard {
+    constructor(scopeMatcher) {
+        this.scopeMatcher = scopeMatcher;
+    }
+    canActivate(context) {
+        const request = context.switchToHttp().getRequest();
+        const user = request.user;
+        if (!user) {
+            return false;
+        }
+        const isApiKey = 'isApiKey' in user ? Boolean(user.isApiKey) : user.kind === 'machine';
+        // Interactive principals are not scope-restricted.
+        if (!isApiKey) {
+            return true;
+        }
+        // Machine caller: require a scope matcher port to validate scopes.
+        if (!this.scopeMatcher) {
+            throw new common_1.ForbiddenException('No scope matcher provider is available to validate API key scopes');
+        }
+        const scopes = 'scopes' in user && Array.isArray(user.scopes) ? user.scopes : [];
+        const allowed = this.scopeMatcher.matches(scopes, 'metadata:read');
+        if (!allowed) {
+            throw new common_1.ForbiddenException('Insufficient API key scopes');
+        }
+        return true;
+    }
+};
+exports.MetadataScopeGuard = MetadataScopeGuard;
+exports.MetadataScopeGuard = MetadataScopeGuard = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Optional)()),
+    __param(0, (0, common_1.Inject)(plugin_api_1.SCOPE_MATCHER)),
+    __metadata("design:paramtypes", [Object])
+], MetadataScopeGuard);
+//# sourceMappingURL=meta-scope.guard.js.map

package/dist/meta-scope.guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-scope.guard.js","sourceRoot":"","sources":["../src/meta-scope.guard.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,qDAA4F;AAC5F,2CAOwB;AAExB;;;;;;;;;GASG;AAEI,IAAM,kBAAkB,GAAxB,MAAM,kBAAkB;IAC7B,YAGmB,YAA+B;QAA/B,iBAAY,GAAZ,YAAY,CAAmB;IAC/C,CAAC;IAEJ,WAAW,CAAC,OAAyB;QACnC,MAAM,OAAO,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,UAAU,EAE7C,CAAC;QACL,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QAE1B,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,QAAQ,GACZ,UAAU,IAAI,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAE,IAA0B,CAAC,IAAI,KAAK,SAAS,CAAC;QAE/F,mDAAmD;QACnD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,IAAI,CAAC;QACd,CAAC;QAED,mEAAmE;QACnE,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,MAAM,IAAI,2BAAkB,CAC1B,mEAAmE,CACpE,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,QAAQ,IAAI,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAE,IAAI,CAAC,MAAmB,CAAC,CAAC,CAAC,EAAE,CAAC;QAE/F,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;QACnE,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,2BAAkB,CAAC,6BAA6B,CAAC,CAAC;QAC9D,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAA;AAzCY,gDAAkB;6BAAlB,kBAAkB;IAD9B,IAAA,mBAAU,GAAE;IAGR,WAAA,IAAA,iBAAQ,GAAE,CAAA;IACV,WAAA,IAAA,eAAM,EAAC,0BAAa,CAAC,CAAA;;GAHb,kBAAkB,CAyC9B"}

package/dist/meta.controller.d.ts

@@ -0,0 +1,7 @@
+import { MetaService, type SchemaMeta } from './meta.service';
+export declare class MetaController {
+    private readonly metaService;
+    constructor(metaService: MetaService);
+    schema(): SchemaMeta;
+}
+//# sourceMappingURL=meta.controller.d.ts.map

package/dist/meta.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.controller.d.ts","sourceRoot":"","sources":["../src/meta.controller.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAM9D,qBAEa,cAAc;IACQ,OAAO,CAAC,QAAQ,CAAC,WAAW;gBAAX,WAAW,EAAE,WAAW;IAM1E,MAAM,IAAI,UAAU;CAGrB"}

package/dist/meta.controller.js

@@ -0,0 +1,47 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MetaController = void 0;
+const plugin_host_nest_1 = require("@haneinfo/plugin-host-nest");
+const common_1 = require("@nestjs/common");
+const meta_service_1 = require("./meta.service");
+const meta_scope_guard_1 = require("./meta-scope.guard");
+// Readable by any logged-in interactive (JWT) user, or by an M2M API key with the metadata:read
+// scope — external agents without repo access query this at runtime (dev_docs 001
+// "Metadata Schema API").
+let MetaController = class MetaController {
+    constructor(metaService) {
+        this.metaService = metaService;
+    }
+    // Declares the scope for the API-key scope catalog (m2m-api-key reads the 'scopes' metadata key), so
+    // metadata:read can be issued. Written as plain metadata to keep this package free of an m2m runtime import.
+    schema() {
+        return this.metaService.buildMeta();
+    }
+};
+exports.MetaController = MetaController;
+__decorate([
+    (0, common_1.Get)('schema'),
+    (0, common_1.SetMetadata)('scopes', ['metadata:read']),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Object)
+], MetaController.prototype, "schema", null);
+exports.MetaController = MetaController = __decorate([
+    (0, common_1.Controller)('metadata'),
+    (0, common_1.UseGuards)(plugin_host_nest_1.HaneinfoAuthGuard, meta_scope_guard_1.MetadataScopeGuard),
+    __param(0, (0, common_1.Inject)(meta_service_1.MetaService)),
+    __metadata("design:paramtypes", [meta_service_1.MetaService])
+], MetaController);
+//# sourceMappingURL=meta.controller.js.map

package/dist/meta.controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.controller.js","sourceRoot":"","sources":["../src/meta.controller.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,iEAA+D;AAC/D,2CAAiF;AACjF,iDAA8D;AAC9D,yDAAwD;AAExD,gGAAgG;AAChG,kFAAkF;AAClF,0BAA0B;AAGnB,IAAM,cAAc,GAApB,MAAM,cAAc;IACzB,YAAkD,WAAwB;QAAxB,gBAAW,GAAX,WAAW,CAAa;IAAG,CAAC;IAE9E,qGAAqG;IACrG,6GAA6G;IAG7G,MAAM;QACJ,OAAO,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,CAAC;IACtC,CAAC;CACF,CAAA;AAVY,wCAAc;AAOzB;IAFC,IAAA,YAAG,EAAC,QAAQ,CAAC;IACb,IAAA,oBAAW,EAAC,QAAQ,EAAE,CAAC,eAAe,CAAC,CAAC;;;;4CAGxC;yBATU,cAAc;IAF1B,IAAA,mBAAU,EAAC,UAAU,CAAC;IACtB,IAAA,kBAAS,EAAC,oCAAiB,EAAE,qCAAkB,CAAC;IAElC,WAAA,IAAA,eAAM,EAAC,0BAAW,CAAC,CAAA;qCAA+B,0BAAW;GAD/D,cAAc,CAU1B"}

package/dist/meta.module.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Provides the metadata schema introspection service both as a concrete class and behind
+ * the stable `METADATA_SCHEMA` capability token (PL4-04).
+ */
+export declare class MetaModule {
+}
+//# sourceMappingURL=meta.module.d.ts.map

package/dist/meta.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.module.d.ts","sourceRoot":"","sources":["../src/meta.module.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,qBAUa,UAAU;CAAG"}

package/dist/meta.module.js

@@ -0,0 +1,35 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MetaModule = void 0;
+const plugin_api_1 = require("@haneinfo/plugin-api");
+const plugin_host_nest_1 = require("@haneinfo/plugin-host-nest");
+const common_1 = require("@nestjs/common");
+const meta_controller_1 = require("./meta.controller");
+const meta_service_1 = require("./meta.service");
+const meta_scope_guard_1 = require("./meta-scope.guard");
+/**
+ * Provides the metadata schema introspection service both as a concrete class and behind
+ * the stable `METADATA_SCHEMA` capability token (PL4-04).
+ */
+let MetaModule = class MetaModule {
+};
+exports.MetaModule = MetaModule;
+exports.MetaModule = MetaModule = __decorate([
+    (0, common_1.Module)({
+        imports: [plugin_host_nest_1.HaneinfoAuthInfrastructureModule],
+        controllers: [meta_controller_1.MetaController],
+        providers: [
+            meta_service_1.MetaService,
+            meta_scope_guard_1.MetadataScopeGuard,
+            { provide: plugin_api_1.METADATA_SCHEMA, useExisting: meta_service_1.MetaService },
+        ],
+        exports: [meta_service_1.MetaService, plugin_api_1.METADATA_SCHEMA, meta_scope_guard_1.MetadataScopeGuard],
+    })
+], MetaModule);
+//# sourceMappingURL=meta.module.js.map

package/dist/meta.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.module.js","sourceRoot":"","sources":["../src/meta.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,qDAAuD;AACvD,iEAA8E;AAC9E,2CAAwC;AACxC,uDAAmD;AACnD,iDAA6C;AAC7C,yDAAwD;AAExD;;;GAGG;AAWI,IAAM,UAAU,GAAhB,MAAM,UAAU;CAAG,CAAA;AAAb,gCAAU;qBAAV,UAAU;IAVtB,IAAA,eAAM,EAAC;QACN,OAAO,EAAE,CAAC,mDAAgC,CAAC;QAC3C,WAAW,EAAE,CAAC,gCAAc,CAAC;QAC7B,SAAS,EAAE;YACT,0BAAW;YACX,qCAAkB;YAClB,EAAE,OAAO,EAAE,4BAAe,EAAE,WAAW,EAAE,0BAAW,EAAE;SACvD;QACD,OAAO,EAAE,CAAC,0BAAW,EAAE,4BAAe,EAAE,qCAAkB,CAAC;KAC5D,CAAC;GACW,UAAU,CAAG"}

package/dist/meta.service.d.ts

@@ -0,0 +1,57 @@
+export interface FieldMeta {
+    name: string;
+    type: string;
+    kind: string;
+    dbColumn: string;
+    isRequired: boolean;
+    isUnique: boolean;
+    isId: boolean;
+    isList: boolean;
+    hasDefault: boolean;
+    default?: unknown;
+    documentation?: string;
+    measureHint?: string;
+    crossAppRef?: {
+        app: string;
+        model: string;
+        field: string;
+    };
+}
+export interface RelationMeta {
+    fieldName: string;
+    targetModel: string;
+    relationName: string;
+    isRequired: boolean;
+    isList: boolean;
+    fromFields: string[];
+    toFields: string[];
+    fromDbColumns: string[];
+    toDbColumns: string[];
+}
+export interface ModelMeta {
+    name: string;
+    dbTable: string;
+    documentation?: string;
+    fields: FieldMeta[];
+    relations: RelationMeta[];
+}
+export interface EnumValueMeta {
+    name: string;
+    documentation?: string;
+}
+export interface EnumMeta {
+    name: string;
+    documentation?: string;
+    values: EnumValueMeta[];
+}
+export interface SchemaMeta {
+    generatedAt: string;
+    models: ModelMeta[];
+    enums: EnumMeta[];
+    availableScopes: string[];
+}
+export declare class MetaService {
+    buildMeta(): SchemaMeta;
+    private deriveScopes;
+}
+//# sourceMappingURL=meta.service.d.ts.map

package/dist/meta.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.service.d.ts","sourceRoot":"","sources":["../src/meta.service.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7D;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,SAAS,EAAE,YAAY,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,aAAa,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,qBACa,WAAW;IACtB,SAAS,IAAI,UAAU;IA6EvB,OAAO,CAAC,YAAY;CAKrB"}

package/dist/meta.service.js

@@ -0,0 +1,93 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MetaService = void 0;
+const common_1 = require("@haneinfo/common");
+const common_2 = require("@nestjs/common");
+const cube_tags_1 = require("./cube-tags");
+let MetaService = class MetaService {
+    buildMeta() {
+        // Prisma.dmmf's shape isn't exposed in @prisma/client's public types, so this cast is the
+        // one place that bridges to it; everything downstream is properly typed.
+        const { models, enums } = common_1.Prisma.dmmf.datamodel;
+        const modelsMeta = models.map((m) => ({
+            name: m.name,
+            dbTable: m.dbName ?? m.name.toLowerCase(),
+            documentation: m.documentation,
+            fields: m.fields
+                .filter((f) => f.kind !== 'object')
+                .map((f) => {
+                const cubeTags = (0, cube_tags_1.parseCubeTags)(f.documentation);
+                return {
+                    name: f.name,
+                    type: f.type,
+                    kind: f.kind,
+                    dbColumn: f.dbName ?? f.name,
+                    isRequired: f.isRequired,
+                    isUnique: f.isUnique ?? false,
+                    isId: f.isId ?? false,
+                    isList: f.isList,
+                    hasDefault: f.hasDefaultValue ?? false,
+                    default: f.default,
+                    documentation: f.documentation,
+                    ...cubeTags,
+                };
+            }),
+            relations: m.fields
+                .filter((f) => f.kind === 'object')
+                .filter((f) => {
+                // Prisma represents implicit many-to-many relations with explicit empty arrays on both
+                // sides. Do not emit a half-complete relation when the join table is not in the DMMF.
+                return !(Array.isArray(f.relationFromFields) &&
+                    Array.isArray(f.relationToFields) &&
+                    f.relationFromFields.length === 0 &&
+                    f.relationToFields.length === 0);
+            })
+                .map((f) => {
+                const fromFields = [...(f.relationFromFields ?? [])];
+                const toFields = [...(f.relationToFields ?? [])];
+                const targetModel = models.find((target) => target.name === f.type);
+                const dbColumnFor = (fieldName, model) => model.fields.find((field) => field.name === fieldName)?.dbName ?? fieldName;
+                return {
+                    fieldName: f.name,
+                    targetModel: f.type,
+                    relationName: f.relationName ?? '',
+                    isRequired: f.isRequired,
+                    isList: f.isList,
+                    fromFields,
+                    toFields,
+                    fromDbColumns: fromFields.map((fieldName) => dbColumnFor(fieldName, m)),
+                    toDbColumns: toFields.map((fieldName) => dbColumnFor(fieldName, targetModel ?? m)),
+                };
+            }),
+        }));
+        return {
+            generatedAt: new Date().toISOString(),
+            models: modelsMeta,
+            enums: enums.map((e) => ({
+                name: e.name,
+                documentation: e.documentation,
+                values: e.values.map((v) => ({
+                    name: v.name,
+                    documentation: v.documentation,
+                })),
+            })),
+            availableScopes: this.deriveScopes(modelsMeta),
+        };
+    }
+    deriveScopes(models) {
+        return models
+            .filter((m) => !m.documentation?.includes('@internal'))
+            .flatMap((m) => [`${m.dbTable}:read`, `${m.dbTable}:write`, `${m.dbTable}:*`]);
+    }
+};
+exports.MetaService = MetaService;
+exports.MetaService = MetaService = __decorate([
+    (0, common_2.Injectable)()
+], MetaService);
+//# sourceMappingURL=meta.service.js.map

package/dist/meta.service.js.map

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

package/dist/plugin.d.ts

@@ -0,0 +1,20 @@
+/**
+ * `@haneinfo/metadata-schema/plugin` — manifest and plugin descriptor (PL4-04).
+ */
+import { METADATA_SCHEMA, type MetadataSchemaPort, type PluginManifestV1 } from '@haneinfo/plugin-api';
+import { MetaController } from './meta.controller';
+import { MetaModule } from './meta.module';
+import { MetaService } from './meta.service';
+import { MetadataScopeGuard } from './meta-scope.guard';
+export { METADATA_SCHEMA, MetaController, type MetadataSchemaPort, MetadataScopeGuard, MetaModule, MetaService, };
+/** Mirrors `haneinfo.plugin.json`; `plugin.spec.ts` fails if the two drift apart. */
+export declare const metadataSchemaManifest: PluginManifestV1;
+export declare const metadataSchemaPlugin: import("@haneinfo/plugin-api").DefinedPlugin<unknown, {
+    module: typeof MetaModule;
+    providers: {
+        provide: symbol;
+        useExisting: typeof MetaService;
+    }[];
+}>;
+export default metadataSchemaPlugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAEL,eAAe,EACf,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,EACL,eAAe,EACf,cAAc,EACd,KAAK,kBAAkB,EACvB,kBAAkB,EAClB,UAAU,EACV,WAAW,GACZ,CAAC;AAEF,qFAAqF;AACrF,eAAO,MAAM,sBAAsB,EAAE,gBA6BpC,CAAC;AAEF,eAAO,MAAM,oBAAoB;;;;;;EAW/B,CAAC;AAEH,eAAe,oBAAoB,CAAC"}

package/dist/plugin.js

@@ -0,0 +1,61 @@
+"use strict";
+/**
+ * `@haneinfo/metadata-schema/plugin` — manifest and plugin descriptor (PL4-04).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.metadataSchemaPlugin = exports.metadataSchemaManifest = exports.MetaService = exports.MetaModule = exports.MetadataScopeGuard = exports.MetaController = exports.METADATA_SCHEMA = void 0;
+const plugin_api_1 = require("@haneinfo/plugin-api");
+Object.defineProperty(exports, "METADATA_SCHEMA", { enumerable: true, get: function () { return plugin_api_1.METADATA_SCHEMA; } });
+const meta_controller_1 = require("./meta.controller");
+Object.defineProperty(exports, "MetaController", { enumerable: true, get: function () { return meta_controller_1.MetaController; } });
+const meta_module_1 = require("./meta.module");
+Object.defineProperty(exports, "MetaModule", { enumerable: true, get: function () { return meta_module_1.MetaModule; } });
+const meta_service_1 = require("./meta.service");
+Object.defineProperty(exports, "MetaService", { enumerable: true, get: function () { return meta_service_1.MetaService; } });
+const meta_scope_guard_1 = require("./meta-scope.guard");
+Object.defineProperty(exports, "MetadataScopeGuard", { enumerable: true, get: function () { return meta_scope_guard_1.MetadataScopeGuard; } });
+/** Mirrors `haneinfo.plugin.json`; `plugin.spec.ts` fails if the two drift apart. */
+exports.metadataSchemaManifest = {
+    schemaVersion: 'haneinfo.plugin/v1',
+    id: 'metadata-schema',
+    displayName: 'Metadata Schema Introspection',
+    cardinality: 'singleton',
+    distribution: 'official',
+    engine: {
+        haneinfoPluginApi: '^1.0.0',
+        node: '>=22.0.0',
+        frameworks: {
+            '@nestjs/common': '^11.0.5',
+            '@nestjs/core': '^11.0.5',
+            '@prisma/client': '^6.2.0',
+        },
+    },
+    provides: ['haneinfo.metadata-schema'],
+    requires: ['haneinfo.prisma'],
+    optionalRequires: ['haneinfo.scope-matcher'],
+    facets: {
+        backend: {
+            modulePath: './dist/meta.module.js',
+            exportName: 'MetaModule',
+            controllerRoutes: ['metadata'],
+            providerTokens: ['haneinfo.metadata-schema'],
+        },
+        permissions: {
+            definitions: ['metadata:schema:read'],
+        },
+    },
+};
+exports.metadataSchemaPlugin = (0, plugin_api_1.definePlugin)({
+    manifest: exports.metadataSchemaManifest,
+    backend: () => ({
+        module: meta_module_1.MetaModule,
+        providers: [
+            {
+                provide: plugin_api_1.METADATA_SCHEMA,
+                useExisting: meta_service_1.MetaService,
+            },
+        ],
+    }),
+});
+exports.default = exports.metadataSchemaPlugin;
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,qDAK8B;AAO5B,gGAVA,4BAAe,OAUA;AANjB,uDAAmD;AAOjD,+FAPO,gCAAc,OAOP;AANhB,+CAA2C;AASzC,2FATO,wBAAU,OASP;AARZ,iDAA6C;AAS3C,4FATO,0BAAW,OASP;AARb,yDAAwD;AAMtD,mGANO,qCAAkB,OAMP;AAKpB,qFAAqF;AACxE,QAAA,sBAAsB,GAAqB;IACtD,aAAa,EAAE,oBAAoB;IACnC,EAAE,EAAE,iBAAiB;IACrB,WAAW,EAAE,+BAA+B;IAC5C,WAAW,EAAE,WAAW;IACxB,YAAY,EAAE,UAAU;IACxB,MAAM,EAAE;QACN,iBAAiB,EAAE,QAAQ;QAC3B,IAAI,EAAE,UAAU;QAChB,UAAU,EAAE;YACV,gBAAgB,EAAE,SAAS;YAC3B,cAAc,EAAE,SAAS;YACzB,gBAAgB,EAAE,QAAQ;SAC3B;KACF;IACD,QAAQ,EAAE,CAAC,0BAA0B,CAAC;IACtC,QAAQ,EAAE,CAAC,iBAAiB,CAAC;IAC7B,gBAAgB,EAAE,CAAC,wBAAwB,CAAC;IAC5C,MAAM,EAAE;QACN,OAAO,EAAE;YACP,UAAU,EAAE,uBAAuB;YACnC,UAAU,EAAE,YAAY;YACxB,gBAAgB,EAAE,CAAC,UAAU,CAAC;YAC9B,cAAc,EAAE,CAAC,0BAA0B,CAAC;SAC7C;QACD,WAAW,EAAE;YACX,WAAW,EAAE,CAAC,sBAAsB,CAAC;SACtC;KACF;CACF,CAAC;AAEW,QAAA,oBAAoB,GAAG,IAAA,yBAAY,EAAC;IAC/C,QAAQ,EAAE,8BAAsB;IAChC,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC;QACd,MAAM,EAAE,wBAAU;QAClB,SAAS,EAAE;YACT;gBACE,OAAO,EAAE,4BAAe;gBACxB,WAAW,EAAE,0BAAW;aACzB;SACF;KACF,CAAC;CACH,CAAC,CAAC;AAEH,kBAAe,4BAAoB,CAAC"}

package/haneinfo.plugin.json

@@ -0,0 +1,30 @@
+{
+  "schemaVersion": "haneinfo.plugin/v1",
+  "id": "metadata-schema",
+  "displayName": "Metadata Schema Introspection",
+  "cardinality": "singleton",
+  "distribution": "official",
+  "engine": {
+    "haneinfoPluginApi": "^1.0.0",
+    "node": ">=22.0.0",
+    "frameworks": {
+      "@nestjs/common": "^11.0.5",
+      "@nestjs/core": "^11.0.5",
+      "@prisma/client": "^6.2.0"
+    }
+  },
+  "provides": ["haneinfo.metadata-schema"],
+  "requires": ["haneinfo.prisma"],
+  "optionalRequires": ["haneinfo.scope-matcher"],
+  "facets": {
+    "backend": {
+      "modulePath": "./dist/meta.module.js",
+      "exportName": "MetaModule",
+      "controllerRoutes": ["metadata"],
+      "providerTokens": ["haneinfo.metadata-schema"]
+    },
+    "permissions": {
+      "definitions": ["metadata:schema:read"]
+    }
+  }
+}

package/package.json

@@ -1,6 +1,60 @@
 {
   "name": "@haneinfo/metadata-schema",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.1.3",
+  "private": false,
+  "files": [
+    "dist",
+    "haneinfo.plugin.json",
+    "plugin.js",
+    "plugin.d.ts"
+  ],
+  "type": "commonjs",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./plugin": {
+      "types": "./dist/plugin.d.ts",
+      "default": "./dist/plugin.js"
+    },
+    "./haneinfo.plugin.json": "./haneinfo.plugin.json",
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "tsc -p tsconfig.build.json --watch",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@haneinfo/common": "workspace:*",
+    "@haneinfo/plugin-api": "workspace:*",
+    "@haneinfo/plugin-host-nest": "workspace:*"
+  },
+  "peerDependencies": {
+    "@haneinfo/plugin-host-nest": "^2.0.0",
+    "@nestjs/common": "^11.0.0",
+    "@nestjs/core": "^11.0.0",
+    "@prisma/client": "^6.19.0"
+  },
+  "devDependencies": {
+    "@haneinfo/m2m-api-key": "workspace:*",
+    "@haneinfo/plugin-testkit": "workspace:*",
+    "@nestjs/common": "^11.0.0",
+    "@nestjs/core": "^11.0.0",
+    "@nestjs/platform-express": "^11.0.0",
+    "@nestjs/testing": "^11.0.0",
+    "@prisma/client": "^6.19.0",
+    "@types/node": "^24.13.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.11"
+  },
+  "license": "UNLICENSED",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  }
+}

package/plugin.d.ts

@@ -0,0 +1,3 @@
+// See plugin.js for why this file exists (classic/node10 moduleResolution compatibility shim).
+export * from './dist/plugin';
+export { default } from './dist/plugin';

package/plugin.js

@@ -0,0 +1,4 @@
+// Compatibility shim for consumers whose TypeScript config uses "classic"/"node10"
+// moduleResolution, which resolves `@haneinfo/metadata-schema/plugin` by looking for a real file at
+// the package root — it does not consult package.json's "exports" map at all.
+module.exports = require('./dist/plugin');