@lssm/example.saas-boilerplate 0.0.0-canary-20251217062139 → 0.0.0-canary-20251217072406

package/dist/modules/notifications/dist/entities/index.js

@@ -1 +1,254 @@
-import{i as e,n as t,r as n,t as r}from"../libs/schema/dist/entity/defineEntity.js";import"../libs/schema/dist/index.js";const i=t({name:`NotificationStatus`,values:[`PENDING`,`SENT`,`DELIVERED`,`READ`,`FAILED`,`CANCELLED`],schema:`lssm_notifications`,description:`Status of a notification.`}),a=t({name:`NotificationChannel`,values:[`EMAIL`,`IN_APP`,`PUSH`,`WEBHOOK`,`SMS`],schema:`lssm_notifications`,description:`Delivery channel for notifications.`}),o=r({name:`Notification`,description:`An individual notification to be delivered to a user.`,schema:`lssm_notifications`,map:`notification`,fields:{id:n.id({description:`Unique notification ID`}),userId:n.foreignKey({description:`Target user ID`}),orgId:n.string({isOptional:!0,description:`Organization context`}),templateId:n.string({isOptional:!0,description:`Template used`}),title:n.string({description:`Notification title`}),body:n.string({description:`Notification body`}),actionUrl:n.string({isOptional:!0,description:`Action URL`}),imageUrl:n.string({isOptional:!0,description:`Image URL`}),type:n.string({description:`Notification type (e.g., mention, update)`}),category:n.string({isOptional:!0,description:`Notification category`}),priority:n.enum(`NotificationPriority`,{default:`NORMAL`}),channels:n.string({isArray:!0,description:`Target delivery channels`}),status:n.enum(`NotificationStatus`,{default:`PENDING`}),sentAt:n.dateTime({isOptional:!0}),deliveredAt:n.dateTime({isOptional:!0}),readAt:n.dateTime({isOptional:!0}),metadata:n.json({isOptional:!0,description:`Additional metadata`}),variables:n.json({isOptional:!0,description:`Template variables used`}),triggeredBy:n.string({isOptional:!0,description:`Event/action that triggered`}),sourceId:n.string({isOptional:!0,description:`Source entity ID`}),sourceType:n.string({isOptional:!0,description:`Source entity type`}),createdAt:n.createdAt(),updatedAt:n.updatedAt(),expiresAt:n.dateTime({isOptional:!0,description:`Notification expiry`}),deliveryLogs:n.hasMany(`DeliveryLog`)},indexes:[e.on([`userId`,`status`,`createdAt`]),e.on([`userId`,`readAt`]),e.on([`orgId`,`createdAt`]),e.on([`type`,`createdAt`])],enums:[i,a]}),s=t({name:`NotificationPriority`,values:[`LOW`,`NORMAL`,`HIGH`,`URGENT`],schema:`lssm_notifications`,description:`Priority level of a notification.`}),c=r({name:`NotificationTemplate`,description:`Reusable notification template.`,schema:`lssm_notifications`,map:`notification_template`,fields:{id:n.id(),templateId:n.string({isUnique:!0,description:`Template identifier`}),name:n.string({description:`Template display name`}),description:n.string({isOptional:!0}),emailSubject:n.string({isOptional:!0}),emailBody:n.string({isOptional:!0}),inAppTitle:n.string({isOptional:!0}),inAppBody:n.string({isOptional:!0}),pushTitle:n.string({isOptional:!0}),pushBody:n.string({isOptional:!0}),defaultChannels:n.string({isArray:!0}),category:n.string({isOptional:!0}),priority:n.enum(`NotificationPriority`,{default:`NORMAL`}),variablesSchema:n.json({isOptional:!0,description:`JSON schema for variables`}),enabled:n.boolean({default:!0}),createdAt:n.createdAt(),updatedAt:n.updatedAt()},enums:[s]}),l=r({name:`NotificationPreference`,description:`User notification preferences by type and channel.`,schema:`lssm_notifications`,map:`notification_preference`,fields:{id:n.id(),userId:n.foreignKey(),globalEnabled:n.boolean({default:!0}),quietHoursStart:n.string({isOptional:!0,description:`Quiet hours start (HH:MM)`}),quietHoursEnd:n.string({isOptional:!0,description:`Quiet hours end (HH:MM)`}),timezone:n.string({default:`"UTC"`}),channelPreferences:n.json({description:`Channel-level preferences`}),typePreferences:n.json({description:`Type-level preferences`}),digestEnabled:n.boolean({default:!1}),digestFrequency:n.string({isOptional:!0,description:`daily, weekly, etc.`}),digestTime:n.string({isOptional:!0,description:`Digest send time (HH:MM)`}),createdAt:n.createdAt(),updatedAt:n.updatedAt()},indexes:[e.unique([`userId`])]}),u=r({name:`DeliveryLog`,description:`Log of notification delivery attempts.`,schema:`lssm_notifications`,map:`delivery_log`,fields:{id:n.id(),notificationId:n.foreignKey(),channel:n.enum(`NotificationChannel`),status:n.enum(`NotificationStatus`),attemptedAt:n.dateTime(),deliveredAt:n.dateTime({isOptional:!0}),responseCode:n.string({isOptional:!0}),responseMessage:n.string({isOptional:!0}),externalId:n.string({isOptional:!0,description:`Provider message ID`}),metadata:n.json({isOptional:!0}),notification:n.belongsTo(`Notification`,[`notificationId`],[`id`],{onDelete:`Cascade`})},indexes:[e.on([`notificationId`,`channel`])]}),d=[o,c,l,u],f={moduleId:`@lssm/module.notifications`,entities:d,enums:[i,a,s]};export{a,c,d,f,i,l,o,s,u};
+import { defineEntity, defineEntityEnum, field, index } from "../libs/schema/dist/entity/defineEntity.js";
+import "../libs/schema/dist/index.js";
+
+//#region ../../modules/notifications/dist/entities/index.js
+/**
+* Notification status enum.
+*/
+const NotificationStatusEnum = defineEntityEnum({
+	name: "NotificationStatus",
+	values: [
+		"PENDING",
+		"SENT",
+		"DELIVERED",
+		"READ",
+		"FAILED",
+		"CANCELLED"
+	],
+	schema: "lssm_notifications",
+	description: "Status of a notification."
+});
+/**
+* Notification channel enum.
+*/
+const NotificationChannelEnum = defineEntityEnum({
+	name: "NotificationChannel",
+	values: [
+		"EMAIL",
+		"IN_APP",
+		"PUSH",
+		"WEBHOOK",
+		"SMS"
+	],
+	schema: "lssm_notifications",
+	description: "Delivery channel for notifications."
+});
+/**
+* Notification entity - individual notification instance.
+*/
+const NotificationEntity = defineEntity({
+	name: "Notification",
+	description: "An individual notification to be delivered to a user.",
+	schema: "lssm_notifications",
+	map: "notification",
+	fields: {
+		id: field.id({ description: "Unique notification ID" }),
+		userId: field.foreignKey({ description: "Target user ID" }),
+		orgId: field.string({
+			isOptional: true,
+			description: "Organization context"
+		}),
+		templateId: field.string({
+			isOptional: true,
+			description: "Template used"
+		}),
+		title: field.string({ description: "Notification title" }),
+		body: field.string({ description: "Notification body" }),
+		actionUrl: field.string({
+			isOptional: true,
+			description: "Action URL"
+		}),
+		imageUrl: field.string({
+			isOptional: true,
+			description: "Image URL"
+		}),
+		type: field.string({ description: "Notification type (e.g., mention, update)" }),
+		category: field.string({
+			isOptional: true,
+			description: "Notification category"
+		}),
+		priority: field.enum("NotificationPriority", { default: "NORMAL" }),
+		channels: field.string({
+			isArray: true,
+			description: "Target delivery channels"
+		}),
+		status: field.enum("NotificationStatus", { default: "PENDING" }),
+		sentAt: field.dateTime({ isOptional: true }),
+		deliveredAt: field.dateTime({ isOptional: true }),
+		readAt: field.dateTime({ isOptional: true }),
+		metadata: field.json({
+			isOptional: true,
+			description: "Additional metadata"
+		}),
+		variables: field.json({
+			isOptional: true,
+			description: "Template variables used"
+		}),
+		triggeredBy: field.string({
+			isOptional: true,
+			description: "Event/action that triggered"
+		}),
+		sourceId: field.string({
+			isOptional: true,
+			description: "Source entity ID"
+		}),
+		sourceType: field.string({
+			isOptional: true,
+			description: "Source entity type"
+		}),
+		createdAt: field.createdAt(),
+		updatedAt: field.updatedAt(),
+		expiresAt: field.dateTime({
+			isOptional: true,
+			description: "Notification expiry"
+		}),
+		deliveryLogs: field.hasMany("DeliveryLog")
+	},
+	indexes: [
+		index.on([
+			"userId",
+			"status",
+			"createdAt"
+		]),
+		index.on(["userId", "readAt"]),
+		index.on(["orgId", "createdAt"]),
+		index.on(["type", "createdAt"])
+	],
+	enums: [NotificationStatusEnum, NotificationChannelEnum]
+});
+/**
+* Notification priority enum.
+*/
+const NotificationPriorityEnum = defineEntityEnum({
+	name: "NotificationPriority",
+	values: [
+		"LOW",
+		"NORMAL",
+		"HIGH",
+		"URGENT"
+	],
+	schema: "lssm_notifications",
+	description: "Priority level of a notification."
+});
+/**
+* NotificationTemplate entity - reusable notification templates.
+*/
+const NotificationTemplateEntity = defineEntity({
+	name: "NotificationTemplate",
+	description: "Reusable notification template.",
+	schema: "lssm_notifications",
+	map: "notification_template",
+	fields: {
+		id: field.id(),
+		templateId: field.string({
+			isUnique: true,
+			description: "Template identifier"
+		}),
+		name: field.string({ description: "Template display name" }),
+		description: field.string({ isOptional: true }),
+		emailSubject: field.string({ isOptional: true }),
+		emailBody: field.string({ isOptional: true }),
+		inAppTitle: field.string({ isOptional: true }),
+		inAppBody: field.string({ isOptional: true }),
+		pushTitle: field.string({ isOptional: true }),
+		pushBody: field.string({ isOptional: true }),
+		defaultChannels: field.string({ isArray: true }),
+		category: field.string({ isOptional: true }),
+		priority: field.enum("NotificationPriority", { default: "NORMAL" }),
+		variablesSchema: field.json({
+			isOptional: true,
+			description: "JSON schema for variables"
+		}),
+		enabled: field.boolean({ default: true }),
+		createdAt: field.createdAt(),
+		updatedAt: field.updatedAt()
+	},
+	enums: [NotificationPriorityEnum]
+});
+/**
+* NotificationPreference entity - user notification preferences.
+*/
+const NotificationPreferenceEntity = defineEntity({
+	name: "NotificationPreference",
+	description: "User notification preferences by type and channel.",
+	schema: "lssm_notifications",
+	map: "notification_preference",
+	fields: {
+		id: field.id(),
+		userId: field.foreignKey(),
+		globalEnabled: field.boolean({ default: true }),
+		quietHoursStart: field.string({
+			isOptional: true,
+			description: "Quiet hours start (HH:MM)"
+		}),
+		quietHoursEnd: field.string({
+			isOptional: true,
+			description: "Quiet hours end (HH:MM)"
+		}),
+		timezone: field.string({ default: "\"UTC\"" }),
+		channelPreferences: field.json({ description: "Channel-level preferences" }),
+		typePreferences: field.json({ description: "Type-level preferences" }),
+		digestEnabled: field.boolean({ default: false }),
+		digestFrequency: field.string({
+			isOptional: true,
+			description: "daily, weekly, etc."
+		}),
+		digestTime: field.string({
+			isOptional: true,
+			description: "Digest send time (HH:MM)"
+		}),
+		createdAt: field.createdAt(),
+		updatedAt: field.updatedAt()
+	},
+	indexes: [index.unique(["userId"])]
+});
+/**
+* DeliveryLog entity - track delivery attempts per channel.
+*/
+const DeliveryLogEntity = defineEntity({
+	name: "DeliveryLog",
+	description: "Log of notification delivery attempts.",
+	schema: "lssm_notifications",
+	map: "delivery_log",
+	fields: {
+		id: field.id(),
+		notificationId: field.foreignKey(),
+		channel: field.enum("NotificationChannel"),
+		status: field.enum("NotificationStatus"),
+		attemptedAt: field.dateTime(),
+		deliveredAt: field.dateTime({ isOptional: true }),
+		responseCode: field.string({ isOptional: true }),
+		responseMessage: field.string({ isOptional: true }),
+		externalId: field.string({
+			isOptional: true,
+			description: "Provider message ID"
+		}),
+		metadata: field.json({ isOptional: true }),
+		notification: field.belongsTo("Notification", ["notificationId"], ["id"], { onDelete: "Cascade" })
+	},
+	indexes: [index.on(["notificationId", "channel"])]
+});
+/**
+* All notification entities for schema composition.
+*/
+const notificationEntities = [
+	NotificationEntity,
+	NotificationTemplateEntity,
+	NotificationPreferenceEntity,
+	DeliveryLogEntity
+];
+/**
+* Module schema contribution for notifications.
+*/
+const notificationsSchemaContribution = {
+	moduleId: "@lssm/module.notifications",
+	entities: notificationEntities,
+	enums: [
+		NotificationStatusEnum,
+		NotificationChannelEnum,
+		NotificationPriorityEnum
+	]
+};
+
+//#endregion
+export { DeliveryLogEntity, NotificationChannelEnum, NotificationEntity, NotificationPreferenceEntity, NotificationPriorityEnum, NotificationStatusEnum, NotificationTemplateEntity, notificationEntities, notificationsSchemaContribution };

