@xemahq/object-projection-nest 0.1.0

package/LICENSE

@@ -0,0 +1,174 @@
+Xema Business Source License 1.1
+
+License text copyright (c) 2020 MariaDB Corporation Ab, All Rights Reserved.
+"Business Source License" is a trademark of MariaDB Corporation Ab.
+
+-----------------------------------------------------------------------------
+
+Parameters
+
+Licensor:  Neuralchowder Inc.
+
+Licensed Work:  Xema. The Licensed Work is (c) 2026 Neuralchowder Inc..
+
+  The Licensed Work includes, without limitation, Xema Core, Xema Runtime,
+  Xema Kernel, Xema control plane, Xema application runtime, Xema biome
+  runtime, Xema biome registry, Xema store services, Xema orchestration
+  services, Xema agents, Xema skills, Xema memory services, Xema APIs, Xema
+  user interfaces, Xema command-line tools, Xema deployment artifacts, Xema
+  templates, Xema specifications, Xema schemas, Xema manifests, Xema
+  documentation, Xema examples, and all source code, object code, binaries,
+  packages, modules, configuration files, manifests, schemas, examples,
+  templates, documentation, and derivative works included in or distributed
+  as part of the Xema software project.
+
+  The Licensed Work does not include any third-party software, libraries,
+  dependencies, packages, assets, or components that are distributed with the
+  Licensed Work but are governed by their own separate license terms. Such
+  third-party materials remain subject to their respective licenses.
+
+  A specific file, package, component, or directory may state that it is
+  governed by a different license. In that case, that specific file, package,
+  component, or directory is governed by the license expressly stated therein.
+
+Additional Use Grant:
+
+  You may make production use of the Licensed Work, provided that your use
+  does not include offering, providing, making available, distributing,
+  hosting, managing, embedding, reselling, white-labeling, sublicensing,
+  commercializing, or otherwise making the Licensed Work, or any modified
+  version or derivative work of the Licensed Work, available to Third Parties
+  as part of a Competitive Offering.
+
+The following definitions and clarifications form part of, and govern
+the interpretation of, the Additional Use Grant set out above.
+
+  1. "Production Use" means any use of the Licensed Work other than for
+     development, testing, evaluation, demonstration, experimentation,
+     benchmarking, or other non-production purposes.
+
+  2. "Affiliate" means any entity that, directly or indirectly,
+     controls, is controlled by, or is under common control with you,
+     where "control" means ownership of more than fifty percent (50%) of
+     the voting interests of the entity, or the power to direct its
+     management.
+
+  3. "Third Party" means any natural person or legal entity other than
+     you and your Affiliates.
+
+  4. "Competitive Offering" means any product or service, made available
+     to one or more Third Parties for a fee or other consideration
+     (including without limitation on a paid, subscription,
+     advertising-supported, hosted, or managed-service basis), that is
+     offered or marketed as, or that competes with, a software platform,
+     runtime, orchestration system, agent or automation system,
+     extension or distribution marketplace, or other software system
+     that provides, in substantial part, the same or substantially
+     similar capabilities as those provided by the Licensed Work. A
+     product or service is a Competitive Offering whether the Licensed
+     Work is provided in whole or in part, alone or bundled with other
+     software, and whether modified or unmodified.
+
+  5. Providing, hosting, or managing the Licensed Work for a Third Party,
+     or otherwise making the Licensed Work available to a Third Party as
+     a hosted or managed service such that the Third Party obtains the
+     principal value or functionality of the Licensed Work, is a
+     Competitive Offering and is not permitted by the Additional Use
+     Grant.
+
+  6. Subject to the foregoing, the Additional Use Grant permits you to
+     make Production Use of the Licensed Work for your own internal
+     business purposes and to build, operate, and provide your own
+     products and services to Third Parties, provided that the Licensed
+     Work itself (whether modified or unmodified) is not the product or
+     service, and is not a Competitive Offering, made available to those
+     Third Parties.
+
+  7. You may modify the Licensed Work and create derivative works for
+     any purpose permitted by this License. Any Production Use of such
+     modified or derivative works remains subject to the same
+     restrictions as the Licensed Work, including the prohibition on
+     Competitive Offerings.
+
+  8. Use of the Licensed Work by your own employees, contractors, and
+     agents, acting on your behalf and for your benefit, is not by
+     itself making the Licensed Work available to a Third Party.
+
+  9. Embedding or distributing the Licensed Work as a component of your
+     own product or service is permitted only where the Licensed Work
+     does not constitute the principal value of that product or service
+     and the product or service is not a Competitive Offering.
+
+  10. Nothing in this Additional Use Grant grants any right to use any
+      name, trademark, service mark, or logo of the Licensor or its
+      Affiliates, except as reasonably required for customary
+      attribution.
+
+  11. The rights stated in this Additional Use Grant are the maximum
+      rights granted for Production Use prior to the Change Date. Any
+      Production Use not expressly permitted requires a separate
+      commercial license from the Licensor.
+
+  12. If any provision of this Additional Use Grant is held invalid or
+      unenforceable, that provision shall be limited or eliminated to
+      the minimum extent necessary so that the remainder of this
+      Additional Use Grant, and of this License, remains in full force
+      and effect. The Licensor reserves all rights not expressly granted
+      by this License.
+
+Change Date:  Four years from the date the specific version of the Licensed
+  Work is first publicly released by Licensor.
+
+Change License:  Mozilla Public License, Version 2.0
+
+For information about alternative licensing arrangements, commercial
+licensing, enterprise licensing, OEM licensing, appliance licensing, managed
+service licensing, cloud provider licensing, or other commercial use of the
+Licensed Work, please contact: licensing@neuralchowder.com
+
+-----------------------------------------------------------------------------
+
+Notice
+
+Business Source License 1.1
+
+Terms
+
+The Licensor hereby grants you the right to copy, modify, create derivative
+works, redistribute, and make non-production use of the Licensed Work. The
+Licensor may make an Additional Use Grant, above, permitting limited
+production use.
+
+Effective on the Change Date, or the fourth anniversary of the first publicly
+available distribution of a specific version of the Licensed Work under this
+License, whichever comes first, the Licensor hereby grants you rights under
+the terms of the Change License, and the rights granted in the paragraph above
+terminate.
+
+If your use of the Licensed Work does not comply with the requirements
+currently in effect as described in this License, you must purchase a
+commercial license from the Licensor, its affiliated entities, or authorized
+resellers, or you must refrain from using the Licensed Work.
+
+All copies of the original and modified Licensed Work, and derivative works of
+the Licensed Work, are subject to this License. This License applies separately
+for each version of the Licensed Work and the Change Date may vary for each
+version of the Licensed Work released by Licensor.
+
+You must conspicuously display this License on each original or modified copy
+of the Licensed Work. If you receive the Licensed Work in original or modified
+form from a third party, the terms and conditions set forth in this License
+apply to your use of that work.
+
+Any use of the Licensed Work in violation of this License will automatically
+terminate your rights under this License for the current and all other
+versions of the Licensed Work.
+
+This License does not grant you any right in any trademark or logo of Licensor
+or its affiliates, provided that you may use a trademark or logo of Licensor
+as expressly required by this License.
+
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON AN
+"AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS, EXPRESS
+OR IMPLIED, INCLUDING WITHOUT LIMITATION WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND TITLE.

