@lssm/example.crm-pipeline 0.0.0-canary-20251217080011 → 0.0.0-canary-20251219202229

package/dist/modules/audit-trail/dist/libs/contracts/dist/schema/dist/SchemaModel.js

@@ -1,39 +0,0 @@
-import "./EnumType.js";
-import "./FieldType.js";
-import * as z$1 from "zod";
-
-//#region ../../modules/audit-trail/dist/libs/contracts/dist/schema/dist/SchemaModel.js
-/**
-* Named object model built from FieldType/EnumType/SchemaModel fields.
-* Provides zod and GraphQL input helpers, and supports arrays/optional fields.
-*/
-var SchemaModel = class {
-	constructor(config) {
-		this.config = config;
-	}
-	/**
-	* Build a typed ZodObject from the model fields, preserving each field's
-	* Zod schema and optionality at the type level when possible.
-	*/
-	getZod() {
-		const shape = Object.entries(this.config.fields).reduce((acc, [key, def]) => {
-			const base = def.type.getZod();
-			const withArray = def.isArray ? z$1.array(base) : base;
-			acc[key] = def.isOptional ? withArray.optional() : withArray;
-			return acc;
-		}, {});
-		return z$1.object(shape);
-	}
-	/** Input object name for GraphQL builder adapters. */
-	getPothosInput() {
-		return this.config.name;
-	}
-};
-/**
-* Helper to define a SchemaModel with type inference.
-* Equivalent to `new SchemaModel(config)` but with better ergonomics.
-*/
-const defineSchemaModel = (config) => new SchemaModel(config);
-
-//#endregion
-export { SchemaModel, defineSchemaModel };

package/dist/modules/audit-trail/dist/libs/contracts/dist/schema/dist/entity/defineEntity.js

@@ -1 +0,0 @@
-import "zod";

package/dist/modules/audit-trail/dist/libs/contracts/dist/schema/dist/entity/index.js

@@ -1,2 +0,0 @@
-import "./defineEntity.js";
-import "./types.js";

package/dist/modules/audit-trail/dist/libs/contracts/dist/schema/dist/entity/types.js

@@ -1 +0,0 @@
-import "zod";

package/dist/modules/audit-trail/dist/libs/schema/dist/EnumType.js

@@ -1,56 +0,0 @@
-import * as z$1 from "zod";
-import { GraphQLEnumType } from "graphql";
-
-//#region ../../modules/audit-trail/dist/libs/schema/dist/EnumType.js
-/**
-* Strongly-typed string enum wrapper with one source of truth for zod, GraphQL, and JSON Schema.
-*/
-var EnumType = class {
-	name;
-	values;
-	gqlEnum;
-	constructor(name, values) {
-		this.name = name;
-		this.values = values;
-		this.gqlEnum = new GraphQLEnumType({
-			name: this.name,
-			values: Object.fromEntries(values.map((v) => [v, { value: v }]))
-		});
-	}
-	/** Enum type name (used by GraphQL and JSON Schema). */
-	getName() {
-		return this.name;
-	}
-	/** Returns the literal tuple of allowed values. */
-	getEnumValues() {
-		return this.values;
-	}
-	/** GraphQL enum instance suitable for Pothos or vanilla GraphQL schemas. */
-	getPothos() {
-		return this.gqlEnum;
-	}
-	/** zod schema representing this enum. */
-	getZod() {
-		return z$1.enum(this.values);
-	}
-	/** Minimal JSON representation (alias of getJsonSchema). */
-	getJson() {
-		return {
-			type: "string",
-			enum: this.values
-		};
-	}
-	/** JSON Schema for this enum. */
-	getJsonSchema() {
-		return this.getJson();
-	}
-};
-/**
-* Helper to define an EnumType.
-* @param name Display/type name used across GraphQL and JSON Schema
-* @param values Literal tuple of allowed string values (at least one)
-*/
-const defineEnum = (name, values) => new EnumType(name, values);
-
-//#endregion
-export { defineEnum };

package/dist/modules/audit-trail/dist/libs/schema/dist/FieldType.js