package/dist/modules/notifications/dist/index.js

@@ -1 +1,3 @@
-import{a as e,c as t,d as n,f as r,i,l as a,o,s,u as c}from"./entities/index.js";import{c as l,d as u,f as d,l as f,m as p,p as m,u as h}from"./contracts/index.js";import{e as g}from"./templates/index.js";
+import { DeliveryLogEntity, NotificationChannelEnum, NotificationEntity, NotificationPreferenceEntity, NotificationPriorityEnum, NotificationStatusEnum, NotificationTemplateEntity, notificationEntities, notificationsSchemaContribution } from "./entities/index.js";
+import { ListNotificationsInputModel, ListNotificationsOutputModel, NotificationFilterEnum, NotificationModel, NotificationPreferenceModel, SendNotificationInputModel, UpdatePreferencesInputModel } from "./contracts/index.js";
+import { defineTemplate } from "./templates/index.js";

package/dist/modules/notifications/dist/libs/contracts/dist/capabilities/openbanking.js

@@ -1 +1,10 @@
-import{e}from"../ownership.js";const t=[`platform.finance`],n=[`open-banking`,`finance`];[...t],[...n],e.Experimental,[...t],[...n],e.Experimental,[...t],[...n],e.Experimental;
+import { StabilityEnum } from "../ownership.js";
+
+//#region ../../modules/notifications/dist/libs/contracts/dist/capabilities/openbanking.js
+const OWNERS = ["platform.finance"];
+const TAGS = ["open-banking", "finance"];
+[...OWNERS], [...TAGS], StabilityEnum.Experimental;
+[...OWNERS], [...TAGS], StabilityEnum.Experimental;
+[...OWNERS], [...TAGS], StabilityEnum.Experimental;
+
+//#endregion