package/README.md

@@ -0,0 +1,69 @@
+# @xemahq/object-projection-nest
+
+This package belongs to Layer 1 — it is a kernel-side NestJS SDK with zero
+domain knowledge and no dependency on any Xema service.
+
+It ships the shared implementation of the **XSI plane-1 object projection**
+surface that every XemaObject-owning service exposes so
+`object-registry-api` can build the platform-wide object index:
+
+| piece | export |
+| --- | --- |
+| `GET /describe-objects` wire DTOs | `DescribeObjectsResponseDto`, `XemaObjectResponseDto`, `XemaSpaceRefDto`, `XemaSubjectRefDto` |
+| CloudEvent descriptor factory | `defineObjectProjectionEvents(serviceName)` |
+| boot + periodic + debounced publisher | `ObjectProjectionPublisherService` |
+
+## Producer shape
+
+A producing service adds one `describe-objects/` folder:
+
+```ts
+// projection-events.registry.ts
+export const { descriptor: ObjectRegistryProjectionPublishedEvent, descriptors } =
+  defineObjectProjectionEvents('knowledge-base-api');
+
+// describe-objects.service.ts — builds the COMPLETE current slice
+@Injectable()
+export class DescribeObjectsService {
+  async buildEnvelope(): Promise<DescribeObjectsResponseDto> { /* … */ }
+}
+
+// projection-publisher.service.ts — PUSH path (optional; PULL alone is valid)
+@Injectable()
+export class ProjectionPublisherService extends ObjectProjectionPublisherService {
+  constructor(
+    publisher: DescriptorEventPublisherService,
+    describeObjects: DescribeObjectsService,
+  ) {
+    super(publisher, {
+      source: KNOWLEDGE_BASE_PROJECTION_SOURCE,
+      descriptor: ObjectRegistryProjectionPublishedEvent,
+      buildEnvelope: () => describeObjects.buildEnvelope(),
+    });
+  }
+}
+```
+
+## Layout note
+
+Sources live under `src/projection/` (not `src/lib/`) and the package declares a
+`./*` subpath export. This is load-bearing, not cosmetic: the `@nestjs/swagger`
+CLI plugin emits a `require()` of a DTO's *physical declaration path*, which
+`tooling/codegen/scrub-swagger-plugin-paths.mjs` rewrites to
+`@xemahq/<pkg>/<first-dir-under-dist>`. If that directory is not a resolvable
+subpath export, every consuming pod crashes at boot with
+`ERR_PACKAGE_PATH_NOT_EXPORTED`. Same convention as
+`@xemahq/kernel-contracts`. Consumers import from the package root.
+
+## Invariants
+
+- A projection is always the **COMPLETE** slice. The registry REPLACES its
+  cache slice keyed by `source` atomically; there is no delta primitive.
+- `payload` is opaque on the wire. The per-kind payload schema is owned by the
+  producing service's domain contract; plane 1 carries it through and plane 3
+  (Capability) is the validation point.
+- A row that cannot be projected (missing scope qualifier, missing version)
+  MUST throw a typed error carrying the row id. Never skip it silently.
+- The publisher logs and does not rethrow on transport failure — a
+  cache-refresh push must not crash its host. The periodic tick retries and the
+  consumer can always recover the same slice over the pull path.

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from './projection';
+//# 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":"AAcA,cAAc,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,18 @@
+"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 });
+__exportStar(require("./projection"), 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":";;;;;;;;;;;;;;;;AAcA,+CAA6B"}

package/dist/projection/describe-objects.dto.d.ts

@@ -0,0 +1,29 @@
+import { ObjectLifecycle, XemaObjectKind } from '@xemahq/kernel-contracts/object';
+import { SpaceKind } from '@xemahq/kernel-contracts/space';
+export declare class XemaSubjectRefDto {
+    kind: string;
+    ref: string;
+}
+export declare class XemaSpaceRefDto {
+    tier: SpaceKind;
+    orgId?: string;
+    projectId?: string;
+    appId?: string;
+    sessionId?: string;
+    biomeId?: string;
+    userId?: string;
+}
+export declare class XemaObjectResponseDto {
+    ref: string;
+    kind: XemaObjectKind;
+    scope: XemaSpaceRefDto;
+    owner: XemaSubjectRefDto;
+    version: string;
+    lifecycle: ObjectLifecycle;
+    payload: Record<string, unknown>;
+}
+export declare class DescribeObjectsResponseDto {
+    source: string;
+    objects: XemaObjectResponseDto[];
+}
+//# sourceMappingURL=describe-objects.dto.d.ts.map

package/dist/projection/describe-objects.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe-objects.dto.d.ts","sourceRoot":"","sources":["../../src/projection/describe-objects.dto.ts"],"names":[],"mappings":"AACA,OAAO,EACL,eAAe,EACf,cAAc,EACf,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAmB3D,qBAAa,iBAAiB;IAM5B,IAAI,EAAG,MAAM,CAAC;IAMd,GAAG,EAAG,MAAM,CAAC;CACd;AAQD,qBAAa,eAAe;IAO1B,IAAI,EAAG,SAAS,CAAC;IAGjB,KAAK,CAAC,EAAE,MAAM,CAAC;IAGf,SAAS,CAAC,EAAE,MAAM,CAAC;IAGnB,KAAK,CAAC,EAAE,MAAM,CAAC;IAGf,SAAS,CAAC,EAAE,MAAM,CAAC;IAGnB,OAAO,CAAC,EAAE,MAAM,CAAC;IAGjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAeD,qBAAa,qBAAqB;IAKhC,GAAG,EAAG,MAAM,CAAC;IAOb,IAAI,EAAG,cAAc,CAAC;IAGtB,KAAK,EAAG,eAAe,CAAC;IAGxB,KAAK,EAAG,iBAAiB,CAAC;IAO1B,OAAO,EAAG,MAAM,CAAC;IAOjB,SAAS,EAAG,eAAe,CAAC;IAQ5B,OAAO,EAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAUD,qBAAa,0BAA0B;IAMrC,MAAM,EAAG,MAAM,CAAC;IAMhB,OAAO,EAAG,qBAAqB,EAAE,CAAC;CACnC"}

package/dist/projection/describe-objects.dto.js

@@ -0,0 +1,152 @@
+"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);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DescribeObjectsResponseDto = exports.XemaObjectResponseDto = exports.XemaSpaceRefDto = exports.XemaSubjectRefDto = void 0;
+const swagger_1 = require("@nestjs/swagger");
+const object_1 = require("@xemahq/kernel-contracts/object");
+const space_1 = require("@xemahq/kernel-contracts/space");
+class XemaSubjectRefDto {
+    kind;
+    ref;
+}
+exports.XemaSubjectRefDto = XemaSubjectRefDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Subject kind. Projections stamp `service` — the owning platform service, not the authoring human.',
+        example: 'service',
+    }),
+    __metadata("design:type", String)
+], XemaSubjectRefDto.prototype, "kind", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Subject reference; for a `service` subject, the service name.',
+        example: 'skill-registry-api',
+    }),
+    __metadata("design:type", String)
+], XemaSubjectRefDto.prototype, "ref", void 0);
+class XemaSpaceRefDto {
+    tier;
+    orgId;
+    projectId;
+    appId;
+    sessionId;
+    biomeId;
+    userId;
+}
+exports.XemaSpaceRefDto = XemaSpaceRefDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        enum: space_1.SpaceKind,
+        enumName: 'SpaceKind',
+        description: 'Ownership tier (system | org | project | app | session | biome | user).',
+    }),
+    __metadata("design:type", String)
+], XemaSpaceRefDto.prototype, "tier", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ required: false }),
+    __metadata("design:type", String)
+], XemaSpaceRefDto.prototype, "orgId", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ required: false }),
+    __metadata("design:type", String)
+], XemaSpaceRefDto.prototype, "projectId", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ required: false }),
+    __metadata("design:type", String)
+], XemaSpaceRefDto.prototype, "appId", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ required: false }),
+    __metadata("design:type", String)
+], XemaSpaceRefDto.prototype, "sessionId", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ required: false }),
+    __metadata("design:type", String)
+], XemaSpaceRefDto.prototype, "biomeId", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ required: false }),
+    __metadata("design:type", String)
+], XemaSpaceRefDto.prototype, "userId", void 0);
+class XemaObjectResponseDto {
+    ref;
+    kind;
+    scope;
+    owner;
+    version;
+    lifecycle;
+    payload;
+}
+exports.XemaObjectResponseDto = XemaObjectResponseDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Canonical XemaObjectRef.',
+        example: 'xema://system/skill/software-engineering/requirements@1.0.0',
+    }),
+    __metadata("design:type", String)
+], XemaObjectResponseDto.prototype, "ref", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        enum: object_1.XemaObjectKind,
+        enumName: 'XemaObjectKind',
+        description: 'Closed kind enum this object belongs to.',
+    }),
+    __metadata("design:type", String)
+], XemaObjectResponseDto.prototype, "kind", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ type: XemaSpaceRefDto }),
+    __metadata("design:type", XemaSpaceRefDto)
+], XemaObjectResponseDto.prototype, "scope", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ type: XemaSubjectRefDto }),
+    __metadata("design:type", XemaSubjectRefDto)
+], XemaObjectResponseDto.prototype, "owner", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Object version. Semver where the kind is semver-versioned, otherwise the kind-native revision token (commit SHA, monotonic revision, `1` for unversioned kinds).',
+        example: '1.0.0',
+    }),
+    __metadata("design:type", String)
+], XemaObjectResponseDto.prototype, "version", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        enum: object_1.ObjectLifecycle,
+        enumName: 'ObjectLifecycle',
+        description: 'draft | published | archived.',
+    }),
+    __metadata("design:type", String)
+], XemaObjectResponseDto.prototype, "lifecycle", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        type: 'object',
+        additionalProperties: true,
+        description: 'Kind-specific payload. The schema is owned by the producing service; plane 1 carries it opaquely.',
+    }),
+    __metadata("design:type", Object)
+], XemaObjectResponseDto.prototype, "payload", void 0);
+class DescribeObjectsResponseDto {
+    source;
+    objects;
+}
+exports.DescribeObjectsResponseDto = DescribeObjectsResponseDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Owning-service identifier. The registry replaces the cache slice keyed by this value atomically.',
+        example: 'skill-registry-api',
+    }),
+    __metadata("design:type", String)
+], DescribeObjectsResponseDto.prototype, "source", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        type: [XemaObjectResponseDto],
+        description: 'Full set of XemaObjects this service currently owns.',
+    }),
+    __metadata("design:type", Array)
+], DescribeObjectsResponseDto.prototype, "objects", void 0);
+//# sourceMappingURL=describe-objects.dto.js.map

