@lssm/lib.jobs 0.0.0-canary-20251217072406 → 0.0.0-canary-20251217073102

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (144) hide show
  1. package/dist/_virtual/rolldown_runtime.js +1 -42
  2. package/dist/contracts/dist/capabilities/openbanking.js +1 -88
  3. package/dist/contracts/dist/client/index.js +1 -5
  4. package/dist/contracts/dist/client/react/feature-render.js +1 -2
  5. package/dist/contracts/dist/client/react/form-render.js +1 -4
  6. package/dist/contracts/dist/client/react/index.js +1 -4
  7. package/dist/contracts/dist/contract-registry/index.js +1 -1
  8. package/dist/contracts/dist/contract-registry/schemas.js +1 -60
  9. package/dist/contracts/dist/docs/PUBLISHING.docblock.js +76 -16
  10. package/dist/contracts/dist/docs/accessibility_wcag_compliance_specs.docblock.js +350 -16
  11. package/dist/contracts/dist/docs/index.js +1 -29
  12. package/dist/contracts/dist/docs/presentations.js +1 -71
  13. package/dist/contracts/dist/docs/registry.js +1 -44
  14. package/dist/contracts/dist/docs/tech/PHASE_1_QUICKSTART.docblock.js +383 -16
  15. package/dist/contracts/dist/docs/tech/PHASE_2_AI_NATIVE_OPERATIONS.docblock.js +68 -16
  16. package/dist/contracts/dist/docs/tech/PHASE_3_AUTO_EVOLUTION.docblock.js +140 -16
  17. package/dist/contracts/dist/docs/tech/PHASE_4_PERSONALIZATION_ENGINE.docblock.js +86 -16
  18. package/dist/contracts/dist/docs/tech/PHASE_5_ZERO_TOUCH_OPERATIONS.docblock.js +1 -16
  19. package/dist/contracts/dist/docs/tech/auth/better-auth-nextjs.docblock.js +2 -24
  20. package/dist/contracts/dist/docs/tech/contracts/openapi-export.docblock.js +2 -21
  21. package/dist/contracts/dist/docs/tech/lifecycle-stage-system.docblock.js +213 -16
  22. package/dist/contracts/dist/docs/tech/llm/llm-integration.docblock.js +5 -73
  23. package/dist/contracts/dist/docs/tech/mcp-endpoints.docblock.js +1 -37
  24. package/dist/contracts/dist/docs/tech/presentation-runtime.docblock.js +1 -16
  25. package/dist/contracts/dist/docs/tech/schema/README.docblock.js +262 -20
  26. package/dist/contracts/dist/docs/tech/studio/learning-events.docblock.js +1 -48
  27. package/dist/contracts/dist/docs/tech/studio/learning-journeys.docblock.js +2 -24
  28. package/dist/contracts/dist/docs/tech/studio/platform-admin-panel.docblock.js +2 -23
  29. package/dist/contracts/dist/docs/tech/studio/project-access-teams.docblock.js +16 -25
  30. package/dist/contracts/dist/docs/tech/studio/project-routing.docblock.js +1 -67
  31. package/dist/contracts/dist/docs/tech/studio/sandbox-unlogged.docblock.js +2 -22
  32. package/dist/contracts/dist/docs/tech/studio/team-invitations.docblock.js +36 -40
  33. package/dist/contracts/dist/docs/tech/studio/workspace-ops.docblock.js +1 -47
  34. package/dist/contracts/dist/docs/tech/studio/workspaces.docblock.js +2 -23
  35. package/dist/contracts/dist/docs/tech/telemetry-ingest.docblock.js +3 -36
  36. package/dist/contracts/dist/docs/tech/templates/runtime.docblock.js +1 -20
  37. package/dist/contracts/dist/docs/tech/vscode-extension.docblock.js +3 -36
  38. package/dist/contracts/dist/docs/tech/workflows/overview.docblock.js +1 -20
  39. package/dist/contracts/dist/events.js +1 -10
  40. package/dist/contracts/dist/experiments/evaluator.js +1 -1
  41. package/dist/contracts/dist/index.js +1 -71
  42. package/dist/contracts/dist/install.js +1 -2
  43. package/dist/contracts/dist/integrations/contracts.js +1 -377
  44. package/dist/contracts/dist/integrations/index.js +1 -18
  45. package/dist/contracts/dist/integrations/openbanking/contracts/accounts.js +1 -228
  46. package/dist/contracts/dist/integrations/openbanking/contracts/balances.js +1 -159
  47. package/dist/contracts/dist/integrations/openbanking/contracts/index.js +1 -3
  48. package/dist/contracts/dist/integrations/openbanking/contracts/transactions.js +1 -210
  49. package/dist/contracts/dist/integrations/openbanking/models.js +1 -242
  50. package/dist/contracts/dist/integrations/openbanking/telemetry.js +1 -13
  51. package/dist/contracts/dist/integrations/providers/elevenlabs.js +1 -52
  52. package/dist/contracts/dist/integrations/providers/gcs-storage.js +1 -75
  53. package/dist/contracts/dist/integrations/providers/gmail.js +1 -87
  54. package/dist/contracts/dist/integrations/providers/google-calendar.js +1 -66
  55. package/dist/contracts/dist/integrations/providers/index.js +1 -11
  56. package/dist/contracts/dist/integrations/providers/mistral.js +1 -68
  57. package/dist/contracts/dist/integrations/providers/postmark.js +1 -68
  58. package/dist/contracts/dist/integrations/providers/powens.js +1 -116
  59. package/dist/contracts/dist/integrations/providers/qdrant.js +1 -73
  60. package/dist/contracts/dist/integrations/providers/registry.js +1 -10
  61. package/dist/contracts/dist/integrations/providers/stripe.js +1 -83
  62. package/dist/contracts/dist/integrations/providers/twilio-sms.js +1 -61
  63. package/dist/contracts/dist/jobs/queue.js +1 -33
  64. package/dist/contracts/dist/jsonschema.js +1 -1
  65. package/dist/contracts/dist/knowledge/contracts.js +1 -306
  66. package/dist/contracts/dist/knowledge/index.js +1 -7
  67. package/dist/contracts/dist/knowledge/spaces/email-threads.js +1 -34
  68. package/dist/contracts/dist/knowledge/spaces/financial-docs.js +1 -34
  69. package/dist/contracts/dist/knowledge/spaces/financial-overview.js +1 -38
  70. package/dist/contracts/dist/knowledge/spaces/index.js +1 -6
  71. package/dist/contracts/dist/knowledge/spaces/product-canon.js +1 -34
  72. package/dist/contracts/dist/knowledge/spaces/support-faq.js +1 -37
  73. package/dist/contracts/dist/knowledge/spaces/uploaded-docs.js +1 -34
  74. package/dist/contracts/dist/llm/exporters.js +1 -19
  75. package/dist/contracts/dist/llm/index.js +1 -2
  76. package/dist/contracts/dist/llm/prompts.js +1 -1
  77. package/dist/contracts/dist/onboarding-base.js +1 -196
  78. package/dist/contracts/dist/openapi.js +1 -1
  79. package/dist/contracts/dist/ownership.js +1 -21
  80. package/dist/contracts/dist/presentations.js +1 -1
  81. package/dist/contracts/dist/presentations.v2.js +1 -11
  82. package/dist/contracts/dist/prompt.js +1 -1
  83. package/dist/contracts/dist/promptRegistry.js +1 -1
  84. package/dist/contracts/dist/regenerator/index.js +1 -1
  85. package/dist/contracts/dist/regenerator/service.js +1 -6
  86. package/dist/contracts/dist/registry.js +1 -2
  87. package/dist/contracts/dist/resources.js +1 -1
  88. package/dist/contracts/dist/schema/dist/EnumType.js +1 -2
  89. package/dist/contracts/dist/schema/dist/FieldType.js +1 -49
  90. package/dist/contracts/dist/schema/dist/ScalarTypeEnum.js +1 -236
  91. package/dist/contracts/dist/schema/dist/SchemaModel.js +1 -34
  92. package/dist/contracts/dist/schema/dist/entity/defineEntity.js +1 -1
  93. package/dist/contracts/dist/schema/dist/entity/index.js +1 -2
  94. package/dist/contracts/dist/schema/dist/entity/types.js +1 -1
  95. package/dist/contracts/dist/schema/dist/index.js +1 -6
  96. package/dist/contracts/dist/server/graphql-pothos.js +1 -6
  97. package/dist/contracts/dist/server/index.js +1 -8
  98. package/dist/contracts/dist/server/mcp/createMcpServer.js +1 -4
  99. package/dist/contracts/dist/server/mcp/registerPresentations.js +1 -2
  100. package/dist/contracts/dist/server/mcp/registerPrompts.js +1 -1
  101. package/dist/contracts/dist/server/mcp/registerResources.js +1 -2
  102. package/dist/contracts/dist/server/mcp/registerTools.js +1 -1
  103. package/dist/contracts/dist/server/provider-mcp.js +1 -1
  104. package/dist/contracts/dist/server/rest-elysia.js +1 -1
  105. package/dist/contracts/dist/server/rest-express.js +1 -1
  106. package/dist/contracts/dist/server/rest-generic.js +1 -1
  107. package/dist/contracts/dist/server/rest-next-app.js +1 -1
  108. package/dist/contracts/dist/server/rest-next-pages.js +1 -1
  109. package/dist/contracts/dist/spec.js +1 -34
  110. package/dist/contracts/dist/telemetry/index.js +1 -1
  111. package/dist/contracts/dist/telemetry/tracker.js +1 -1
  112. package/dist/contracts/dist/tests/index.js +1 -1
  113. package/dist/contracts/dist/tests/runner.js +1 -2
  114. package/dist/contracts/dist/workflow/index.js +1 -1
  115. package/dist/contracts/dist/workflow/runner.js +1 -1
  116. package/dist/contracts/index.d.ts +138 -138
  117. package/dist/contracts/index.js +1 -484
  118. package/dist/entities/index.d.ts +116 -116
  119. package/dist/entities/index.js +1 -198
  120. package/dist/events.js +1 -303
  121. package/dist/handlers/gmail-sync-handler.js +1 -9
  122. package/dist/handlers/index.js +1 -12
  123. package/dist/handlers/ping-job.d.ts +3 -3
  124. package/dist/handlers/ping-job.js +1 -13
  125. package/dist/handlers/storage-document-handler.js +1 -14
  126. package/dist/index.js +1 -18
  127. package/dist/jobs.feature.js +1 -101
  128. package/dist/queue/gcp-cloud-tasks.js +1 -61
  129. package/dist/queue/gcp-pubsub.js +1 -47
  130. package/dist/queue/index.js +1 -9
  131. package/dist/queue/memory-queue.js +1 -140
  132. package/dist/queue/register-defined-job.js +1 -15
  133. package/dist/queue/scaleway-sqs-queue.js +1 -175
  134. package/dist/queue/types.js +1 -3
  135. package/dist/scheduler/index.js +1 -145
  136. package/dist/schema/dist/EnumType.js +1 -2
  137. package/dist/schema/dist/FieldType.js +1 -49
  138. package/dist/schema/dist/ScalarTypeEnum.js +1 -236
  139. package/dist/schema/dist/SchemaModel.js +1 -39
  140. package/dist/schema/dist/entity/defineEntity.js +1 -236
  141. package/dist/schema/dist/entity/index.js +1 -2
  142. package/dist/schema/dist/entity/types.js +1 -1
  143. package/dist/schema/dist/index.js +1 -6
  144. package/package.json +7 -7