package/dist/modules/notifications/dist/libs/contracts/dist/client/index.js

@@ -1 +1,5 @@
-"use client";import"./react/feature-render.js";import"./react/form-render.js";import"./react/index.js";
+'use client';
+
+import "./react/feature-render.js";
+import "./react/form-render.js";
+import "./react/index.js";

package/dist/modules/notifications/dist/libs/contracts/dist/client/react/feature-render.js

@@ -1 +1,2 @@
-import"../../presentations.v2.js";import"react";
+import "../../presentations.v2.js";
+import "react";

package/dist/modules/notifications/dist/libs/contracts/dist/client/react/form-render.js

@@ -1 +1,4 @@
-import"react";import"react-hook-form";import"@hookform/resolvers/zod";import"react/jsx-runtime";
+import "react";
+import "react-hook-form";
+import "@hookform/resolvers/zod";
+import "react/jsx-runtime";

package/dist/modules/notifications/dist/libs/contracts/dist/client/react/index.js

@@ -1 +1,4 @@
-"use client";import"./feature-render.js";import"./form-render.js";
+'use client';
+
+import "./feature-render.js";
+import "./form-render.js";

package/dist/modules/notifications/dist/libs/contracts/dist/contract-registry/index.js

@@ -1 +1 @@
-import"./schemas.js";
+import "./schemas.js";