@@ -1,49 +0,0 @@
-import "zod";
-import { GraphQLScalarType } from "graphql";
-
-//#region ../../modules/audit-trail/dist/libs/schema/dist/FieldType.js
-/**
-* GraphQL scalar wrapper that carries zod and JSON Schema metadata.
-*
-* TInternal is the runtime representation; TExternal is the GraphQL output.
-*/
-var FieldType = class extends GraphQLScalarType {
-	zodSchema;
-	jsonSchemaDef;
-	constructor(config) {
-		super(config);
-		this.zodSchema = config.zod;
-		this.jsonSchemaDef = config.jsonSchema;
-	}
-	/** Return the attached zod schema for validation. */
-	getZod() {
-		return this.zodSchema;
-	}
-	/** GraphQL scalar instance usable by Pothos or vanilla GraphQL. */
-	getPothos() {
-		return this;
-	}
-	/** Return the JSON Schema (evaluates factory if provided). */
-	getJson() {
-		return typeof this.jsonSchemaDef === "function" ? this.jsonSchemaDef() : this.jsonSchemaDef;
-	}
-	getJsonSchemaDef() {
-		return this.jsonSchemaDef;
-	}
-	getJsonSchema() {
-		const deepResolve = (v) => {
-			const value = typeof v === "function" ? v() : v;
-			if (Array.isArray(value)) return value.map((item) => deepResolve(item));
-			if (value && typeof value === "object") {
-				const obj = {};
-				for (const [k, val] of Object.entries(value)) obj[k] = deepResolve(val);
-				return obj;
-			}
-			return value;
-		};
-		return deepResolve(this.getJson());
-	}
-};
-
-//#endregion
-export { FieldType };

package/dist/modules/audit-trail/dist/libs/schema/dist/ScalarTypeEnum.js

