@spinekit/assets 0.1.1 → 0.1.2

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## 0.1.2 — 2026-08-26
+
+### Changed
+
+- **Module split** — `index.ts` monolith decomposed into `src/module.ts`,
+  `src/types.ts`, and `src/resources/fixed-asset/`. Public API unchanged;
+  the barrel re-exports all the same names. Also adds `createAssetResource`
+  as a named export for hosts that compose the resource separately.
+- **Peer floors raised** — `@classytic/assets` `>=0.5.1`,
+  `@spinekit/kit` `>=0.3.0`.
+
 ## 0.1.1 — 2026-08-20
 
 ### Changed

package/dist/index.d.mts

@@ -1,11 +1,11 @@
-import { SpineTenantInput } from "@spinekit/kit/tenant";
 import { AssetsContext, AssetsEngine, LedgerPort } from "@classytic/assets";
-import { ScheduleDefinition } from "@classytic/arc/plugins";
-import { PermissionGate } from "@spinekit/kit/permissions";
+import { SpineTenantInput } from "@spinekit/kit/tenant";
 import { EventTransport } from "@classytic/primitives/events";
 import { OutboxStore } from "@classytic/primitives/outbox";
-import { Connection } from "mongoose";
+import { PermissionGate } from "@spinekit/kit/permissions";
 import { FastifyInstance } from "fastify";
+import { Connection } from "mongoose";
+import { ScheduleDefinition } from "@classytic/arc/plugins";
 //#region src/schedules.d.ts
 interface AssetsMaintenanceOptions {
   /** Automated depreciation posting sweep interval. Default daily (with jitter). */
@@ -21,7 +21,7 @@ interface AssetsMaintenanceOptions {
 }
 declare function assetsMaintenanceSchedules(engine: AssetsEngine, options?: AssetsMaintenanceOptions): ScheduleDefinition[];
 //#endregion
-//#region src/index.d.ts
+//#region src/types.d.ts
 interface AssetsPermissions {
   /** Read register / schedules / valuations. */
   view: PermissionGate;
@@ -73,6 +73,15 @@ interface AssetsModuleDeps {
    * this cannot become a production hot-reload path.)
    */
   forceRecreate?: boolean;
+  /**
+   * Mongoose `autoIndex` for every managed schema. Default `true`
+   * (`@classytic/assets`'s own default — sensible for the package used
+   * standalone). Never forwarded from this module until now, so a deployment
+   * running `shouldAutoIndex()`-gated indexing everywhere else
+   * (`#shared/db/auto-index.js`) had no way to reach it here, and the fixed-asset
+   * collections re-synced their indexes against Atlas on every boot regardless.
+   */
+  autoIndex?: boolean;
   /**
    * Accept a backend without multi-document transactions. DEV/TEST ONLY.
    *
@@ -91,6 +100,23 @@ interface AssetsModuleDeps {
    */
   maintenance?: AssetsMaintenanceOptions | false;
 }
+//#endregion
+//#region src/module.d.ts
+/**
+ * @spinekit/assets - fixed-asset register + multi-book depreciation +
+ * IAS 16/36 valuation over the @classytic/assets 0.3 mongokit engine.
+ *
+ * One composition surface (wiki/modules.md): createAssetsModule(deps).
+ * The kernel owns models/repos/services + the LedgerPort contract; this
+ * module owns the WIRE (CRUD + 12 lifecycle/valuation actions + onboard +
+ * schedule/valuation reads). The GL ACCOUNT MAP stays HOST policy - the
+ * host implements LedgerPort.postEntry (category -> chart account) and
+ * injects it. Company-wide register by default (tenant disabled);
+ * currency is host config; category enum is host policy.
+ */
+declare function createAssetsModule(deps: AssetsModuleDeps): import("@classytic/arc/factory").ArcModule<AssetsEngine>;
+//#endregion
+//#region src/resources/fixed-asset/fixed-asset.resource.d.ts
 /**
  * Build the fixed-asset resource over a live assets engine. Exported so a
  * host can mount it directly (custom module composition).
@@ -105,6 +131,5 @@ declare function createAssetResource(args: {
 }): import("@classytic/arc").ResourceDefinition<import("@classytic/assets").AssetDocument | (import("mongoose").Document<unknown, {}, import("@classytic/assets").AssetDocument, {}, import("mongoose").DefaultSchemaOptions> & import("@classytic/assets").Asset & import("mongoose").Document<import("mongoose").Types.ObjectId, any, any, Record<string, any>, {}> & {
   id: string;
 })>;
-declare function createAssetsModule(deps: AssetsModuleDeps): import("@classytic/arc/factory").ArcModule<AssetsEngine>;
 //#endregion
-export { type AssetsMaintenanceOptions, AssetsModuleDeps, AssetsPermissions, assetsMaintenanceSchedules, createAssetResource, createAssetsModule };
+export { type AssetsMaintenanceOptions, type AssetsModuleDeps, type AssetsPermissions, assetsMaintenanceSchedules, createAssetResource, createAssetsModule };

package/dist/index.mjs

@@ -1,3 +1,4 @@
+import { DEPRECIATION_METHODS, defineAssets } from "@classytic/assets";
 import { defineEngineModule } from "@spinekit/kit/engine-module";
 import { resolveSpineTenant } from "@spinekit/kit/tenant";
 import { defineResource } from "@classytic/arc";
@@ -6,48 +7,9 @@ import { scopeFirstCtx } from "@classytic/arc/scope";
 import { ValidationError } from "@classytic/arc/utils";
 import { createMongooseAdapter } from "@classytic/mongokit/adapter";
 import { QueryParser } from "@classytic/mongokit";
-import { DEPRECIATION_METHODS, defineAssets } from "@classytic/assets";
 import { isCurrencyCode } from "@classytic/primitives/currency";
 import { money } from "@classytic/primitives/money";
-//#region src/schedules.ts
-const DAY = 864e5;
-function assetsMaintenanceSchedules(engine, options = {}) {
-	return [{
-		name: "assets.depreciation",
-		every: options.depreciationEvery ?? DAY,
-		leaseMs: Math.floor((options.depreciationEvery ?? DAY) * .9),
-		jitterMs: 9e5,
-		handler: async (fastify) => {
-			const ctx = {
-				actorId: "cron",
-				...options.context
-			};
-			const now = /* @__PURE__ */ new Date();
-			const active = await engine.models.FixedAsset.find({
-				status: "active",
-				deletedAt: null
-			}).select("_id name").lean();
-			let posted = 0;
-			for (const asset of active) try {
-				const schedule = await engine.repositories.schedule.findByAssetAndBook(String(asset._id), "accounting", ctx);
-				if (!schedule) continue;
-				const due = schedule.periods.filter((per) => per.status === "scheduled" && new Date(per.periodEnd) <= now).sort((a, b) => a.sequence - b.sequence);
-				for (const per of due) {
-					await engine.services.depreciation.postPeriod(String(asset._id), per.sequence, {}, ctx);
-					posted += 1;
-				}
-			} catch (err) {
-				fastify.log.error({
-					err,
-					assetId: String(asset._id)
-				}, "Depreciation posting failed for asset");
-			}
-			if (posted > 0) fastify.log.info({ posted }, "Depreciation periods auto-posted");
-		}
-	}];
-}
-//#endregion
-//#region src/index.ts
+//#region src/resources/fixed-asset/fixed-asset.schema.ts
 const createAssetWireBody = {
 	type: "object",
 	required: [
@@ -136,6 +98,47 @@ const updateAssetWireBody = {
 		}
 	}
 };