package/dist/modules/notifications/dist/libs/contracts/dist/contract-registry/schemas.js

@@ -1 +1,59 @@
-import{e}from"../ownership.js";import t from"zod";const n=t.enum([`contractspec:operation`,`contractspec:event`,`contractspec:presentation`,`contractspec:form`,`contractspec:feature`,`contractspec:workflow`,`contractspec:template`,`contractspec:integration`,`contractspec:data-view`,`contractspec:migration`,`contractspec:telemetry`,`contractspec:experiment`,`contractspec:app-config`,`contractspec:knowledge`]),r=t.object({path:t.string().min(1),type:t.string().min(1),content:t.string().optional()}),i=t.object({name:t.string().min(1),type:n,version:t.number().int().nonnegative(),title:t.string().min(1),description:t.string().min(1),meta:t.object({stability:t.enum([e.Idea,e.InCreation,e.Experimental,e.Beta,e.Stable,e.Deprecated]),owners:t.array(t.string().min(1)).default([]),tags:t.array(t.string().min(1)).default([])}),dependencies:t.array(t.string().min(1)).optional(),registryDependencies:t.array(t.string().min(1)).optional(),files:t.array(r).min(1),schema:t.object({input:t.unknown().optional(),output:t.unknown().optional()}).optional()});t.object({$schema:t.string().min(1).optional(),name:t.string().min(1),homepage:t.string().min(1).optional(),items:t.array(i)});
+import { StabilityEnum } from "../ownership.js";
+import z from "zod";
+
+//#region ../../modules/notifications/dist/libs/contracts/dist/contract-registry/schemas.js
+const ContractRegistryItemTypeSchema = z.enum([
+	"contractspec:operation",
+	"contractspec:event",
+	"contractspec:presentation",
+	"contractspec:form",
+	"contractspec:feature",
+	"contractspec:workflow",
+	"contractspec:template",
+	"contractspec:integration",
+	"contractspec:data-view",
+	"contractspec:migration",
+	"contractspec:telemetry",
+	"contractspec:experiment",
+	"contractspec:app-config",
+	"contractspec:knowledge"
+]);
+const ContractRegistryFileSchema = z.object({
+	path: z.string().min(1),
+	type: z.string().min(1),
+	content: z.string().optional()
+});
+const ContractRegistryItemSchema = z.object({
+	name: z.string().min(1),
+	type: ContractRegistryItemTypeSchema,
+	version: z.number().int().nonnegative(),
+	title: z.string().min(1),
+	description: z.string().min(1),
+	meta: z.object({
+		stability: z.enum([
+			StabilityEnum.Idea,
+			StabilityEnum.InCreation,
+			StabilityEnum.Experimental,
+			StabilityEnum.Beta,
+			StabilityEnum.Stable,
+			StabilityEnum.Deprecated
+		]),
+		owners: z.array(z.string().min(1)).default([]),
+		tags: z.array(z.string().min(1)).default([])
+	}),
+	dependencies: z.array(z.string().min(1)).optional(),
+	registryDependencies: z.array(z.string().min(1)).optional(),
+	files: z.array(ContractRegistryFileSchema).min(1),
+	schema: z.object({
+		input: z.unknown().optional(),
+		output: z.unknown().optional()
+	}).optional()
+});
+z.object({
+	$schema: z.string().min(1).optional(),
+	name: z.string().min(1),
+	homepage: z.string().min(1).optional(),
+	items: z.array(ContractRegistryItemSchema)
+});
+
+//#endregion

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

