@lssm/example.marketplace 0.0.0-canary-20251217080011 → 0.0.0-canary-20251219202229

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Chaman Ventures, SASU
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -126,3 +126,5 @@ const order = await executeContract(CreateOrderContract, {
 
 
 
+
+

package/dist/docs/marketplace.docblock.js

@@ -112,4 +112,5 @@ registerDocBlocks([
 	}
 ]);
 
-//#endregion
+//#endregion
+//# sourceMappingURL=marketplace.docblock.js.map

package/dist/docs/marketplace.docblock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"marketplace.docblock.js","names":[],"sources":["../../src/docs/marketplace.docblock.ts"],"sourcesContent":["import type { DocBlock } from '@lssm/lib.contracts/docs';\nimport { registerDocBlocks } from '@lssm/lib.contracts/docs';\n\nconst marketplaceDocBlocks: DocBlock[] = [\n  {\n    id: 'docs.examples.marketplace',\n    title: 'Marketplace (2-sided)',\n    summary:\n      'Two-sided marketplace with stores, products, orders, payouts, and reviews. Demonstrates multi-actor flows, payments, and attachments.',\n    kind: 'reference',\n    visibility: 'public',\n    route: '/docs/examples/marketplace',\n    tags: ['marketplace', 'orders', 'payouts', 'reviews'],\n    body: `## Entities\n\n- Store, Product, Order, OrderItem, Payout, Review.\n- Uses Files module for product media and receipt attachments.\n\n## Contracts\n\n- \\`marketplace.store.create\\`, \\`marketplace.product.add\\`, \\`marketplace.order.place\\`, \\`marketplace.payout.process\\`, \\`marketplace.review.submit\\`.\n- Policy guards via Identity/RBAC for provider vs client actions.\n\n## Events\n\n- order.created/completed/cancelled, payout.queued/completed, review.submitted.\n- Hooked into Notifications and Audit Trail modules.\n\n## UI / Presentations\n\n- Dashboard, product catalog, order list/detail, store management.\n- Templates registered under \\`marketplace\\` in Studio Template Registry.\n\n## Notes\n\n- Commission model encoded in spec; payouts scheduled via Jobs module.\n- Feature flags can gate beta checkout or new reviews flow.\n`,\n  },\n  {\n    id: 'docs.examples.marketplace.goal',\n    title: 'Marketplace — Goal',\n    summary:\n      'Why this marketplace template exists and the outcomes it targets.',\n    kind: 'goal',\n    visibility: 'public',\n    route: '/docs/examples/marketplace/goal',\n    tags: ['marketplace', 'goal'],\n    body: `## Why it matters\n- Provides a regenerable 2-sided marketplace baseline without bespoke glue.\n- Keeps payouts, catalog, orders, and reviews consistent across surfaces.\n\n## Business/Product goal\n- Safe provider/client flows with auditable payouts and moderation-ready reviews.\n- Staged rollouts for payments/reviews via feature flags; explicit commission/tax fields.\n\n## Success criteria\n- Orders/payouts regenerate cleanly after spec changes.\n- Events emit for lifecycle + audit; PII is scoped/redacted in presentations.`,\n  },\n  {\n    id: 'docs.examples.marketplace.usage',\n    title: 'Marketplace — Usage',\n    summary: 'How to seed, extend, and safely regenerate the marketplace.',\n    kind: 'usage',\n    visibility: 'public',\n    route: '/docs/examples/marketplace/usage',\n    tags: ['marketplace', 'usage'],\n    body: `## Setup\n1) Seed sample stores/products/orders via template registry (or create via UI).\n2) Configure Files storage for media/receipts; set policy.pii for sensitive fields.\n\n## Extend & regenerate\n1) Adjust schemas for commission/tax/payout states or review moderation in the spec.\n2) Regenerate to sync UI, API, events, notifications.\n3) Gate risky changes (new payment providers) behind Feature Flags.\n\n## Guardrails\n- Emit events for order/payout state changes; log via Audit Trail.\n- Avoid hidden commission math—keep explicit fields.\n- Redact buyer/provider PII in markdown/JSON presentations.`,\n  },\n  {\n    id: 'docs.examples.marketplace.constraints',\n    title: 'Marketplace — Constraints & Safety',\n    summary:\n      'Internal guardrails for payouts, order states, and regeneration semantics.',\n    kind: 'reference',\n    visibility: 'internal',\n    route: '/docs/examples/marketplace/constraints',\n    tags: ['marketplace', 'constraints', 'internal'],\n    body: `## Constraints\n- Commission logic and order states must stay spec-defined; never adjust in code-only patches.\n- Events to emit: order.created, order.completed, payout.queued, review.posted (minimum).\n- Regeneration must not change payment semantics without explicit spec diff.\n\n## Safety & PII\n- Redact buyer/provider identifiers in markdown/JSON outputs; scope payouts per tenant/org.\n- For MCP/web surfaces, avoid exposing raw payout calc inputs; use summaries.\n\n## Testing/Verification\n- Add fixtures covering order lifecycle and payout queueing.\n- Run regeneration diff when changing commission/tax fields; verify presentations updated.\n- Ensure Notifications/Audit wiring remains intact for order/payout/review events.`,\n  },\n];\n\nregisterDocBlocks(marketplaceDocBlocks);\n"],"mappings":";;;;AA2GA,kBAxGyC;CACvC;EACE,IAAI;EACJ,OAAO;EACP,SACE;EACF,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM;GAAC;GAAe;GAAU;GAAW;GAAU;EACrD,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;EAyBP;CACD;EACE,IAAI;EACJ,OAAO;EACP,SACE;EACF,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM,CAAC,eAAe,OAAO;EAC7B,MAAM;;;;;;;;;;;EAWP;CACD;EACE,IAAI;EACJ,OAAO;EACP,SAAS;EACT,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM,CAAC,eAAe,QAAQ;EAC9B,MAAM;;;;;;;;;;;;;EAaP;CACD;EACE,IAAI;EACJ,OAAO;EACP,SACE;EACF,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM;GAAC;GAAe;GAAe;GAAW;EAChD,MAAM;;;;;;;;;;;;;EAaP;CACF,CAEsC"}