@@ -1,236 +0,0 @@
-import { FieldType } from "./FieldType.js";
-import * as z$1 from "zod";
-import { Kind } from "graphql";
-
-//#region ../../modules/audit-trail/dist/libs/schema/dist/ScalarTypeEnum.js
-const localeRegex = /^[A-Za-z]{2}(?:-[A-Za-z0-9]{2,8})*$/;
-const timezoneRegex = /^(?:UTC|[A-Za-z_]+\/[A-Za-z_]+)$/;
-const phoneRegex = /^[+]?\d[\d\s().-]{3,}$/;
-const currencyRegex = /^[A-Z]{3}$/;
-const countryRegex = /^[A-Z]{2}$/;
-const latMin = -90;
-const latMax = 90;
-const lonMin = -180;
-const lonMax = 180;
-/**
-* Factory functions for common scalar FieldTypes with zod/GraphQL/JSON Schema.
-*/
-const ScalarTypeEnum = {
-	String_unsecure: () => new FieldType({
-		name: "String_unsecure",
-		description: "Unvalidated string scalar",
-		zod: z$1.string(),
-		parseValue: (v) => z$1.string().parse(v),
-		serialize: (v) => String(v),
-		parseLiteral: (ast) => {
-			if (ast.kind !== Kind.STRING) throw new TypeError("Invalid literal");
-			return ast.value;
-		},
-		jsonSchema: { type: "string" }
-	}),
-	Int_unsecure: () => new FieldType({
-		name: "Int_unsecure",
-		description: "Unvalidated integer scalar",
-		zod: z$1.number().int(),
-		parseValue: (v) => {
-			const num = typeof v === "number" ? v : Number(v);
-			return z$1.number().int().parse(num);
-		},
-		serialize: (v) => Math.trunc(typeof v === "number" ? v : Number(v)),
-		parseLiteral: (ast) => {
-			if (ast.kind !== Kind.INT) throw new TypeError("Invalid literal");
-			return Number(ast.value);
-		},
-		jsonSchema: { type: "integer" }
-	}),
-	Float_unsecure: () => new FieldType({
-		name: "Float_unsecure",
-		description: "Unvalidated float scalar",
-		zod: z$1.number(),
-		parseValue: (v) => {
-			const num = typeof v === "number" ? v : Number(v);
-			return z$1.number().parse(num);
-		},
-		serialize: (v) => Number(v),
-		parseLiteral: (ast) => {
-			if (ast.kind !== Kind.FLOAT && ast.kind !== Kind.INT) throw new TypeError("Invalid literal");
-			return Number(ast.value);
-		},
-		jsonSchema: { type: "number" }
-	}),
-	Boolean: () => new FieldType({
-		name: "Boolean",
-		description: "Unvalidated boolean scalar",
-		zod: z$1.boolean(),
-		parseValue: (v) => z$1.coerce.boolean().parse(v),
-		serialize: (v) => Boolean(v),
-		parseLiteral: (ast) => {
-			if (ast.kind !== Kind.BOOLEAN) throw new TypeError("Invalid literal");
-			return ast.value;
-		},
-		jsonSchema: { type: "boolean" }
-	}),
-	ID: () => new FieldType({
-		name: "ID",
-		description: "Unvalidated id scalar",
-		zod: z$1.string(),
-		parseValue: (v) => z$1.string().parse(v),
-		serialize: (v) => String(v),
-		parseLiteral: (ast) => {
-			if (ast.kind !== Kind.STRING) throw new TypeError("Invalid literal");
-			return ast.value;
-		},
-		jsonSchema: { type: "string" }
-	}),
-	JSON: () => new FieldType({
-		name: "JSON",
-		zod: z$1.any(),
-		parseValue: (v) => v,
-		serialize: (v) => v,
-		jsonSchema: {}
-	}),
-	JSONObject: () => new FieldType({
-		name: "JSONObject",
-		zod: z$1.record(z$1.string(), z$1.any()),
-		parseValue: (v) => z$1.record(z$1.string(), z$1.any()).parse(v),
-		serialize: (v) => v ?? {},
-		jsonSchema: { type: "object" }
-	}),
-	Date: () => new FieldType({
-		name: "Date",
-		zod: z$1.date(),
-		parseValue: (v) => v instanceof Date ? v : new Date(String(v)),
-		serialize: (v) => v instanceof Date ? v.toISOString().split("T")[0] : String(v),
-		jsonSchema: {
-			type: "string",
-			format: "date"
-		}
-	}),
-	DateTime: () => new FieldType({
-		name: "DateTime",
-		zod: z$1.date(),
-		parseValue: (v) => v instanceof Date ? v : new Date(String(v)),
-		serialize: (v) => {
-			return v instanceof Date ? v.toISOString() : String(v);
-		},
-		jsonSchema: {
-			type: "string",
-			format: "date-time"
-		}
-	}),
-	Time: () => new FieldType({
-		name: "Time",
-		zod: z$1.string().regex(/^\d{2}:\d{2}(:\d{2})?$/),
-		parseValue: (v) => z$1.string().regex(/^\d{2}:\d{2}(:\d{2})?$/).parse(v),
-		serialize: (v) => String(v),
-		jsonSchema: {
-			type: "string",
-			pattern: "^\\d{2}:\\d{2}(:\\d{2})?$"
-		}
-	}),
-	EmailAddress: () => new FieldType({
-		name: "EmailAddress",
-		zod: z$1.string().email(),
-		parseValue: (v) => z$1.string().email().parse(v),
-		serialize: (v) => String(v),
-		jsonSchema: {
-			type: "string",
-			format: "email"
-		}
-	}),
-	URL: () => new FieldType({
-		name: "URL",
-		zod: z$1.string().url(),
-		parseValue: (v) => z$1.string().url().parse(v),
-		serialize: (v) => String(v),
-		jsonSchema: {
-			type: "string",
-			format: "uri"
-		}
-	}),
-	PhoneNumber: () => new FieldType({
-		name: "PhoneNumber",
-		zod: z$1.string().regex(phoneRegex),
-		parseValue: (v) => z$1.string().regex(phoneRegex).parse(v),
-		serialize: (v) => String(v),
-		jsonSchema: {
-			type: "string",
-			pattern: phoneRegex.source
-		}
-	}),
-	NonEmptyString: () => new FieldType({
-		name: "NonEmptyString",
-		zod: z$1.string().min(1),
-		parseValue: (v) => z$1.string().min(1).parse(v),
-		serialize: (v) => String(v),
-		jsonSchema: {
-			type: "string",
-			minLength: 1
-		}
-	}),
-	Locale: () => new FieldType({
-		name: "Locale",
-		zod: z$1.string().regex(localeRegex),
-		parseValue: (v) => z$1.string().regex(localeRegex).parse(v),
-		serialize: (v) => String(v),
-		jsonSchema: {
-			type: "string",
-			pattern: localeRegex.source
-		}
-	}),
-	TimeZone: () => new FieldType({
-		name: "TimeZone",
-		zod: z$1.string().regex(timezoneRegex),
-		parseValue: (v) => z$1.string().regex(timezoneRegex).parse(v),
-		serialize: (v) => String(v),
-		jsonSchema: {
-			type: "string",
-			pattern: timezoneRegex.source
-		}
-	}),
-	Latitude: () => new FieldType({
-		name: "Latitude",
-		zod: z$1.number().min(latMin).max(latMax),
-		parseValue: (v) => z$1.coerce.number().min(latMin).max(latMax).parse(v),
-		serialize: (v) => Number(v),
-		jsonSchema: {
-			type: "number",
-			minimum: latMin,
-			maximum: latMax
-		}
-	}),
-	Longitude: () => new FieldType({
-		name: "Longitude",
-		zod: z$1.number().min(lonMin).max(lonMax),
-		parseValue: (v) => z$1.coerce.number().min(lonMin).max(lonMax).parse(v),
-		serialize: (v) => Number(v),
-		jsonSchema: {
-			type: "number",
-			minimum: lonMin,
-			maximum: lonMax
-		}
-	}),
-	Currency: () => new FieldType({
-		name: "Currency",
-		zod: z$1.string().regex(currencyRegex),
-		parseValue: (v) => z$1.string().regex(currencyRegex).parse(v),
-		serialize: (v) => String(v),
-		jsonSchema: {
-			type: "string",
-			pattern: currencyRegex.source
-		}
-	}),
-	CountryCode: () => new FieldType({
-		name: "CountryCode",
-		zod: z$1.string().regex(countryRegex),
-		parseValue: (v) => z$1.string().regex(countryRegex).parse(v),
-		serialize: (v) => String(v),
-		jsonSchema: {
-			type: "string",
-			pattern: countryRegex.source
-		}
-	})
-};
-
-//#endregion
-export { ScalarTypeEnum };

