@lssm/lib.mobile-control 2.0.1

package/README.md

@@ -0,0 +1,20 @@
+# @lssm/lib.mobile-control
+
+Website: https://contractspec.io
+
+Typed Builder mobile-control primitives for review cards, parity aggregation, and channel-safe deep-link actions.
+
+## What It Provides
+
+- Mobile parity aggregation for Builder blueprints and review workflows.
+- Mobile review card factories shared by Builder runtime and UI surfaces.
+- Default card actions that preserve a card/deep-link inspection path for critical review flows.
+
+## Public Entry Points
+
+- `.` resolves through `./src/index.ts`
+
+## Notes
+
+- This package is a compatibility surface. Prefer additive evolution.
+- It exists to keep mobile-specific control-plane behavior reusable without duplicating Builder runtime logic.

package/dist/browser/index.js

@@ -0,0 +1 @@
+import{defineFeature as n}from"@lssm/lib.contracts-spec/features";var u=n({meta:{key:"libs.mobile-control",version:"1.0.0",title:"Mobile Control",description:"Builder mobile-control primitives for review cards, parity, and deep-link-safe actions.",domain:"mobile-control",owners:["@contractspec-core"],tags:["package","libs","mobile-control"],stability:"experimental"}});function b(e,r){let o=e.featureParity.some((t)=>t.mobileSupport==="partial"&&!t.mobileFallbackRef?.trim()),l=r.some((t)=>t.channelType!=="mobile_web"&&!t.actions.some((a)=>a.id==="open_details"&&Boolean(a.deepLinkHref?.trim())));if(e.featureParity.some((t)=>t.mobileSupport==="blocked")||o)return"blocked";if(e.featureParity.some((t)=>t.mobileSupport==="partial")||l||r.length===0)return"partial";return"full"}function m(e,r){let o=e.featureParity.filter((i)=>i.mobileSupport==="full"&&i.channelSupport.some((s)=>s==="telegram"||s==="whatsapp")).map((i)=>i.featureKey),l=e.featureParity.filter((i)=>i.mobileSupport==="partial"||Boolean(i.mobileFallbackRef?.trim())).map((i)=>i.featureKey),t=e.featureParity.filter((i)=>i.mobileSupport==="blocked").map((i)=>i.featureKey),a=r.flatMap((i)=>i.actions);return{channelNativeFeatures:o,deepLinkFeatures:l,blockedFeatures:t,channelNativeActionCount:a.filter((i)=>i.deliveryMode==="channel_native").length,deepLinkActionCount:a.filter((i)=>i.deliveryMode==="mobile_web").length}}function d(e){let r=[];if(e?.includeApproveReject!==!1)r.push({id:"approve",label:"Approve",deliveryMode:"channel_native",statusNote:"Safe for direct channel approval."}),r.push({id:"reject",label:"Reject",deliveryMode:"channel_native",statusNote:"Safe for direct channel rejection."});if(e?.includeRequestChanges)r.push({id:"request_changes",label:"Request changes",deliveryMode:"channel_native",statusNote:"Use in-channel correction when the quick summary is enough."});if(e?.includeAcknowledge)r.push({id:"acknowledge",label:"Acknowledge",deliveryMode:"channel_native",statusNote:"Acknowledge the incident directly from the channel."});return r.push(e?.deepLinkHref?{id:"open_details",label:"Open details",deepLinkHref:e.deepLinkHref,deliveryMode:"mobile_web",statusNote:"Use secure mobile web for long diffs, receipts, and detailed evidence."}:{id:"open_details",label:"Open details",deliveryMode:"mobile_web",statusNote:"Use secure mobile web for long diffs, receipts, and detailed evidence."}),r}function f(e){return{id:e.id,workspaceId:e.workspaceId,channelType:e.channelType??"mobile_web",subjectType:e.subjectType??"patch_proposal",subjectId:e.subjectId,summary:e.summary,riskLevel:e.riskLevel??"medium",provider:e.provider,affectedAreas:e.affectedAreas??[],evidence:{sourceRefs:e.sourceRefs??[],receiptId:e.receiptId,harnessSummary:e.harnessSummary??"Review evidence before approving the change."},status:"open",actions:e.actions&&e.actions.length>0?e.actions:d(),createdAt:e.createdAt,updatedAt:e.updatedAt??e.createdAt}}export{u as MobileControlFeature,b as aggregateBuilderMobileParity,m as buildBuilderMobileParitySummary,d as createBuilderMobileReviewActions,f as createBuilderMobileReviewCard};