+const DEPRECIATION_SCHEMA = {
+	type: "object",
+	required: ["method", "periods"],
+	properties: {
+		method: {
+			type: "string",
+			enum: [
+				"straight_line",
+				"declining_balance",
+				"double_declining",
+				"sum_of_years_digits",
+				"units_of_production",
+				"manual"
+			]
+		},
+		periods: {
+			type: "integer",
+			minimum: 1,
+			maximum: 1200
+		},
+		decliningRate: {
+			type: "number",
+			exclusiveMinimum: 0,
+			maximum: 1
+		},
+		totalUnits: {
+			type: "integer",
+			minimum: 1
+		},
+		manualSchedule: {
+			type: "array",
+			items: {
+				type: "integer",
+				minimum: 0
+			}
+		}
+	},
+	additionalProperties: false
+};
+//#endregion
+//#region src/resources/fixed-asset/fixed-asset.resource.ts
 /**
 * Build the fixed-asset resource over a live assets engine. Exported so a
 * host can mount it directly (custom module composition).
@@ -165,45 +168,6 @@ function createAssetResource(args) {
 	* resolver serves routes, actions, and controller overrides alike.
 	*/
 	const ctxOf = (req) => scopeFirstCtx(req, { fallbackActorId: "system" });
-	const DEPRECIATION_SCHEMA = {
-		type: "object",
-		required: ["method", "periods"],
-		properties: {
-			method: {
-				type: "string",
-				enum: [
-					"straight_line",
-					"declining_balance",
-					"double_declining",
-					"sum_of_years_digits",
-					"units_of_production",
-					"manual"
-				]
-			},
-			periods: {
-				type: "integer",
-				minimum: 1,
-				maximum: 1200
-			},
-			decliningRate: {
-				type: "number",
-				exclusiveMinimum: 0,
-				maximum: 1
-			},
-			totalUnits: {
-				type: "integer",
-				minimum: 1
-			},
-			manualSchedule: {
-				type: "array",
-				items: {
-					type: "integer",
-					minimum: 0
-				}
-			}
-		},
-		additionalProperties: false
-	};
 	/**
 	* CREATE is the domain verb, declared as a WRITE VERB (arc 2.34 `writes`)
 	* rather than a controller override.
@@ -753,6 +717,58 @@ function createAssetResource(args) {
 		]
 	});
 }
+//#endregion
+//#region src/schedules.ts
+const DAY = 864e5;
+function assetsMaintenanceSchedules(engine, options = {}) {
+	return [{
+		name: "assets.depreciation",
+		every: options.depreciationEvery ?? DAY,
+		leaseMs: Math.floor((options.depreciationEvery ?? DAY) * .9),
+		jitterMs: 9e5,
+		handler: async (fastify) => {
+			const ctx = {
+				actorId: "cron",
+				...options.context
+			};
+			const now = /* @__PURE__ */ new Date();
+			const active = await engine.models.FixedAsset.find({
+				status: "active",
+				deletedAt: null
+			}).select("_id name").lean();
+			let posted = 0;
+			for (const asset of active) try {
+				const schedule = await engine.repositories.schedule.findByAssetAndBook(String(asset._id), "accounting", ctx);
+				if (!schedule) continue;
+				const due = schedule.periods.filter((per) => per.status === "scheduled" && new Date(per.periodEnd) <= now).sort((a, b) => a.sequence - b.sequence);
+				for (const per of due) {
+					await engine.services.depreciation.postPeriod(String(asset._id), per.sequence, {}, ctx);
+					posted += 1;
+				}
+			} catch (err) {
+				fastify.log.error({
+					err,
+					assetId: String(asset._id)
+				}, "Depreciation posting failed for asset");
+			}
+			if (posted > 0) fastify.log.info({ posted }, "Depreciation periods auto-posted");
+		}
+	}];
+}
+//#endregion
+//#region src/module.ts
+/**
+* @spinekit/assets - fixed-asset register + multi-book depreciation +
+* IAS 16/36 valuation over the @classytic/assets 0.3 mongokit engine.
+*
+* One composition surface (wiki/modules.md): createAssetsModule(deps).
+* The kernel owns models/repos/services + the LedgerPort contract; this
+* module owns the WIRE (CRUD + 12 lifecycle/valuation actions + onboard +
+* schedule/valuation reads). The GL ACCOUNT MAP stays HOST policy - the
+* host implements LedgerPort.postEntry (category -> chart account) and
+* injects it. Company-wide register by default (tenant disabled);
+* currency is host config; category enum is host policy.
+*/
 function createAssetsModule(deps) {
 	const maintenance = deps.maintenance;
 	const dependsOn = deps.dependsOn ?? (typeof deps.ledger === "function" ? ["accounting"] : []);
@@ -788,7 +804,8 @@ function createAssetsModule(deps) {
 			return defineAssets({
 				tenant: resolveSpineTenant(deps.tenant ?? false).input,
 				...deps.schemaOptions ? { schemaOptions: deps.schemaOptions } : {},
-				...deps.forceRecreate !== void 0 ? { forceRecreate: deps.forceRecreate } : {}
+				...deps.forceRecreate !== void 0 ? { forceRecreate: deps.forceRecreate } : {},
+				...deps.autoIndex !== void 0 ? { autoIndex: deps.autoIndex } : {}
 			}).bind(deps.connection, {
 				...ledger ? { bridges: { ledger } } : {},
 				...deps.eventTransport ? { eventTransport: deps.eventTransport } : {},

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spinekit/assets",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Arc module for @classytic/assets — fixed-asset register + multi-book depreciation + IAS 16/36 valuation as composable resources. BYO-engine or module-created; ledger bridge is host-injected (any chart of accounts). Depreciation posts through the bridge; GL account mapping stays host policy.",
   "type": "module",
   "license": "SEE LICENSE IN LICENSE",
@@ -19,18 +19,18 @@
     "CHANGELOG.md"
   ],
   "peerDependencies": {
-    "@classytic/arc": ">=2.34.0",
-    "@spinekit/kit": ">=0.1.0",
-    "@classytic/assets": ">=0.5.0",
-    "@classytic/mongokit": ">=3.34.0",
+    "@classytic/arc": ">=2.35.0",
+    "@classytic/assets": ">=0.5.1",
+    "@classytic/mongokit": ">=3.35.0",
+    "@spinekit/kit": ">=0.3.0",
     "mongoose": ">=9.4.1"
   },
   "devDependencies": {
-    "@classytic/arc": "^2.34.0",
+    "@classytic/arc": "^2.35.0",
     "@classytic/arc-testkit": "^0.4.0",
-    "@classytic/assets": ">=0.5.0",
-    "@classytic/mongokit": ">=3.34.0",
-    "@classytic/primitives": ">=0.23.0",
+    "@classytic/assets": ">=0.5.1",
+    "@classytic/mongokit": "^3.35.0",
+    "@classytic/primitives": ">=0.25.0",
     "@types/node": "^24.3.0",
     "fastify": "^5.12.0",
     "mongodb-memory-server": "^10.4.3",
@@ -38,7 +38,7 @@
     "tsdown": "^0.22.14",
     "typescript": "^7.0.2",
     "vitest": "^3.2.4",
-    "@spinekit/kit": "0.1.1"
+    "@spinekit/kit": "0.3.0"
   },
   "author": "Classytic",
   "homepage": "https://www.npmjs.com/package/@spinekit/assets",