package/dist/projection/describe-objects.dto.js.map

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

package/dist/projection/index.d.ts

@@ -0,0 +1,4 @@
+export * from './describe-objects.dto';
+export * from './projection-events';
+export * from './object-projection-publisher.service';
+//# sourceMappingURL=index.d.ts.map

package/dist/projection/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/projection/index.ts"],"names":[],"mappings":"AAiBA,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uCAAuC,CAAC"}

package/dist/projection/index.js

@@ -0,0 +1,20 @@
+"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 });
+__exportStar(require("./describe-objects.dto"), exports);
+__exportStar(require("./projection-events"), exports);
+__exportStar(require("./object-projection-publisher.service"), exports);
+//# sourceMappingURL=index.js.map

package/dist/projection/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/projection/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAiBA,yDAAuC;AACvC,sDAAoC;AACpC,wEAAsD"}

package/dist/projection/object-projection-publisher.service.d.ts

@@ -0,0 +1,33 @@
+import { Logger, type OnApplicationBootstrap, type OnApplicationShutdown } from '@nestjs/common';
+import { DescriptorEventPublisherService } from '@xemahq/events/nest';
+import type { DescribeObjectsResponseDto } from './describe-objects.dto';
+import type { ObjectProjectionPublishedDescriptor } from './projection-events';
+export declare const PROJECTION_DEBOUNCE_MS = 1000;
+export declare const PROJECTION_REFRESH_INTERVAL_MS = 60000;
+export declare const PLATFORM_ORG_ID = "system";
+export declare enum ObjectProjectionPublishReason {
+    Boot = "boot",
+    Periodic = "periodic",
+    Manual = "manual",
+    Change = "change"
+}
+export interface ObjectProjectionPublisherOptions {
+    readonly source: string;
+    readonly descriptor: ObjectProjectionPublishedDescriptor;
+    buildEnvelope(): Promise<DescribeObjectsResponseDto>;
+}
+export declare abstract class ObjectProjectionPublisherService implements OnApplicationBootstrap, OnApplicationShutdown {
+    private readonly publisher;
+    private readonly options;
+    protected readonly logger: Logger;
+    private timer;
+    private debounceTimer;
+    private publishing;
+    protected constructor(publisher: DescriptorEventPublisherService, options: ObjectProjectionPublisherOptions);
+    onApplicationBootstrap(): Promise<void>;
+    onApplicationShutdown(): void;
+    protected scheduleRepublish(): void;
+    publishProjection(reason: ObjectProjectionPublishReason): Promise<void>;
+    private platformContext;
+}
+//# sourceMappingURL=object-projection-publisher.service.d.ts.map