@@ -1,42 +1 @@
1
- //#region rolldown:runtime
2
- var __defProp = Object.defineProperty;
3
- var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
4
- var __getOwnPropNames = Object.getOwnPropertyNames;
5
- var __hasOwnProp = Object.prototype.hasOwnProperty;
6
- var __export = (all, symbols) => {
7
- let target = {};
8
- for (var name in all) {
9
- __defProp(target, name, {
10
- get: all[name],
11
- enumerable: true
12
- });
13
- }
14
- if (symbols) {
15
- __defProp(target, Symbol.toStringTag, { value: "Module" });
16
- }
17
- return target;
18
- };
19
- var __copyProps = (to, from, except, desc) => {
20
- if (from && typeof from === "object" || typeof from === "function") {
21
- for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
22
- key = keys[i];
23
- if (!__hasOwnProp.call(to, key) && key !== except) {
24
- __defProp(to, key, {
25
- get: ((k) => from[k]).bind(null, key),
26
- enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
27
- });
28
- }
29
- }
30
- }
31
- return to;
32
- };
33
- var __reExport = (target, mod, secondTarget, symbols) => {
34
- if (symbols) {
35
- __defProp(target, Symbol.toStringTag, { value: "Module" });
36
- secondTarget && __defProp(secondTarget, Symbol.toStringTag, { value: "Module" });
37
- }
38
- __copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default");
39
- };
40
-
41
- //#endregion
42
- export { __export, __reExport };
1
+ var e=Object.defineProperty,t=Object.getOwnPropertyDescriptor,n=Object.getOwnPropertyNames,r=Object.prototype.hasOwnProperty,i=(t,n)=>{let r={};for(var i in t)e(r,i,{get:t[i],enumerable:!0});return n&&e(r,Symbol.toStringTag,{value:`Module`}),r},a=(i,a,o,s)=>{if(a&&typeof a==`object`||typeof a==`function`)for(var c=n(a),l=0,u=c.length,d;l<u;l++)d=c[l],!r.call(i,d)&&d!==o&&e(i,d,{get:(e=>a[e]).bind(null,d),enumerable:!(s=t(a,d))||s.enumerable});return i},o=(t,n,r,i)=>{i&&(e(t,Symbol.toStringTag,{value:`Module`}),r&&e(r,Symbol.toStringTag,{value:`Module`})),a(t,n,`default`),r&&a(r,n,`default`)};export{i as __export,o as __reExport};
@@ -1,88 +1 @@
1
- import { StabilityEnum } from "../ownership.js";
2
-
3
- //#region ../contracts/dist/capabilities/openbanking.js
4
- const OWNERS = ["platform.finance"];
5
- const TAGS = ["open-banking", "finance"];
6
- const openBankingAccountsReadCapability = {
7
- meta: {
8
- key: "openbanking.accounts.read",
9
- version: 1,
10
- kind: "integration",
11
- title: "Open Banking Accounts (Read)",
12
- description: "Provides read-only access to linked bank accounts, including account summaries and metadata.",
13
- domain: "finance",
14
- owners: [...OWNERS],
15
- tags: [...TAGS],
16
- stability: StabilityEnum.Experimental
17
- },
18
- provides: [
19
- {
20
- surface: "operation",
21
- name: "openbanking.accounts.list",
22
- version: 1,
23
- description: "List bank accounts linked to a Powens open banking connection."
24
- },
25
- {
26
- surface: "operation",
27
- name: "openbanking.accounts.get",
28
- version: 1,
29
- description: "Retrieve the canonical bank account record for a specific account."
30
- },
31
- {
32
- surface: "operation",
33
- name: "openbanking.accounts.sync",
34
- version: 1,
35
- description: "Trigger a refresh of bank account metadata from the open banking provider."
36
- }
37
- ]
38
- };
39
- const openBankingTransactionsReadCapability = {
40
- meta: {
41
- key: "openbanking.transactions.read",
42
- version: 1,
43
- kind: "integration",
44
- title: "Open Banking Transactions (Read)",
45
- description: "Enables retrieval of transaction history for linked bank accounts via open banking providers.",
46
- domain: "finance",
47
- owners: [...OWNERS],
48
- tags: [...TAGS, "transactions"],
49
- stability: StabilityEnum.Experimental
50
- },
51
- provides: [{
52
- surface: "operation",
53
- name: "openbanking.transactions.list",
54
- version: 1,
55
- description: "List transactions for a given bank account with optional date filtering."
56
- }, {
57
- surface: "operation",
58
- name: "openbanking.transactions.sync",
59
- version: 1,
60
- description: "Synchronise transactions from the open banking provider into the canonical ledger."
61
- }]
62
- };
63
- const openBankingBalancesReadCapability = {
64
- meta: {
65
- key: "openbanking.balances.read",
66
- version: 1,
67
- kind: "integration",
68
- title: "Open Banking Balances (Read)",
69
- description: "Allows querying of current and available balances for linked bank accounts via open banking providers.",
70
- domain: "finance",
71
- owners: [...OWNERS],
72
- tags: [...TAGS, "balances"],
73
- stability: StabilityEnum.Experimental
74
- },
75
- provides: [{
76
- surface: "operation",
77
- name: "openbanking.balances.get",
78
- version: 1,
79
- description: "Retrieve the latest known balances for a specified bank account."
80
- }, {
81
- surface: "operation",
82
- name: "openbanking.balances.refresh",
83
- version: 1,
84
- description: "Force a balance refresh from the open banking provider."
85
- }]
86
- };
87
-
88
- //#endregion
1
+ 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;
@@ -1,5 +1 @@
1
- 'use client';
2
-
3
- import "./react/feature-render.js";
4
- import "./react/form-render.js";
5
- import "./react/index.js";
1
+ "use client";import"./react/feature-render.js";import"./react/form-render.js";import"./react/index.js";
@@ -1,2 +1 @@
1
- import "../../presentations.v2.js";
2
- import "react";
1
+ import"../../presentations.v2.js";import"react";
@@ -1,4 +1 @@
1
- import "react";
2
- import "react-hook-form";
3
- import "@hookform/resolvers/zod";
4
- import "react/jsx-runtime";
1
+ import"react";import"react-hook-form";import"@hookform/resolvers/zod";import"react/jsx-runtime";
@@ -1,4 +1 @@
1
- 'use client';
2
-
3
- import "./feature-render.js";
4
- import "./form-render.js";
1
+ "use client";import"./feature-render.js";import"./form-render.js";
@@ -1 +1 @@
1
- import { ContractRegistryFileSchema, ContractRegistryItemSchema, ContractRegistryItemTypeSchema } from "./schemas.js";
1
+ import{i as e,n as t,r as n}from"./schemas.js";
@@ -1,60 +1 @@
1
- import { StabilityEnum } from "../ownership.js";
2
- import z from "zod";
3
-
4
- //#region ../contracts/dist/contract-registry/schemas.js
5
- const ContractRegistryItemTypeSchema = z.enum([
6
- "contractspec:operation",
7
- "contractspec:event",
8
- "contractspec:presentation",
9
- "contractspec:form",
10
- "contractspec:feature",
11
- "contractspec:workflow",
12
- "contractspec:template",
13
- "contractspec:integration",
14
- "contractspec:data-view",
15
- "contractspec:migration",
16
- "contractspec:telemetry",
17
- "contractspec:experiment",
18
- "contractspec:app-config",
19
- "contractspec:knowledge"
20
- ]);
21
- const ContractRegistryFileSchema = z.object({
22
- path: z.string().min(1),
23
- type: z.string().min(1),
24
- content: z.string().optional()
25
- });
26
- const ContractRegistryItemSchema = z.object({
27
- name: z.string().min(1),
28
- type: ContractRegistryItemTypeSchema,
29
- version: z.number().int().nonnegative(),
30
- title: z.string().min(1),
31
- description: z.string().min(1),
32
- meta: z.object({
33
- stability: z.enum([
34
- StabilityEnum.Idea,
35
- StabilityEnum.InCreation,
36
- StabilityEnum.Experimental,
37
- StabilityEnum.Beta,
38
- StabilityEnum.Stable,
39
- StabilityEnum.Deprecated
40
- ]),
41
- owners: z.array(z.string().min(1)).default([]),
42
- tags: z.array(z.string().min(1)).default([])
43
- }),
44
- dependencies: z.array(z.string().min(1)).optional(),
45
- registryDependencies: z.array(z.string().min(1)).optional(),
46
- files: z.array(ContractRegistryFileSchema).min(1),
47
- schema: z.object({
48
- input: z.unknown().optional(),
49
- output: z.unknown().optional()
50
- }).optional()
51
- });
52
- const ContractRegistryManifestSchema = z.object({
53
- $schema: z.string().min(1).optional(),
54
- name: z.string().min(1),
55
- homepage: z.string().min(1).optional(),
56
- items: z.array(ContractRegistryItemSchema)
57
- });
58
-
59
- //#endregion
60
- export { ContractRegistryFileSchema, ContractRegistryItemSchema, ContractRegistryItemTypeSchema };
1
+ 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)});export{i,n,r};
@@ -1,16 +1,76 @@
1
- import { registerDocBlocks } from "./registry.js";
2
-
3
- //#region ../contracts/dist/docs/PUBLISHING.docblock.js
4
- const PUBLISHING_DocBlocks = [{
5
- id: "docs.PUBLISHING",
6
- title: "Publishing ContractSpec Libraries",
7
- summary: "This guide describes how we release the ContractSpec libraries to npm. We use a dual-track release system: **Stable** (manual) and **Canary** (automatic).",
8
- kind: "reference",
9
- visibility: "public",
10
- route: "/docs/PUBLISHING",
11
- tags: ["PUBLISHING"],
12
- 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"
13
- }];
14
- registerDocBlocks(PUBLISHING_DocBlocks);
15
-
16
- //#endregion
1
+ 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
2
+
3
+ This guide describes how we release the ContractSpec libraries to npm. We use a dual-track release system: **Stable** (manual) and **Canary** (automatic).
4
+
5
+ ## Release Tracks
6
+
7
+ | Track | Branch | npm Tag | Frequency | Versioning | Use Case |
8
+ |-------|--------|---------|-----------|------------|----------|
9
+ | **Stable** | \`release\` | \`latest\` | Manual | SemVer (e.g., \`1.7.4\`) | Production, external users |
10
+ | **Canary** | \`main\` | \`canary\` | Every Push | Snapshot (e.g., \`1.7.4-canary...\`) | Dev, internal testing |
11
+
12
+ ## Prerequisites
13
+
14
+ - ✅ \`NPM_TOKEN\` secret is configured in GitHub (owner or automation token with _publish_ scope).
15
+ - ✅ \`GITHUB_TOKEN\` (built-in) has permissions to create PRs (enabled by default in new repos).
16
+ - ✅ For stable releases: \`release\` branch exists and is protected.
17
+
18
+ ## Canary Workflow (Automatic)
19
+
20
+ Every commit pushed to \`main\` triggers the \`.github/workflows/publish-canary.yml\` workflow.
21
+
22
+ 1. **Trigger**: Push to \`main\`.
23
+ 2. **Versioning**: Runs \`changeset version --snapshot canary\` to generate a temporary snapshot version.
24
+ 3. **Publish**: Packages are published to npm with the \`canary\` tag using \`changeset publish --tag canary\`.
25
+
26
+ ### Consuming Canary Builds
27
+
28
+ To install the latest bleeding-edge version:
29
+
30
+ \`\`\`bash
31
+ npm install @lssm/lib.contracts@canary
32
+ # or
33
+ bun add @lssm/lib.contracts@canary
34
+ \`\`\`
35
+
36
+ ## Stable Release Workflow (Manual)
37
+
38
+ Stable releases are managed via the \`release\` branch using the standard [Changesets Action](https://github.com/changesets/action).
39
+
40
+ 1. **Develop on \`main\`**: Create features and fixes.
41
+ 2. **Add Changesets**: Run \`bun changeset\` to document changes and impact (major/minor/patch).
42
+ 3. **Merge to \`release\`**: When ready to ship, open a PR from \`main\` to \`release\` or merge manually.
43
+ 4. **"Version Packages" PR**:
44
+ - The GitHub Action detects new changesets and automatically creates a Pull Request titled **"Version Packages"**.
45
+ - This PR contains the version bumps and updated \`CHANGELOG.md\` files.
46
+ 5. **Merge & Publish**:
47
+ - Review and merge the "Version Packages" PR.
48
+ - The Action runs again, detects the versions have been bumped, builds the libraries, and publishes them to npm with the \`latest\` tag.
49
+
50
+ ### Publishing Steps
51
+
52
+ 1. Ensure all changesets are present on \`main\`.
53
+ 2. Merge \`main\` into \`release\`:
54
+ \`\`\`bash
55
+ git checkout release
56
+ git pull origin release
57
+ git merge main
58
+ git push origin release
59
+ \`\`\`
60
+ 3. Go to GitHub Pull Requests. You will see a **"Version Packages"** PR created by the bot.
61
+ 4. Merge that PR.
62
+ 5. The release is now live on npm!
63
+
64
+ ## Manual Verification (Optional)
65
+
66
+ Before publishing a new version you can run:
67
+
68
+ \`\`\`bash
69
+ bun run build:not-apps
70
+ npx npm-packlist --json packages/libs/contracts
71
+ \`\`\`
72
+
73
+ ## Rollback
74
+
75
+ 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.
76
+ `}]);