package/dist/browser/mobile-control.feature.js

@@ -0,0 +1 @@
+import{defineFeature as e}from"@lssm/lib.contracts-spec/features";var i=e({meta:{key:"libs.mobile-control",version:"1.0.0",title:"Mobile Control",description:"Builder mobile-control primitives for review cards, parity, and deep-link-safe actions.",domain:"mobile-control",owners:["@contractspec-core"],tags:["package","libs","mobile-control"],stability:"experimental"}});export{i as MobileControlFeature};

package/dist/index.d.ts

@@ -0,0 +1,37 @@
+import type { BuilderBlueprint, BuilderMobileReviewCard } from '@lssm/lib.builder-spec';
+import type { BuilderMobileParitySummary } from '@lssm/lib.builder-spec/types';
+export interface CreateBuilderMobileReviewCardInput {
+    id: string;
+    workspaceId: string;
+    channelType?: BuilderMobileReviewCard['channelType'];
+    subjectType?: BuilderMobileReviewCard['subjectType'];
+    subjectId: string;
+    summary: string;
+    riskLevel?: BuilderMobileReviewCard['riskLevel'];
+    provider?: BuilderMobileReviewCard['provider'];
+    affectedAreas?: string[];
+    sourceRefs?: string[];
+    receiptId?: string;
+    harnessSummary?: string;
+    actions?: BuilderMobileReviewCard['actions'];
+    createdAt: string;
+    updatedAt?: string;
+}
+export declare function aggregateBuilderMobileParity(blueprint: BuilderBlueprint, mobileReviewCards: BuilderMobileReviewCard[]): "blocked" | "full" | "partial";
+export declare function buildBuilderMobileParitySummary(blueprint: BuilderBlueprint, mobileReviewCards: BuilderMobileReviewCard[]): BuilderMobileParitySummary;
+export declare function createBuilderMobileReviewActions(input?: {
+    deepLinkHref?: string;
+    includeApproveReject?: boolean;
+    includeAcknowledge?: boolean;
+    includeRequestChanges?: boolean;
+}): {
+    id: string;
+    label: string;
+    deepLinkHref?: string;
+    deliveryMode?: import("@lssm/lib.builder-spec").BuilderMobileReviewActionDeliveryMode;
+    statusNote?: string;
+    commandKey?: string;
+    commandPayload?: Record<string, unknown>;
+}[];
+export declare function createBuilderMobileReviewCard(input: CreateBuilderMobileReviewCardInput): BuilderMobileReviewCard;
+export * from './mobile-control.feature.js';

package/dist/index.js