package/dist/projection/object-projection-publisher.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"object-projection-publisher.service.d.ts","sourceRoot":"","sources":["../../src/projection/object-projection-publisher.service.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,MAAM,EACN,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC3B,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,+BAA+B,EAEhC,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,KAAK,EAAE,mCAAmC,EAAE,MAAM,qBAAqB,CAAC;AAO/E,eAAO,MAAM,sBAAsB,OAAQ,CAAC;AAO5C,eAAO,MAAM,8BAA8B,QAAS,CAAC;AAOrD,eAAO,MAAM,eAAe,WAAW,CAAC;AAMxC,oBAAY,6BAA6B;IACvC,IAAI,SAAS;IACb,QAAQ,aAAa;IACrB,MAAM,WAAW;IACjB,MAAM,WAAW;CAClB;AAKD,MAAM,WAAW,gCAAgC;IAO/C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAMxB,QAAQ,CAAC,UAAU,EAAE,mCAAmC,CAAC;IAOzD,aAAa,IAAI,OAAO,CAAC,0BAA0B,CAAC,CAAC;CACtD;AA8BD,8BAAsB,gCACpB,YAAW,sBAAsB,EAAE,qBAAqB;IAStD,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAR1B,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAElC,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,UAAU,CAAS;IAE3B,SAAS,aACU,SAAS,EAAE,+BAA+B,EAC1C,OAAO,EAAE,gCAAgC;IAOtD,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC;IAe7C,qBAAqB,IAAI,IAAI;IAmB7B,SAAS,CAAC,iBAAiB,IAAI,IAAI;IAsB7B,iBAAiB,CACrB,MAAM,EAAE,6BAA6B,GACpC,OAAO,CAAC,IAAI,CAAC;IA2DhB,OAAO,CAAC,eAAe;CAQxB"}