package/dist/modules/audit-trail/dist/libs/schema/dist/SchemaModel.js

@@ -1,3 +0,0 @@
-import "./EnumType.js";
-import "./FieldType.js";
-import "zod";

package/dist/modules/audit-trail/dist/libs/schema/dist/entity/defineEntity.js

@@ -1,230 +0,0 @@
-import * as z$1 from "zod";
-
-//#region ../../modules/audit-trail/dist/libs/schema/dist/entity/defineEntity.js
-/**
-* Helper to define a database entity with full type safety.
-*
-* @example
-* ```typescript
-* const UserEntity = defineEntity({
-*   name: 'User',
-*   schema: 'lssm_sigil',
-*   description: 'A user of the platform.',
-*   fields: {
-*     id: field.id(),
-*     email: field.string({ isUnique: true, zod: z.string().email() }),
-*     name: field.string({ isOptional: true }),
-*     createdAt: field.createdAt(),
-*     updatedAt: field.updatedAt(),
-*     memberships: field.hasMany('Member'),
-*   },
-*   indexes: [{ fields: ['email'], unique: true }],
-* });
-* ```
-*/
-function defineEntity(spec) {
-	return spec;
-}
-/**
-* Field builder helpers for common field patterns.
-*/
-const field = {
-	string(opts) {
-		return {
-			kind: "scalar",
-			type: "String",
-			...opts
-		};
-	},
-	int(opts) {
-		return {
-			kind: "scalar",
-			type: "Int",
-			...opts
-		};
-	},
-	float(opts) {
-		return {
-			kind: "scalar",
-			type: "Float",
-			...opts
-		};
-	},
-	boolean(opts) {
-		return {
-			kind: "scalar",
-			type: "Boolean",
-			...opts
-		};
-	},
-	dateTime(opts) {
-		return {
-			kind: "scalar",
-			type: "DateTime",
-			...opts
-		};
-	},
-	json(opts) {
-		return {
-			kind: "scalar",
-			type: "Json",
-			...opts
-		};
-	},
-	bigInt(opts) {
-		return {
-			kind: "scalar",
-			type: "BigInt",
-			...opts
-		};
-	},
-	decimal(opts) {
-		return {
-			kind: "scalar",
-			type: "Decimal",
-			...opts
-		};
-	},
-	bytes(opts) {
-		return {
-			kind: "scalar",
-			type: "Bytes",
-			...opts
-		};
-	},
-	id(opts) {
-		return {
-			kind: "scalar",
-			type: "String",
-			isId: true,
-			default: "cuid()",
-			...opts
-		};
-	},
-	uuid(opts) {
-		return {
-			kind: "scalar",
-			type: "String",
-			isId: true,
-			default: "uuid()",
-			...opts
-		};
-	},
-	autoIncrement(opts) {
-		return {
-			kind: "scalar",
-			type: "Int",
-			isId: true,
-			default: "autoincrement()",
-			...opts
-		};
-	},
-	createdAt(opts) {
-		return {
-			kind: "scalar",
-			type: "DateTime",
-			default: "now()",
-			...opts
-		};
-	},
-	updatedAt(opts) {
-		return {
-			kind: "scalar",
-			type: "DateTime",
-			updatedAt: true,
-			...opts
-		};
-	},
-	email(opts) {
-		return {
-			kind: "scalar",
-			type: "String",
-			zod: z$1.email(),
-			...opts
-		};
-	},
-	url(opts) {
-		return {
-			kind: "scalar",
-			type: "String",
-			zod: z$1.url(),
-			...opts
-		};
-	},
-	enum(enumName, opts) {
-		return {
-			kind: "enum",
-			enumName,
-			...opts
-		};
-	},
-	inlineEnum(enumName, values, opts) {
-		return {
-			kind: "enum",
-			enumName,
-			values,
-			...opts
-		};
-	},
-	hasOne(target, opts) {
-		return {
-			kind: "relation",
-			type: "hasOne",
-			target,
-			...opts
-		};
-	},
-	hasMany(target, opts) {
-		return {
-			kind: "relation",
-			type: "hasMany",
-			target,
-			...opts
-		};
-	},
-	belongsTo(target, fields, references, opts) {
-		return {
-			kind: "relation",
-			type: "belongsTo",
-			target,
-			fields,
-			references,
-			...opts
-		};
-	},
-	foreignKey(opts) {
-		return {
-			kind: "scalar",
-			type: "String",
-			...opts
-		};
-	}
-};
-/**
-* Index builder helpers.
-*/
-const index = {
-	on(fields, opts) {
-		return {
-			fields,
-			...opts
-		};
-	},
-	unique(fields, opts) {
-		return {
-			fields,
-			unique: true,
-			...opts
-		};
-	},
-	compound(fields, sort, opts) {
-		return {
-			fields,
-			sort,
-			...opts
-		};
-	}
-};
-
-//#endregion
-export { defineEntity, field, index };