@@ -0,0 +1,2 @@
+// @bun
+import{defineFeature as n}from"@lssm/lib.contracts-spec/features";var u=n({meta:{key:"libs.mobile-control",version:"1.0.0",title:"Mobile Control",description:"Builder mobile-control primitives for review cards, parity, and deep-link-safe actions.",domain:"mobile-control",owners:["@contractspec-core"],tags:["package","libs","mobile-control"],stability:"experimental"}});function b(e,r){let o=e.featureParity.some((t)=>t.mobileSupport==="partial"&&!t.mobileFallbackRef?.trim()),l=r.some((t)=>t.channelType!=="mobile_web"&&!t.actions.some((a)=>a.id==="open_details"&&Boolean(a.deepLinkHref?.trim())));if(e.featureParity.some((t)=>t.mobileSupport==="blocked")||o)return"blocked";if(e.featureParity.some((t)=>t.mobileSupport==="partial")||l||r.length===0)return"partial";return"full"}function m(e,r){let o=e.featureParity.filter((i)=>i.mobileSupport==="full"&&i.channelSupport.some((s)=>s==="telegram"||s==="whatsapp")).map((i)=>i.featureKey),l=e.featureParity.filter((i)=>i.mobileSupport==="partial"||Boolean(i.mobileFallbackRef?.trim())).map((i)=>i.featureKey),t=e.featureParity.filter((i)=>i.mobileSupport==="blocked").map((i)=>i.featureKey),a=r.flatMap((i)=>i.actions);return{channelNativeFeatures:o,deepLinkFeatures:l,blockedFeatures:t,channelNativeActionCount:a.filter((i)=>i.deliveryMode==="channel_native").length,deepLinkActionCount:a.filter((i)=>i.deliveryMode==="mobile_web").length}}function d(e){let r=[];if(e?.includeApproveReject!==!1)r.push({id:"approve",label:"Approve",deliveryMode:"channel_native",statusNote:"Safe for direct channel approval."}),r.push({id:"reject",label:"Reject",deliveryMode:"channel_native",statusNote:"Safe for direct channel rejection."});if(e?.includeRequestChanges)r.push({id:"request_changes",label:"Request changes",deliveryMode:"channel_native",statusNote:"Use in-channel correction when the quick summary is enough."});if(e?.includeAcknowledge)r.push({id:"acknowledge",label:"Acknowledge",deliveryMode:"channel_native",statusNote:"Acknowledge the incident directly from the channel."});return r.push(e?.deepLinkHref?{id:"open_details",label:"Open details",deepLinkHref:e.deepLinkHref,deliveryMode:"mobile_web",statusNote:"Use secure mobile web for long diffs, receipts, and detailed evidence."}:{id:"open_details",label:"Open details",deliveryMode:"mobile_web",statusNote:"Use secure mobile web for long diffs, receipts, and detailed evidence."}),r}function f(e){return{id:e.id,workspaceId:e.workspaceId,channelType:e.channelType??"mobile_web",subjectType:e.subjectType??"patch_proposal",subjectId:e.subjectId,summary:e.summary,riskLevel:e.riskLevel??"medium",provider:e.provider,affectedAreas:e.affectedAreas??[],evidence:{sourceRefs:e.sourceRefs??[],receiptId:e.receiptId,harnessSummary:e.harnessSummary??"Review evidence before approving the change."},status:"open",actions:e.actions&&e.actions.length>0?e.actions:d(),createdAt:e.createdAt,updatedAt:e.updatedAt??e.createdAt}}export{u as MobileControlFeature,b as aggregateBuilderMobileParity,m as buildBuilderMobileParitySummary,d as createBuilderMobileReviewActions,f as createBuilderMobileReviewCard};

package/dist/index.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/mobile-control.feature.d.ts

@@ -0,0 +1 @@
+export declare const MobileControlFeature: import("@lssm/lib.contracts-spec").FeatureModuleSpec;

package/dist/mobile-control.feature.js

@@ -0,0 +1,2 @@
+// @bun
+import{defineFeature as e}from"@lssm/lib.contracts-spec/features";var i=e({meta:{key:"libs.mobile-control",version:"1.0.0",title:"Mobile Control",description:"Builder mobile-control primitives for review cards, parity, and deep-link-safe actions.",domain:"mobile-control",owners:["@contractspec-core"],tags:["package","libs","mobile-control"],stability:"experimental"}});export{i as MobileControlFeature};

package/dist/node/index.js