package/dist/projection/object-projection-publisher.service.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ObjectProjectionPublisherService = exports.ObjectProjectionPublishReason = exports.PLATFORM_ORG_ID = exports.PROJECTION_REFRESH_INTERVAL_MS = exports.PROJECTION_DEBOUNCE_MS = void 0;
+const node_crypto_1 = require("node:crypto");
+const common_1 = require("@nestjs/common");
+const events_1 = require("@xemahq/events");
+exports.PROJECTION_DEBOUNCE_MS = 1_000;
+exports.PROJECTION_REFRESH_INTERVAL_MS = 60_000;
+exports.PLATFORM_ORG_ID = 'system';
+var ObjectProjectionPublishReason;
+(function (ObjectProjectionPublishReason) {
+    ObjectProjectionPublishReason["Boot"] = "boot";
+    ObjectProjectionPublishReason["Periodic"] = "periodic";
+    ObjectProjectionPublishReason["Manual"] = "manual";
+    ObjectProjectionPublishReason["Change"] = "change";
+})(ObjectProjectionPublishReason || (exports.ObjectProjectionPublishReason = ObjectProjectionPublishReason = {}));
+class ObjectProjectionPublisherService {
+    publisher;
+    options;
+    logger;
+    timer;
+    debounceTimer;
+    publishing = false;
+    constructor(publisher, options) {
+        this.publisher = publisher;
+        this.options = options;
+        this.logger = new common_1.Logger(`ObjectProjectionPublisher(${options.source})`);
+    }
+    async onApplicationBootstrap() {
+        await this.publishProjection(ObjectProjectionPublishReason.Boot);
+        this.timer = setInterval(() => {
+            void this.publishProjection(ObjectProjectionPublishReason.Periodic);
+        }, exports.PROJECTION_REFRESH_INTERVAL_MS);
+        this.timer.unref();
+    }
+    onApplicationShutdown() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = undefined;
+        }
+        if (this.debounceTimer) {
+            clearTimeout(this.debounceTimer);
+            this.debounceTimer = undefined;
+        }
+    }
+    scheduleRepublish() {
+        if (this.debounceTimer) {
+            clearTimeout(this.debounceTimer);
+        }
+        this.debounceTimer = setTimeout(() => {
+            this.debounceTimer = undefined;
+            void this.publishProjection(ObjectProjectionPublishReason.Change);
+        }, exports.PROJECTION_DEBOUNCE_MS);
+        this.debounceTimer.unref();
+    }
+    async publishProjection(reason) {
+        if (this.publishing) {
+            this.logger.warn(`Skipping ${reason} projection publish — previous publish still in flight`);
+            return;
+        }
+        this.publishing = true;
+        try {
+            const envelope = await this.options.buildEnvelope();
+            if (envelope.source !== this.options.source) {
+                throw new Error(`Projection envelope source "${envelope.source}" does not match ` +
+                    `the configured publisher source "${this.options.source}".`);
+            }
+            await this.publisher.publish(this.options.descriptor, envelope, this.platformContext(), {});
+            this.logger.log(`Published ${this.options.descriptor.type} ` +
+                `reason=${reason} source=${envelope.source} ` +
+                `objectCount=${envelope.objects.length}`);
+        }
+        catch (err) {
+            this.logger.error({
+                message: 'Failed to publish object-registry projection',
+                descriptor: this.options.descriptor.type,
+                reason,
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+        finally {
+            this.publishing = false;
+        }
+    }
+    platformContext() {
+        return {
+            orgId: exports.PLATFORM_ORG_ID,
+            actorType: events_1.ActorType.SERVICE,
+            actorId: this.options.source,
+            correlationId: (0, node_crypto_1.randomUUID)(),
+        };
+    }
+}
+exports.ObjectProjectionPublisherService = ObjectProjectionPublisherService;
+//# sourceMappingURL=object-projection-publisher.service.js.map

package/dist/projection/object-projection-publisher.service.js.map

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

package/dist/projection/projection-events.d.ts

@@ -0,0 +1,32 @@
+import { type EventDescriptor } from '@xemahq/events';
+import { z } from 'zod';
+export declare const OBJECT_REGISTRY_PROJECTION_PUBLISHED_TYPE = "xema.object-registry.projection.published.v1";
+export declare const XEMA_OBJECT_WIRE_SCHEMA: z.ZodObject<{
+    ref: z.ZodString;
+    kind: z.ZodString;
+    version: z.ZodString;
+    lifecycle: z.ZodString;
+    scope: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    owner: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$loose>;
+export declare const OBJECT_PROJECTION_DATA_SCHEMA: z.ZodObject<{
+    source: z.ZodString;
+    objects: z.ZodArray<z.ZodObject<{
+        ref: z.ZodString;
+        kind: z.ZodString;
+        version: z.ZodString;
+        lifecycle: z.ZodString;
+        scope: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        owner: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, z.core.$loose>>;
+}, z.core.$strip>;
+export declare const OBJECT_PROJECTION_HINT_SCHEMA: z.ZodObject<{}, z.core.$strip>;
+export type ObjectProjectionPublishedDescriptor = EventDescriptor<typeof OBJECT_REGISTRY_PROJECTION_PUBLISHED_TYPE, typeof OBJECT_PROJECTION_DATA_SCHEMA, typeof OBJECT_PROJECTION_HINT_SCHEMA>;
+export interface ObjectProjectionEvents {
+    readonly descriptor: ObjectProjectionPublishedDescriptor;
+    readonly descriptors: readonly [ObjectProjectionPublishedDescriptor];
+}
+export declare function defineObjectProjectionEvents(serviceName: string): ObjectProjectionEvents;
+//# sourceMappingURL=projection-events.d.ts.map

package/dist/projection/projection-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection-events.d.ts","sourceRoot":"","sources":["../../src/projection/projection-events.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,eAAe,EACrB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAcxB,eAAO,MAAM,yCAAyC,iDACN,CAAC;AAUjD,eAAO,MAAM,uBAAuB;;;;;;;;iBAUpB,CAAC;AAGjB,eAAO,MAAM,6BAA6B;;;;;;;;;;;iBAGxC,CAAC;AAGH,eAAO,MAAM,6BAA6B,gCAAe,CAAC;AAO1D,MAAM,MAAM,mCAAmC,GAAG,eAAe,CAC/D,OAAO,yCAAyC,EAChD,OAAO,6BAA6B,EACpC,OAAO,6BAA6B,CACrC,CAAC;AAUF,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,UAAU,EAAE,mCAAmC,CAAC;IACzD,QAAQ,CAAC,WAAW,EAAE,SAAS,CAAC,mCAAmC,CAAC,CAAC;CACtE;AAcD,wBAAgB,4BAA4B,CAC1C,WAAW,EAAE,MAAM,GAClB,sBAAsB,CAkBxB"}

package/dist/projection/projection-events.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OBJECT_PROJECTION_HINT_SCHEMA = exports.OBJECT_PROJECTION_DATA_SCHEMA = exports.XEMA_OBJECT_WIRE_SCHEMA = exports.OBJECT_REGISTRY_PROJECTION_PUBLISHED_TYPE = void 0;
+exports.defineObjectProjectionEvents = defineObjectProjectionEvents;
+const events_1 = require("@xemahq/events");
+const zod_1 = require("zod");
+exports.OBJECT_REGISTRY_PROJECTION_PUBLISHED_TYPE = 'xema.object-registry.projection.published.v1';
+exports.XEMA_OBJECT_WIRE_SCHEMA = zod_1.z
+    .object({
+    ref: zod_1.z.string().min(1),
+    kind: zod_1.z.string().min(1),
+    version: zod_1.z.string().min(1),
+    lifecycle: zod_1.z.string().min(1),
+    scope: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()),
+    owner: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()),
+    payload: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()),
+})
+    .passthrough();
+exports.OBJECT_PROJECTION_DATA_SCHEMA = zod_1.z.object({
+    source: zod_1.z.string().min(1),
+    objects: zod_1.z.array(exports.XEMA_OBJECT_WIRE_SCHEMA),
+});
+exports.OBJECT_PROJECTION_HINT_SCHEMA = zod_1.z.object({});
+function defineObjectProjectionEvents(serviceName) {
+    const descriptor = (0, events_1.defineEvent)({
+        type: exports.OBJECT_REGISTRY_PROJECTION_PUBLISHED_TYPE,
+        source: (0, events_1.serviceSource)(serviceName),
+        schemaVersion: '1.0.0',
+        visibility: events_1.VisibilityTier.INTERNAL,
+        description: "XSI plane-1 projection of one owning service's slice of the XemaObject universe. Replaces the registry cache slice keyed by `source` atomically.",
+        data: exports.OBJECT_PROJECTION_DATA_SCHEMA,
+        hint: exports.OBJECT_PROJECTION_HINT_SCHEMA,
+    });
+    return Object.freeze({
+        descriptor,
+        descriptors: Object.freeze([descriptor]),
+    });
+}
+//# sourceMappingURL=projection-events.js.map

package/dist/projection/projection-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection-events.js","sourceRoot":"","sources":["../../src/projection/projection-events.ts"],"names":[],"mappings":";;;AAwFA,oEAoBC;AA5GD,2CAKwB;AACxB,6BAAwB;AAcX,QAAA,yCAAyC,GACpD,8CAA8C,CAAC;AAUpC,QAAA,uBAAuB,GAAG,OAAC;KACrC,MAAM,CAAC;IACN,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACtB,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,KAAK,EAAE,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC;IACxC,KAAK,EAAE,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC;IACxC,OAAO,EAAE,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC;CAC3C,CAAC;KACD,WAAW,EAAE,CAAC;AAGJ,QAAA,6BAA6B,GAAG,OAAC,CAAC,MAAM,CAAC;IACpD,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,OAAO,EAAE,OAAC,CAAC,KAAK,CAAC,+BAAuB,CAAC;CAC1C,CAAC,CAAC;AAGU,QAAA,6BAA6B,GAAG,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAsC1D,SAAgB,4BAA4B,CAC1C,WAAmB;IAEnB,MAAM,UAAU,GAAG,IAAA,oBAAW,EAAC;QAC7B,IAAI,EAAE,iDAAyC;QAC/C,MAAM,EAAE,IAAA,sBAAa,EAAC,WAAW,CAAC;QAClC,aAAa,EAAE,OAAO;QACtB,UAAU,EAAE,uBAAc,CAAC,QAAQ;QACnC,WAAW,EACT,kJAAkJ;QACpJ,IAAI,EAAE,qCAA6B;QACnC,IAAI,EAAE,qCAA6B;KACpC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,UAAU;QACV,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,UAAU,CAErC,CAAC;KACH,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@xemahq/object-projection-nest",
+  "version": "0.1.0",
+  "description": "Shared NestJS building blocks for the XSI plane-1 object projection surface (`GET /describe-objects` + the `xema.object-registry.projection.published.v1` CloudEvent) that every XemaObject-owning service implements.",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "@nestjs/common": ">=11.0.0",
+    "@nestjs/swagger": ">=11.0.0",
+    "@xemahq/events": "^0.3.0",
+    "@xemahq/kernel-contracts": "^0.56.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@nestjs/common": "11.1.13",
+    "@nestjs/swagger": "11.2.6",
+    "@types/node": "25.2.3",
+    "@xemahq/events": "^0.3.0",
+    "@xemahq/kernel-contracts": "^0.56.0",
+    "typescript": "5.9.3",
+    "zod": "^4.3.6"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "xema-source": "./src/index.ts",
+      "default": "./dist/index.js"
+    },
+    "./*": {
+      "types": "./dist/*/index.d.ts",
+      "xema-source": "./src/*/index.ts",
+      "default": "./dist/*/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "license": "LicenseRef-Xema-BSL-1.1",
+  "author": "Neuralchowder Inc. <developer@xema.dev> (https://xema.dev)",
+  "homepage": "https://xema.dev",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xema-dev/xema-base.git",
+    "directory": "packages/sdks/object-projection-nest"
+  },
+  "scripts": {
+    "clean": "rm -rf dist",
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
+}