@@ -1,76 +1,15 @@
-import{a as e}from"./registry.js";e([{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
-
-This guide describes how we release the ContractSpec libraries to npm. We use a dual-track release system: **Stable** (manual) and **Canary** (automatic).
-
-## Release Tracks
-
-| Track | Branch | npm Tag | Frequency | Versioning | Use Case |
-|-------|--------|---------|-----------|------------|----------|
-| **Stable** | \`release\` | \`latest\` | Manual | SemVer (e.g., \`1.7.4\`) | Production, external users |
-| **Canary** | \`main\` | \`canary\` | Every Push | Snapshot (e.g., \`1.7.4-canary...\`) | Dev, internal testing |
-
-## Prerequisites
-
-- ✅ \`NPM_TOKEN\` secret is configured in GitHub (owner or automation token with _publish_ scope).
-- ✅ \`GITHUB_TOKEN\` (built-in) has permissions to create PRs (enabled by default in new repos).
-- ✅ For stable releases: \`release\` branch exists and is protected.
-
-## Canary Workflow (Automatic)
-
-Every commit pushed to \`main\` triggers the \`.github/workflows/publish-canary.yml\` workflow.
-
-1. **Trigger**: Push to \`main\`.
-2. **Versioning**: Runs \`changeset version --snapshot canary\` to generate a temporary snapshot version.
-3. **Publish**: Packages are published to npm with the \`canary\` tag using \`changeset publish --tag canary\`.
-
-### Consuming Canary Builds
-
-To install the latest bleeding-edge version:
-
-\`\`\`bash
-npm install @lssm/lib.contracts@canary
-# or
-bun add @lssm/lib.contracts@canary
-\`\`\`
-
-## Stable Release Workflow (Manual)
-
-Stable releases are managed via the \`release\` branch using the standard [Changesets Action](https://github.com/changesets/action).
-
-1. **Develop on \`main\`**: Create features and fixes.
-2. **Add Changesets**: Run \`bun changeset\` to document changes and impact (major/minor/patch).
-3. **Merge to \`release\`**: When ready to ship, open a PR from \`main\` to \`release\` or merge manually.
-4. **"Version Packages" PR**:
-   - The GitHub Action detects new changesets and automatically creates a Pull Request titled **"Version Packages"**.
-   - This PR contains the version bumps and updated \`CHANGELOG.md\` files.
-5. **Merge & Publish**:
-   - Review and merge the "Version Packages" PR.
-   - The Action runs again, detects the versions have been bumped, builds the libraries, and publishes them to npm with the \`latest\` tag.
-
-### Publishing Steps
-
-1. Ensure all changesets are present on \`main\`.
-2. Merge \`main\` into \`release\`:
-   \`\`\`bash
-   git checkout release
-   git pull origin release
-   git merge main
-   git push origin release
-   \`\`\`
-3. Go to GitHub Pull Requests. You will see a **"Version Packages"** PR created by the bot.
-4. Merge that PR.
-5. The release is now live on npm!
-
-## Manual Verification (Optional)
-
-Before publishing a new version you can run:
-
-\`\`\`bash
-bun run build:not-apps
-npx npm-packlist --json packages/libs/contracts
-\`\`\`
-
-## Rollback
-
-If 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.
-`}]);
+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