@@ -0,0 +1 @@
+import{defineFeature as n}from"@lssm/lib.contracts-spec/features";var u=n({meta:{key:"libs.mobile-control",version:"1.0.0",title:"Mobile Control",description:"Builder mobile-control primitives for review cards, parity, and deep-link-safe actions.",domain:"mobile-control",owners:["@contractspec-core"],tags:["package","libs","mobile-control"],stability:"experimental"}});function b(e,r){let o=e.featureParity.some((t)=>t.mobileSupport==="partial"&&!t.mobileFallbackRef?.trim()),l=r.some((t)=>t.channelType!=="mobile_web"&&!t.actions.some((a)=>a.id==="open_details"&&Boolean(a.deepLinkHref?.trim())));if(e.featureParity.some((t)=>t.mobileSupport==="blocked")||o)return"blocked";if(e.featureParity.some((t)=>t.mobileSupport==="partial")||l||r.length===0)return"partial";return"full"}function m(e,r){let o=e.featureParity.filter((i)=>i.mobileSupport==="full"&&i.channelSupport.some((s)=>s==="telegram"||s==="whatsapp")).map((i)=>i.featureKey),l=e.featureParity.filter((i)=>i.mobileSupport==="partial"||Boolean(i.mobileFallbackRef?.trim())).map((i)=>i.featureKey),t=e.featureParity.filter((i)=>i.mobileSupport==="blocked").map((i)=>i.featureKey),a=r.flatMap((i)=>i.actions);return{channelNativeFeatures:o,deepLinkFeatures:l,blockedFeatures:t,channelNativeActionCount:a.filter((i)=>i.deliveryMode==="channel_native").length,deepLinkActionCount:a.filter((i)=>i.deliveryMode==="mobile_web").length}}function d(e){let r=[];if(e?.includeApproveReject!==!1)r.push({id:"approve",label:"Approve",deliveryMode:"channel_native",statusNote:"Safe for direct channel approval."}),r.push({id:"reject",label:"Reject",deliveryMode:"channel_native",statusNote:"Safe for direct channel rejection."});if(e?.includeRequestChanges)r.push({id:"request_changes",label:"Request changes",deliveryMode:"channel_native",statusNote:"Use in-channel correction when the quick summary is enough."});if(e?.includeAcknowledge)r.push({id:"acknowledge",label:"Acknowledge",deliveryMode:"channel_native",statusNote:"Acknowledge the incident directly from the channel."});return r.push(e?.deepLinkHref?{id:"open_details",label:"Open details",deepLinkHref:e.deepLinkHref,deliveryMode:"mobile_web",statusNote:"Use secure mobile web for long diffs, receipts, and detailed evidence."}:{id:"open_details",label:"Open details",deliveryMode:"mobile_web",statusNote:"Use secure mobile web for long diffs, receipts, and detailed evidence."}),r}function f(e){return{id:e.id,workspaceId:e.workspaceId,channelType:e.channelType??"mobile_web",subjectType:e.subjectType??"patch_proposal",subjectId:e.subjectId,summary:e.summary,riskLevel:e.riskLevel??"medium",provider:e.provider,affectedAreas:e.affectedAreas??[],evidence:{sourceRefs:e.sourceRefs??[],receiptId:e.receiptId,harnessSummary:e.harnessSummary??"Review evidence before approving the change."},status:"open",actions:e.actions&&e.actions.length>0?e.actions:d(),createdAt:e.createdAt,updatedAt:e.updatedAt??e.createdAt}}export{u as MobileControlFeature,b as aggregateBuilderMobileParity,m as buildBuilderMobileParitySummary,d as createBuilderMobileReviewActions,f as createBuilderMobileReviewCard};

package/dist/node/mobile-control.feature.js

@@ -0,0 +1 @@
+import{defineFeature as e}from"@lssm/lib.contracts-spec/features";var i=e({meta:{key:"libs.mobile-control",version:"1.0.0",title:"Mobile Control",description:"Builder mobile-control primitives for review cards, parity, and deep-link-safe actions.",domain:"mobile-control",owners:["@contractspec-core"],tags:["package","libs","mobile-control"],stability:"experimental"}});export{i as MobileControlFeature};

package/package.json