package/dist/modules/audit-trail/dist/libs/schema/dist/entity/index.js

@@ -1,2 +0,0 @@
-import "./defineEntity.js";
-import "./types.js";

package/dist/modules/audit-trail/dist/libs/schema/dist/entity/types.js

@@ -1 +0,0 @@
-import "zod";

package/dist/modules/notifications/dist/libs/contracts/dist/docs/PUBLISHING.docblock.js

@@ -1,15 +0,0 @@
-import { registerDocBlocks } from "./registry.js";
-
-//#region ../../modules/notifications/dist/libs/contracts/dist/docs/PUBLISHING.docblock.js
-registerDocBlocks([{
-	id: "docs.PUBLISHING",
-	title: "Publishing ContractSpec Libraries",
-	summary: "This guide describes how we release the ContractSpec libraries to npm. We use a dual-track release system: **Stable** (manual) and **Canary** (automatic).",
-	kind: "reference",
-	visibility: "public",
-	route: "/docs/PUBLISHING",
-	tags: ["PUBLISHING"],
-	body: "# Publishing ContractSpec Libraries\n\nThis guide describes how we release the ContractSpec libraries to npm. We use a dual-track release system: **Stable** (manual) and **Canary** (automatic).\n\n## Release Tracks\n\n| Track | Branch | npm Tag | Frequency | Versioning | Use Case |\n|-------|--------|---------|-----------|------------|----------|\n| **Stable** | `release` | `latest` | Manual | SemVer (e.g., `1.7.4`) | Production, external users |\n| **Canary** | `main` | `canary` | Every Push | Snapshot (e.g., `1.7.4-canary...`) | Dev, internal testing |\n\n## Prerequisites\n\n- ✅ `NPM_TOKEN` secret is configured in GitHub (owner or automation token with _publish_ scope).\n- ✅ `GITHUB_TOKEN` (built-in) has permissions to create PRs (enabled by default in new repos).\n- ✅ For stable releases: `release` branch exists and is protected.\n\n## Canary Workflow (Automatic)\n\nEvery commit pushed to `main` triggers the `.github/workflows/publish-canary.yml` workflow.\n\n1. **Trigger**: Push to `main`.\n2. **Versioning**: Runs `changeset version --snapshot canary` to generate a temporary snapshot version.\n3. **Publish**: Packages are published to npm with the `canary` tag using `changeset publish --tag canary`.\n\n### Consuming Canary Builds\n\nTo install the latest bleeding-edge version:\n\n```bash\nnpm install @lssm/lib.contracts@canary\n# or\nbun add @lssm/lib.contracts@canary\n```\n\n## Stable Release Workflow (Manual)\n\nStable releases are managed via the `release` branch using the standard [Changesets Action](https://github.com/changesets/action).\n\n1. **Develop on `main`**: Create features and fixes.\n2. **Add Changesets**: Run `bun changeset` to document changes and impact (major/minor/patch).\n3. **Merge to `release`**: When ready to ship, open a PR from `main` to `release` or merge manually.\n4. **\"Version Packages\" PR**:\n   - The GitHub Action detects new changesets and automatically creates a Pull Request titled **\"Version Packages\"**.\n   - This PR contains the version bumps and updated `CHANGELOG.md` files.\n5. **Merge & Publish**:\n   - Review and merge the \"Version Packages\" PR.\n   - The Action runs again, detects the versions have been bumped, builds the libraries, and publishes them to npm with the `latest` tag.\n\n### Publishing Steps\n\n1. Ensure all changesets are present on `main`.\n2. Merge `main` into `release`:\n   ```bash\n   git checkout release\n   git pull origin release\n   git merge main\n   git push origin release\n   ```\n3. Go to GitHub Pull Requests. You will see a **\"Version Packages\"** PR created by the bot.\n4. Merge that PR.\n5. The release is now live on npm!\n\n## Manual Verification (Optional)\n\nBefore publishing a new version you can run:\n\n```bash\nbun run build:not-apps\nnpx npm-packlist --json packages/libs/contracts\n```\n\n## Rollback\n\nIf a publish fails mid-way, re-run the workflow once the issue is fixed. Already published packages are skipped automatically. Use `npm deprecate <package>@<version>` if we need to warn consumers about a broken release.\n"
-}]);
-
-//#endregion