@@ -0,0 +1,161 @@
+{
+  "name": "@lssm/lib.mobile-control",
+  "version": "2.0.1",
+  "description": "Builder mobile-control primitives for review cards, parity, and deep-link-safe actions.",
+  "keywords": [
+    "contractspec",
+    "builder",
+    "mobile",
+    "control",
+    "typescript"
+  ],
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
+    "publish:pkg:canary": "bun publish:pkg --tag canary",
+    "build": "contractspec-bun-build build",
+    "build:bundle": "contractspec-bun-build transpile",
+    "build:types": "contractspec-bun-build types",
+    "dev": "contractspec-bun-build dev",
+    "clean": "rimraf dist .turbo",
+    "lint": "bun lint:fix",
+    "lint:fix": "node ../../../scripts/biome.cjs check --write --unsafe --only=nursery/useSortedClasses . && node ../../../scripts/biome.cjs check --write .",
+    "lint:check": "node ../../../scripts/biome.cjs check .",
+    "test": "bun test",
+    "prebuild": "contractspec-bun-build prebuild",
+    "typecheck": "tsgo --noEmit"
+  },
+  "dependencies": {
+    "@lssm/lib.builder-spec": "^2.1.1",
+    "@lssm/lib.provider-spec": "^2.0.1",
+    "@lssm/lib.contracts-spec": "^17.3.2"
+  },
+  "devDependencies": {
+    "@lssm-tech/tool.bun": "5.0.3",
+    "@lssm-tech/tool.typescript": "5.0.1",
+    "typescript": "^7.0.2"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "browser": "./dist/browser/index.js",
+      "bun": "./dist/index.js",
+      "node": "./dist/node/index.js",
+      "default": "./dist/index.js"
+    },
+    "./mobile-control.feature": {
+      "types": "./dist/mobile-control.feature.d.ts",
+      "browser": "./dist/browser/mobile-control.feature.js",
+      "bun": "./dist/mobile-control.feature.js",
+      "node": "./dist/node/mobile-control.feature.js",
+      "default": "./dist/mobile-control.feature.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org",
+    "exports": {
+      ".": {
+        "types": "./dist/index.d.ts",
+        "browser": "./dist/browser/index.js",
+        "bun": "./dist/index.js",
+        "node": "./dist/node/index.js",
+        "default": "./dist/index.js"
+      },
+      "./mobile-control.feature": {
+        "types": "./dist/mobile-control.feature.d.ts",
+        "browser": "./dist/browser/mobile-control.feature.js",
+        "bun": "./dist/mobile-control.feature.js",
+        "node": "./dist/node/mobile-control.feature.js",
+        "default": "./dist/mobile-control.feature.js"
+      }
+    }
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lssm-tech/contractspec.git",
+    "directory": "packages/libs/mobile-control"
+  },
+  "homepage": "https://contractspec.io",
+  "contractspec": {
+    "catalog": {
+      "family": "sharedLibs",
+      "kind": "library",
+      "status": "active",
+      "adoptionMode": "adoptable",
+      "stability": "experimental",
+      "platforms": [
+        "server"
+      ],
+      "runtimes": [
+        "node"
+      ],
+      "entrypoints": [
+        ".",
+        "./mobile-control.feature"
+      ],
+      "documentation": [
+        {
+          "title": "Lib Mobile Control documentation",
+          "url": "https://www.npmjs.com/package/%40lssm%2Flib.mobile-control",
+          "kind": "readme"
+        }
+      ],
+      "examples": [],
+      "replacements": [],
+      "capabilities": [
+        {
+          "id": "package.lssm.tech.lib.mobile.control",
+          "title": "Lib Mobile Control",
+          "description": "Builder mobile-control primitives for review cards, parity, and deep-link-safe actions.",
+          "status": "active",
+          "useCases": [
+            "Adopt builder mobile-control primitives for review cards, parity, and deep-link-safe actions"
+          ],
+          "aliases": [
+            "contractspec",
+            "builder",
+            "mobile",
+            "control",
+            "typescript",
+            "lib"
+          ],
+          "pythonEquivalents": [],
+          "canonicalImports": [
+            {
+              "from": "@lssm/lib.mobile-control",
+              "symbols": []
+            },
+            {
+              "from": "@lssm/lib.mobile-control/mobile-control.feature",
+              "symbols": []
+            }
+          ],
+          "constraints": {
+            "platforms": [
+              "server"
+            ],
+            "runtimes": [
+              "node"
+            ],
+            "avoidWhen": [
+              "The @lssm/lib.mobile-control package constraints do not match the target runtime or platform."
+            ],
+            "requires": [
+              "TypeScript"
+            ]
+          },
+          "alternatives": [],
+          "relationships": [],
+          "resolutionPriority": 50
+        }
+      ]
+    }
+  }
+}