package/dist/modules/notifications/dist/libs/contracts/dist/docs/tech/PHASE_1_QUICKSTART.docblock.js

@@ -1,15 +0,0 @@
-import { registerDocBlocks } from "../registry.js";
-
-//#region ../../modules/notifications/dist/libs/contracts/dist/docs/tech/PHASE_1_QUICKSTART.docblock.js
-registerDocBlocks([{
-	id: "docs.tech.PHASE_1_QUICKSTART",
-	title: "Phase 1: API Reference Index",
-	summary: "Quick reference for all new Phase 1 APIs.",
-	kind: "reference",
-	visibility: "public",
-	route: "/docs/tech/PHASE_1_QUICKSTART",
-	tags: ["tech", "PHASE_1_QUICKSTART"],
-	body: "# Phase 1: API Reference Index\n\nQuick reference for all new Phase 1 APIs.\n\n---\n\n## @lssm/lib.multi-tenancy\n\n### RLS\n```typescript\nimport { createRlsMiddleware, type TenantIdProvider } from '@lssm/lib.multi-tenancy/rls';\n```\n\n### Provisioning\n```typescript\nimport { \n  TenantProvisioningService,\n  type CreateTenantInput,\n  type TenantProvisioningConfig \n} from '@lssm/lib.multi-tenancy/provisioning';\n```\n\n### Isolation\n```typescript\nimport { IsolationValidator } from '@lssm/lib.multi-tenancy/isolation';\n```\n\n---\n\n## @lssm/lib.observability\n\n### Tracing\n```typescript\nimport { \n  getTracer,\n  traceAsync,\n  traceSync,\n  createTracingMiddleware \n} from '@lssm/lib.observability/tracing';\n```\n\n### Metrics\n```typescript\nimport {\n  getMeter,\n  createCounter,\n  createUpDownCounter,\n  createHistogram,\n  standardMetrics\n} from '@lssm/lib.observability/metrics';\n```\n\n### Logging\n```typescript\nimport {\n  Logger,\n  logger,\n  type LogLevel,\n  type LogEntry\n} from '@lssm/lib.observability/logging';\n```\n\n---\n\n## @lssm/lib.resilience\n\n### Circuit Breaker\n```typescript\nimport {\n  CircuitBreaker,\n  type CircuitState,\n  type CircuitBreakerConfig\n} from '@lssm/lib.resilience/circuit-breaker';\n```\n\n### Retry\n```typescript\nimport { retry } from '@lssm/lib.resilience/retry';\n```\n\n### Timeout\n```typescript\nimport { timeout } from '@lssm/lib.resilience/timeout';\n```\n\n### Fallback\n```typescript\nimport { fallback } from '@lssm/lib.resilience/fallback';\n```\n\n---\n\n## Enhanced: @lssm/lib.contracts\n\n### DataViews\n```typescript\nimport { DataViewQueryGenerator } from '@lssm/lib.contracts/data-views/query-generator';\nimport { DataViewRuntime } from '@lssm/lib.contracts/data-views/runtime';\n```\n\n### Workflows\n```typescript\nimport { SLAMonitor, type SLABreachEvent } from '@lssm/lib.contracts/workflow/sla-monitor';\nimport { PrismaStateStore } from '@lssm/lib.contracts/workflow/adapters/db-adapter';\n```\n\n---\n\n## Enhanced: @lssm/lib.design-system\n\n### DataView Components\n```typescript\nimport { DataViewRenderer } from '@lssm/lib.design-system/components/data-view/DataViewRenderer';\n// Also available: DataViewList, DataViewTable, DataViewDetail\n```\n\n---\n\n## Usage Examples\n\n### Complete Workflow with All Features\n\n```typescript\nimport { WorkflowRunner } from '@lssm/lib.contracts/workflow/runner';\nimport { PrismaStateStore } from '@lssm/lib.contracts/workflow/adapters/db-adapter';\nimport { SLAMonitor } from '@lssm/lib.contracts/workflow/sla-monitor';\nimport { CircuitBreaker } from '@lssm/lib.resilience/circuit-breaker';\nimport { traceAsync } from '@lssm/lib.observability/tracing';\n\nconst runner = new WorkflowRunner({\n  registry,\n  stateStore: new PrismaStateStore(db),\n  opExecutor: async (op, input, ctx) => {\n    return traceAsync(`op.${op.name}`, async (span) => {\n      span.setAttribute('operation', op.name);\n      const breaker = getCircuitBreaker(op.name);\n      return breaker.execute(() => executeOperation(op, input, ctx));\n    });\n  },\n  eventEmitter: (event, payload) => {\n    if (event.startsWith('workflow.')) {\n      logger.info(event, payload);\n    }\n  },\n});\n\nconst monitor = new SLAMonitor((event, payload) => {\n  logger.warn('SLA_BREACH', payload);\n  alertOps(payload);\n});\n\n// Start workflow\nconst workflowId = await runner.start('payment.flow', 1);\n\n// Monitor SLA\nconst state = await runner.getState(workflowId);\nconst spec = registry.get('payment.flow', 1);\nmonitor.check(state, spec!);\n```\n\n### Complete DataView with Observability\n\n```typescript\nimport { DataViewRenderer } from '@lssm/lib.design-system';\nimport { DataViewQueryGenerator } from '@lssm/lib.contracts/data-views/query-generator';\nimport { traceAsync } from '@lssm/lib.observability/tracing';\nimport { MyDataView } from './specs/users.data-view';\n\nexport function UserListPage() {\n  const [page, setPage] = useState(1);\n  const [users, setUsers] = useState([]);\n\n  const loadUsers = async () => {\n    return traceAsync('load_users', async (span) => {\n      const generator = new DataViewQueryGenerator(MyDataView);\n      const query = generator.generate({ pagination: { page, pageSize: 20 } });\n      \n      span.setAttribute('page', page);\n      const result = await api.execute(query);\n      setUsers(result.data);\n    });\n  };\n\n  return (\n    <DataViewRenderer\n      spec={MyDataView}\n      items={users}\n      pagination={{ page, pageSize: 20, total: users.length }}\n      onPageChange={setPage}\n    />\n  );\n}\n```\n\n### Complete Multi-Tenant Setup\n\n```typescript\n// 1. RLS Middleware\nimport { createRlsMiddleware } from '@lssm/lib.multi-tenancy/rls';\ndb.$use(createRlsMiddleware(() => req.tenantId));\n\n// 2. Tenant Provisioning\nimport { TenantProvisioningService } from '@lssm/lib.multi-tenancy/provisioning';\nconst service = new TenantProvisioningService({ db });\n\n// 3. Create new tenant\nawait service.provision({\n  id: 'acme',\n  name: 'Acme Corp',\n  slug: 'acme',\n  ownerEmail: 'admin@acme.com',\n});\n\n// 4. Validate isolation in tests\nimport { IsolationValidator } from '@lssm/lib.multi-tenancy/isolation';\n\ntest('queries are isolated', () => {\n  const isValid = IsolationValidator.validateQuery(\n    'User',\n    'findMany',\n    { where: { tenantId: 'acme' } },\n    'acme'\n  );\n  expect(isValid).toBe(true);\n});\n```\n\n---\n\n## Testing\n\n### Test Circuit Breakers\n\n```typescript\nimport { CircuitBreaker } from '@lssm/lib.resilience/circuit-breaker';\n\ntest('circuit opens after threshold', async () => {\n  const breaker = new CircuitBreaker({\n    failureThreshold: 3,\n    resetTimeoutMs: 5000,\n  });\n\n  // Trigger failures\n  for (let i = 0; i < 3; i++) {\n    await expect(\n      breaker.execute(() => Promise.reject('error'))\n    ).rejects.toThrow();\n  }\n\n  // Circuit should be open\n  await expect(\n    breaker.execute(() => Promise.resolve('ok'))\n  ).rejects.toThrow('CircuitBreaker is OPEN');\n});\n```\n\n### Test Workflow Retry\n\n```typescript\ntest('workflow retries on failure', async () => {\n  let attempts = 0;\n  const opExecutor = async () => {\n    attempts++;\n    if (attempts < 3) throw new Error('fail');\n    return 'success';\n  };\n\n  const runner = new WorkflowRunner({ /* ... */ opExecutor });\n  await runner.executeStep(workflowId);\n  \n  expect(attempts).toBe(3);\n});\n```\n\n---\n\n## Common Patterns\n\n### Pattern: Resilient External Call\n\n```typescript\nimport { CircuitBreaker } from '@lssm/lib.resilience/circuit-breaker';\nimport { retry } from '@lssm/lib.resilience/retry';\nimport { timeout } from '@lssm/lib.resilience/timeout';\nimport { traceAsync } from '@lssm/lib.observability/tracing';\n\nconst breaker = new CircuitBreaker({ failureThreshold: 5, resetTimeoutMs: 30000 });\n\nexport async function callExternalAPI(input: any) {\n  return traceAsync('external_api_call', async (span) => {\n    span.setAttribute('service', 'stripe');\n    \n    return breaker.execute(() =>\n      retry(\n        () => timeout(() => stripe.api.call(input), 5000),\n        3,\n        1000,\n        true\n      )\n    );\n  });\n}\n```\n\n**Benefits**: Circuit breaker + retry + timeout + tracing in one place.\n\n---\n\n### Pattern: Tenant-Aware Operation\n\n```typescript\nimport { traceAsync } from '@lssm/lib.observability/tracing';\n\nexport async function listUsers(tenantId: string) {\n  return traceAsync('list_users', async (span) => {\n    span.setAttribute('tenant_id', tenantId);\n    \n    // RLS middleware will inject WHERE tenantId = ?\n    return db.user.findMany();\n  });\n}\n```\n\n---\n\n### Pattern: Monitored Workflow\n\n```typescript\nimport { WorkflowRunner } from '@lssm/lib.contracts/workflow/runner';\nimport { SLAMonitor } from '@lssm/lib.contracts/workflow/sla-monitor';\nimport { logger } from '@lssm/lib.observability/logging';\n\nconst monitor = new SLAMonitor((event, payload) => {\n  logger.warn('workflow.sla_breach', payload);\n});\n\n// In workflow poller\nconst state = await runner.getState(workflowId);\nconst spec = registry.get(state.workflowName, state.workflowVersion);\nif (spec) {\n  monitor.check(state, spec);\n}\n```\n\n---\n\n## Next Steps\n\n1. **Implement one quick win** (30 minutes)\n2. **Add tests for new functionality** (1 hour)\n3. **Deploy to staging and verify observability** (1 hour)\n4. **Roll out to production** (monitor closely)\n5. **Read full documentation** at https://contractspec.lssm.tech/docs\n\n---\n\n**Questions?** See `/docs/guides/phase-1-migration` or reach out via https://contractspec.lssm.tech/contact\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n"
-}]);
-
-//#endregion