@teambit/ci 1.0.485 → 1.0.487

package/dist/sync/sync-config.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_bitError","data","require","isValidGitBranchName","name","validateBranchName","undefined","startsWith","test","includes","endsWith","split","some","component","assertValidBranchName","configKey","problem","BitError","assertValidBranchPrefix","prefix","resolveSyncConfig","raw","resolved","branchPrefix","branches","lanes","mainSyncBranch","autoMergeMainSyncPr","mainSync","onConflict","Object","entries","forEach","laneName","branch","laneNameToBranch","cfg","override","derived","branchToLaneName","find","b","slice","length","parseLaneTarget","input","defaultScope","trimmed","trim","hostScope","parts","syncableLaneNameForBranch","isValidLaneName","MAX_LANE_NAME_LENGTH","globToRegExp","glob","escaped","replace","RegExp","shouldSyncLane","pattern"],"sources":["sync-config.ts"],"sourcesContent":["import { BitError } from '@teambit/bit-error';\n\n/**\n * Is this a branch name git will accept? A conservative pure subset of `git check-ref-format --branch`:\n * stricter than git is fine, laxer is not. A leading `-` must be refused here because it would be read\n * as a command-line option once interpolated into a git invocation.\n */\nexport function isValidGitBranchName(name: string): boolean {\n  return validateBranchName(name) === undefined;\n}\n\n/** Why `name` is not a usable branch name, or undefined when it is. */\nexport function validateBranchName(name: string): string | undefined {\n  if (!name) return 'it is empty';\n  if (name.startsWith('-')) return 'it starts with \"-\", which git would read as a command-line option';\n  if (/\\s/.test(name)) return 'it contains whitespace';\n  // oxlint-disable-next-line no-control-regex\n  if (/[\\x00-\\x1f\\x7f]/.test(name)) return 'it contains a control character';\n  if (/[~^:?*[\\\\]/.test(name)) return 'it contains one of the characters git forbids in a ref: ~ ^ : ? * [ \\\\';\n  if (name.includes('..')) return 'it contains \"..\"';\n  if (name.includes('@{')) return 'it contains \"@{\"';\n  if (name === '@') return 'it is \"@\", which git reserves';\n  // Leading `refs/` only: pushes interpolate the name into `refs/heads/<b>`, so it would double up.\n  if (name.startsWith('refs/'))\n    return 'it starts with \"refs/\" — configure the bare branch name (\"main\", not \"refs/heads/main\")';\n  if (name.startsWith('/') || name.endsWith('/')) return 'it starts or ends with \"/\"';\n  if (name.includes('//')) return 'it contains an empty path component (\"//\")';\n  if (name.endsWith('.')) return 'it ends with \".\"';\n  if (name.endsWith('.lock')) return 'it ends with \".lock\"';\n  if (name.split('/').some((component) => component.startsWith('.'))) return 'a path component starts with \".\"';\n  if (name.split('/').some((component) => component.endsWith('.lock'))) return 'a path component ends with \".lock\"';\n  return undefined;\n}\n\n/** Throw a `BitError` naming the offending config key and value unless `name` is a usable branch name. */\nexport function assertValidBranchName(name: string, configKey: string): void {\n  const problem = validateBranchName(name);\n  if (!problem) return;\n  throw new BitError(\n    `bit ci sync: ${configKey} is \"${name}\", which is not a valid git branch name — ${problem}. ` +\n      `Fix it in the \"teambit.git/ci\" sync config in workspace.jsonc.`\n  );\n}\n\n/**\n * A `branchPrefix` may end in `/` or be empty, so it is validated as the *start* of a branch name.\n * The full check still happens on the derived name (see `laneNameToBranch`).\n */\nexport function assertValidBranchPrefix(prefix: string, configKey: string): void {\n  if (!prefix) return;\n  const problem = validateBranchName(`${prefix}x`);\n  if (!problem) return;\n  throw new BitError(\n    `bit ci sync: ${configKey} is \"${prefix}\", which cannot start a valid git branch name — ${problem}. ` +\n      `Fix it in the \"teambit.git/ci\" sync config in workspace.jsonc.`\n  );\n}\n\nexport interface CiSyncConfig {\n  /** The prefix for a lane-mapped branch. 'lane/' maps lane my-lane to branch lane/my-lane. */\n  branchPrefix?: string;\n  /** Explicit overrides that map a lane name to a branch name. */\n  branches?: Record<string, string>;\n  /** The glob patterns of the lane names to sync. An empty list stops lane mirroring. */\n  lanes?: string[];\n  /** The branch that carries the main-scope drift. */\n  mainSyncBranch?: string;\n  /**\n   * How main-scope drift reaches the default branch. 'pr' (the default): the command commits the drift\n   * to `mainSyncBranch` and opens a pull request. 'direct-push': the command commits the drift on the\n   * default branch and pushes it, and does not use `mainSyncBranch`.\n   */\n  mainSync?: 'pr' | 'direct-push';\n  /**\n   * What the command does with one contested line during a `merge-diverged` action. 'halt' (the\n   * default): the command stops, labels the pull request, and writes the recovery steps. 'git-wins':\n   * the command keeps the branch version. 'lane-wins': the command takes the lane version.\n   * Non-conflicting changes always merge, with every value.\n   */\n  onConflict?: 'halt' | 'git-wins' | 'lane-wins';\n  /** Reserved. The command warns and enables no auto-merge on the main sync pull request. */\n  autoMergeMainSyncPr?: boolean;\n}\n\n/**\n * Resolve the configured sync options, validating every branch name before anything runs — a bad name\n * must fail at startup naming the config key, not mid-run with git's own ref error.\n */\nexport function resolveSyncConfig(raw?: CiSyncConfig): Required<CiSyncConfig> {\n  const resolved: Required<CiSyncConfig> = {\n    branchPrefix: raw?.branchPrefix ?? '',\n    branches: raw?.branches ?? {},\n    lanes: raw?.lanes ?? ['*'],\n    mainSyncBranch: raw?.mainSyncBranch ?? 'bit-sync/main',\n    autoMergeMainSyncPr: raw?.autoMergeMainSyncPr ?? false,\n    mainSync: raw?.mainSync ?? 'pr',\n    onConflict: raw?.onConflict ?? 'halt',\n  };\n  // Config comes from workspace.jsonc, so the union types are not enforced at runtime; a typo must\n  // fail at startup rather than fall through to whichever mode a comparison happens to miss.\n  if (resolved.mainSync !== 'pr' && resolved.mainSync !== 'direct-push') {\n    throw new BitError(\n      `sync.mainSync: \"${resolved.mainSync}\" is not a valid value. Use \"pr\" (propose the main-scope drift ` +\n        `as a pull request from sync.mainSyncBranch) or \"direct-push\" (push the drift straight onto the ` +\n        `default branch)`\n    );\n  }\n  if (resolved.onConflict !== 'halt' && resolved.onConflict !== 'git-wins' && resolved.onConflict !== 'lane-wins') {\n    throw new BitError(\n      `sync.onConflict: \"${resolved.onConflict}\" is not a valid value. Use \"halt\" (stop the conflicted ` +\n        `lane, label the PR and let a human resolve — the default), \"git-wins\" (conflicting hunks keep ` +\n        `the branch's version) or \"lane-wins\" (conflicting hunks take the lane's version)`\n    );\n  }\n  assertValidBranchPrefix(resolved.branchPrefix, 'sync.branchPrefix');\n  assertValidBranchName(resolved.mainSyncBranch, 'sync.mainSyncBranch');\n  Object.entries(resolved.branches).forEach(([laneName, branch]) =>\n    assertValidBranchName(branch, `sync.branches[\"${laneName}\"]`)\n  );\n  return resolved;\n}\n\n/**\n * The branch a lane name maps to. The derived result is validated too: a prefix that is fine on its\n * own can still combine with a lane name into something git refuses.\n */\nexport function laneNameToBranch(laneName: string, cfg: Required<CiSyncConfig>): string {\n  const override = cfg.branches[laneName];\n  if (override) return override; // already validated by resolveSyncConfig\n  const derived = `${cfg.branchPrefix}${laneName}`;\n  assertValidBranchName(derived, `the branch for lane \"${laneName}\" (sync.branchPrefix + lane name)`);\n  return derived;\n}\n\nexport function branchToLaneName(branch: string, cfg: Required<CiSyncConfig>): string | undefined {\n  const override = Object.entries(cfg.branches).find(([, b]) => b === branch);\n  if (override) return override[0];\n  if (cfg.branchPrefix) {\n    return branch.startsWith(cfg.branchPrefix) ? branch.slice(cfg.branchPrefix.length) : undefined;\n  }\n  return branch;\n}\n\n/**\n * A lane to sync, split into the scope hosting the lane object and the bare name. The branch mapping\n * uses the NAME only; every bit operation uses the full `hostScope/name`.\n */\nexport type LaneTarget = {\n  /** the scope hosting the lane object; the workspace's defaultScope unless the target said otherwise */\n  hostScope: string;\n  /** the bare lane name — never contains a '/' */\n  name: string;\n};\n\n/**\n * Parse the `[lane]` argument (`my-lane` or `some-org.some-scope/my-lane`) into a {@link LaneTarget}.\n * A lane name cannot contain `/`, so the single `/` is always the scope/name boundary. The dot in a\n * scope id is not required (self-hosted scopes can be bare names), so it is not validated here.\n */\nexport function parseLaneTarget(input: string, defaultScope: string): LaneTarget {\n  const trimmed = input.trim();\n  if (!trimmed) throw new BitError('bit ci sync: the lane argument is empty');\n  if (!trimmed.includes('/')) return { hostScope: defaultScope, name: trimmed };\n  const parts = trimmed.split('/');\n  const [hostScope, name] = parts;\n  if (parts.length !== 2 || !hostScope || !name) {\n    throw new BitError(\n      `bit ci sync: \"${input}\" is not a valid lane target. Use either a lane name (\"my-lane\", resolved ` +\n        `against the workspace's defaultScope \"${defaultScope}\") or a scope-qualified lane id ` +\n        `(\"some-org.some-scope/my-lane\")`\n    );\n  }\n  return { hostScope, name };\n}\n\n/**\n * The lane name a branch maps to, only if that name could actually be a lane AND maps back to a branch\n * name usable in a git invocation. `branchToLaneName` alone is a string transform (the identity under\n * the default empty prefix), so it would report `feature/foo` as a \"lane\" — a name bit forbids. The\n * round trip matters because the lane grammar permits `-`: a developer branch called `-x` is a valid\n * lane name, so enumeration would adopt it as a target and the branch mapping would then throw, turning\n * one oddly-named branch into a halt that fails the whole `--all` run. Such a branch is not lane-mapped;\n * skip it like any other.\n */\nexport function syncableLaneNameForBranch(branch: string, cfg: Required<CiSyncConfig>): string | undefined {\n  const laneName = branchToLaneName(branch, cfg);\n  if (!laneName || !isValidLaneName(laneName)) return undefined;\n  // `laneNameToBranch` asserts rather than returns, so the round trip is checked here: a configured\n  // override is already validated, and a derived name must pass the same branch-name rules.\n  if (cfg.branches[laneName]) return laneName;\n  return validateBranchName(`${cfg.branchPrefix}${laneName}`) === undefined ? laneName : undefined;\n}\n\n/** bit's own maximum lane-name length (`create-lane.ts`'s `MAX_LANE_NAME_LENGTH`). */\nconst MAX_LANE_NAME_LENGTH = 800;\n\n/**\n * Could this string be a bit lane name at all? Mirrors the module-private `isValidLaneName` in\n * `create-lane.ts`; drift errs toward skipping a branch, and `sync-config.spec.ts` pins the rule.\n */\nexport function isValidLaneName(name: string): boolean {\n  if (!name || name.length > MAX_LANE_NAME_LENGTH) return false;\n  return /^[$\\-_!a-z0-9]+$/.test(name);\n}\n\n/** minimal glob: '*' wildcard only (matches the lanes list use-case; avoids a new dep) */\nfunction globToRegExp(glob: string): RegExp {\n  const escaped = glob.replace(/[.+^${}()|[\\]\\\\]/g, '\\\\$&').replace(/\\*/g, '.*');\n  return new RegExp(`^${escaped}$`);\n}\n\nexport function shouldSyncLane(laneName: string, cfg: Required<CiSyncConfig>): boolean {\n  return cfg.lanes.some((pattern) => globToRegExp(pattern).test(laneName));\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAAA,SAAAA,UAAA;EAAA,MAAAC,IAAA,GAAAC,OAAA;EAAAF,SAAA,YAAAA,CAAA;IAAA,OAAAC,IAAA;EAAA;EAAA,OAAAA,IAAA;AAAA;AAEA;AACA;AACA;AACA;AACA;AACO,SAASE,oBAAoBA,CAACC,IAAY,EAAW;EAC1D,OAAOC,kBAAkB,CAACD,IAAI,CAAC,KAAKE,SAAS;AAC/C;;AAEA;AACO,SAASD,kBAAkBA,CAACD,IAAY,EAAsB;EACnE,IAAI,CAACA,IAAI,EAAE,OAAO,aAAa;EAC/B,IAAIA,IAAI,CAACG,UAAU,CAAC,GAAG,CAAC,EAAE,OAAO,mEAAmE;EACpG,IAAI,IAAI,CAACC,IAAI,CAACJ,IAAI,CAAC,EAAE,OAAO,wBAAwB;EACpD;EACA,IAAI,iBAAiB,CAACI,IAAI,CAACJ,IAAI,CAAC,EAAE,OAAO,iCAAiC;EAC1E,IAAI,YAAY,CAACI,IAAI,CAACJ,IAAI,CAAC,EAAE,OAAO,wEAAwE;EAC5G,IAAIA,IAAI,CAACK,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,kBAAkB;EAClD,IAAIL,IAAI,CAACK,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,kBAAkB;EAClD,IAAIL,IAAI,KAAK,GAAG,EAAE,OAAO,+BAA+B;EACxD;EACA,IAAIA,IAAI,CAACG,UAAU,CAAC,OAAO,CAAC,EAC1B,OAAO,yFAAyF;EAClG,IAAIH,IAAI,CAACG,UAAU,CAAC,GAAG,CAAC,IAAIH,IAAI,CAACM,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,4BAA4B;EACnF,IAAIN,IAAI,CAACK,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,4CAA4C;EAC5E,IAAIL,IAAI,CAACM,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,kBAAkB;EACjD,IAAIN,IAAI,CAACM,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,sBAAsB;EACzD,IAAIN,IAAI,CAACO,KAAK,CAAC,GAAG,CAAC,CAACC,IAAI,CAAEC,SAAS,IAAKA,SAAS,CAACN,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,kCAAkC;EAC7G,IAAIH,IAAI,CAACO,KAAK,CAAC,GAAG,CAAC,CAACC,IAAI,CAAEC,SAAS,IAAKA,SAAS,CAACH,QAAQ,CAAC,OAAO,CAAC,CAAC,EAAE,OAAO,oCAAoC;EACjH,OAAOJ,SAAS;AAClB;;AAEA;AACO,SAASQ,qBAAqBA,CAACV,IAAY,EAAEW,SAAiB,EAAQ;EAC3E,MAAMC,OAAO,GAAGX,kBAAkB,CAACD,IAAI,CAAC;EACxC,IAAI,CAACY,OAAO,EAAE;EACd,MAAM,KAAIC,oBAAQ,EAChB,gBAAgBF,SAAS,QAAQX,IAAI,6CAA6CY,OAAO,IAAI,GAC3F,gEACJ,CAAC;AACH;;AAEA;AACA;AACA;AACA;AACO,SAASE,uBAAuBA,CAACC,MAAc,EAAEJ,SAAiB,EAAQ;EAC/E,IAAI,CAACI,MAAM,EAAE;EACb,MAAMH,OAAO,GAAGX,kBAAkB,CAAC,GAAGc,MAAM,GAAG,CAAC;EAChD,IAAI,CAACH,OAAO,EAAE;EACd,MAAM,KAAIC,oBAAQ,EAChB,gBAAgBF,SAAS,QAAQI,MAAM,mDAAmDH,OAAO,IAAI,GACnG,gEACJ,CAAC;AACH;AA4BA;AACA;AACA;AACA;AACO,SAASI,iBAAiBA,CAACC,GAAkB,EAA0B;EAC5E,MAAMC,QAAgC,GAAG;IACvCC,YAAY,EAAEF,GAAG,EAAEE,YAAY,IAAI,EAAE;IACrCC,QAAQ,EAAEH,GAAG,EAAEG,QAAQ,IAAI,CAAC,CAAC;IAC7BC,KAAK,EAAEJ,GAAG,EAAEI,KAAK,IAAI,CAAC,GAAG,CAAC;IAC1BC,cAAc,EAAEL,GAAG,EAAEK,cAAc,IAAI,eAAe;IACtDC,mBAAmB,EAAEN,GAAG,EAAEM,mBAAmB,IAAI,KAAK;IACtDC,QAAQ,EAAEP,GAAG,EAAEO,QAAQ,IAAI,IAAI;IAC/BC,UAAU,EAAER,GAAG,EAAEQ,UAAU,IAAI;EACjC,CAAC;EACD;EACA;EACA,IAAIP,QAAQ,CAACM,QAAQ,KAAK,IAAI,IAAIN,QAAQ,CAACM,QAAQ,KAAK,aAAa,EAAE;IACrE,MAAM,KAAIX,oBAAQ,EAChB,mBAAmBK,QAAQ,CAACM,QAAQ,iEAAiE,GACnG,iGAAiG,GACjG,iBACJ,CAAC;EACH;EACA,IAAIN,QAAQ,CAACO,UAAU,KAAK,MAAM,IAAIP,QAAQ,CAACO,UAAU,KAAK,UAAU,IAAIP,QAAQ,CAACO,UAAU,KAAK,WAAW,EAAE;IAC/G,MAAM,KAAIZ,oBAAQ,EAChB,qBAAqBK,QAAQ,CAACO,UAAU,0DAA0D,GAChG,gGAAgG,GAChG,kFACJ,CAAC;EACH;EACAX,uBAAuB,CAACI,QAAQ,CAACC,YAAY,EAAE,mBAAmB,CAAC;EACnET,qBAAqB,CAACQ,QAAQ,CAACI,cAAc,EAAE,qBAAqB,CAAC;EACrEI,MAAM,CAACC,OAAO,CAACT,QAAQ,CAACE,QAAQ,CAAC,CAACQ,OAAO,CAAC,CAAC,CAACC,QAAQ,EAAEC,MAAM,CAAC,KAC3DpB,qBAAqB,CAACoB,MAAM,EAAE,kBAAkBD,QAAQ,IAAI,CAC9D,CAAC;EACD,OAAOX,QAAQ;AACjB;;AAEA;AACA;AACA;AACA;AACO,SAASa,gBAAgBA,CAACF,QAAgB,EAAEG,GAA2B,EAAU;EACtF,MAAMC,QAAQ,GAAGD,GAAG,CAACZ,QAAQ,CAACS,QAAQ,CAAC;EACvC,IAAII,QAAQ,EAAE,OAAOA,QAAQ,CAAC,CAAC;EAC/B,MAAMC,OAAO,GAAG,GAAGF,GAAG,CAACb,YAAY,GAAGU,QAAQ,EAAE;EAChDnB,qBAAqB,CAACwB,OAAO,EAAE,wBAAwBL,QAAQ,mCAAmC,CAAC;EACnG,OAAOK,OAAO;AAChB;AAEO,SAASC,gBAAgBA,CAACL,MAAc,EAAEE,GAA2B,EAAsB;EAChG,MAAMC,QAAQ,GAAGP,MAAM,CAACC,OAAO,CAACK,GAAG,CAACZ,QAAQ,CAAC,CAACgB,IAAI,CAAC,CAAC,GAAGC,CAAC,CAAC,KAAKA,CAAC,KAAKP,MAAM,CAAC;EAC3E,IAAIG,QAAQ,EAAE,OAAOA,QAAQ,CAAC,CAAC,CAAC;EAChC,IAAID,GAAG,CAACb,YAAY,EAAE;IACpB,OAAOW,MAAM,CAAC3B,UAAU,CAAC6B,GAAG,CAACb,YAAY,CAAC,GAAGW,MAAM,CAACQ,KAAK,CAACN,GAAG,CAACb,YAAY,CAACoB,MAAM,CAAC,GAAGrC,SAAS;EAChG;EACA,OAAO4B,MAAM;AACf;;AAEA;AACA;AACA;AACA;;AAQA;AACA;AACA;AACA;AACA;AACO,SAASU,eAAeA,CAACC,KAAa,EAAEC,YAAoB,EAAc;EAC/E,MAAMC,OAAO,GAAGF,KAAK,CAACG,IAAI,CAAC,CAAC;EAC5B,IAAI,CAACD,OAAO,EAAE,MAAM,KAAI9B,oBAAQ,EAAC,yCAAyC,CAAC;EAC3E,IAAI,CAAC8B,OAAO,CAACtC,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO;IAAEwC,SAAS,EAAEH,YAAY;IAAE1C,IAAI,EAAE2C;EAAQ,CAAC;EAC7E,MAAMG,KAAK,GAAGH,OAAO,CAACpC,KAAK,CAAC,GAAG,CAAC;EAChC,MAAM,CAACsC,SAAS,EAAE7C,IAAI,CAAC,GAAG8C,KAAK;EAC/B,IAAIA,KAAK,CAACP,MAAM,KAAK,CAAC,IAAI,CAACM,SAAS,IAAI,CAAC7C,IAAI,EAAE;IAC7C,MAAM,KAAIa,oBAAQ,EAChB,iBAAiB4B,KAAK,4EAA4E,GAChG,yCAAyCC,YAAY,kCAAkC,GACvF,iCACJ,CAAC;EACH;EACA,OAAO;IAAEG,SAAS;IAAE7C;EAAK,CAAC;AAC5B;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS+C,yBAAyBA,CAACjB,MAAc,EAAEE,GAA2B,EAAsB;EACzG,MAAMH,QAAQ,GAAGM,gBAAgB,CAACL,MAAM,EAAEE,GAAG,CAAC;EAC9C,IAAI,CAACH,QAAQ,IAAI,CAACmB,eAAe,CAACnB,QAAQ,CAAC,EAAE,OAAO3B,SAAS;EAC7D;EACA;EACA,IAAI8B,GAAG,CAACZ,QAAQ,CAACS,QAAQ,CAAC,EAAE,OAAOA,QAAQ;EAC3C,OAAO5B,kBAAkB,CAAC,GAAG+B,GAAG,CAACb,YAAY,GAAGU,QAAQ,EAAE,CAAC,KAAK3B,SAAS,GAAG2B,QAAQ,GAAG3B,SAAS;AAClG;;AAEA;AACA,MAAM+C,oBAAoB,GAAG,GAAG;;AAEhC;AACA;AACA;AACA;AACO,SAASD,eAAeA,CAAChD,IAAY,EAAW;EACrD,IAAI,CAACA,IAAI,IAAIA,IAAI,CAACuC,MAAM,GAAGU,oBAAoB,EAAE,OAAO,KAAK;EAC7D,OAAO,kBAAkB,CAAC7C,IAAI,CAACJ,IAAI,CAAC;AACtC;;AAEA;AACA,SAASkD,YAAYA,CAACC,IAAY,EAAU;EAC1C,MAAMC,OAAO,GAAGD,IAAI,CAACE,OAAO,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAACA,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC;EAC9E,OAAO,IAAIC,MAAM,CAAC,IAAIF,OAAO,GAAG,CAAC;AACnC;AAEO,SAASG,cAAcA,CAAC1B,QAAgB,EAAEG,GAA2B,EAAW;EACrF,OAAOA,GAAG,CAACX,KAAK,CAACb,IAAI,CAAEgD,OAAO,IAAKN,YAAY,CAACM,OAAO,CAAC,CAACpD,IAAI,CAACyB,QAAQ,CAAC,CAAC;AAC1E","ignoreList":[]}

package/dist/sync/sync-config.spec.d.ts

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

package/dist/sync/sync-config.spec.js

@@ -0,0 +1,254 @@
+"use strict";
+
+function _chai() {
+  const data = require("chai");
+  _chai = function () {
+    return data;
+  };
+  return data;
+}
+function _syncConfig() {
+  const data = require("./sync-config");
+  _syncConfig = function () {
+    return data;
+  };
+  return data;
+}
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+const DEFAULT_SCOPE = 'acme.shop';
+
+/** `refs/` in the middle is git-legal and no refspec here doubles it, so only a LEADING one is refused. */
+const VALID = ['main', 'bit-sync/main', 'lane/my-lane', 'feature/ABC-123_thing', 'release-2.0', 'a', 'feature/refs/foo', 'my-refs/foo', 'lane/refs', 'refs'];
+const INVALID = [
+// an option-like leading dash — git would read it as a command-line option
+'--force', '-delete',
+// characters and sequences git forbids in a ref, plus control characters
+'a b', 'a\tb', 'a..b', 'a~b', 'a^b', 'a:b', 'a?b', 'a*b', 'a[b', 'a\\b', 'a@{b', '@', 'a\u0001b', 'a\u007fb',
+// path-shape rules
+'', '/x', 'x/', 'a//b', 'a.', 'a.lock', '.hidden', 'a/.hidden', 'a/b.lock',
+// stricter than git on purpose: every push interpolates the value into `refs/heads/<b>`
+'refs/heads/foo', 'refs/foo', 'refs/remotes/origin/foo'];
+describe('isValidGitBranchName', () => {
+  it('accepts the shapes real configs use', () => {
+    VALID.forEach(name => (0, _chai().expect)((0, _syncConfig().isValidGitBranchName)(name), name).to.equal(true));
+  });
+  it('rejects every shape git would refuse, plus the two this module is stricter about', () => {
+    INVALID.forEach(name => (0, _chai().expect)((0, _syncConfig().isValidGitBranchName)(name), JSON.stringify(name)).to.equal(false));
+  });
+  it('says what is wrong in the terms the user has to act on', () => {
+    (0, _chai().expect)((0, _syncConfig().validateBranchName)('-x')).to.contain('command-line option');
+    (0, _chai().expect)((0, _syncConfig().validateBranchName)('refs/heads/main')).to.contain('bare branch name');
+  });
+});
+describe('assertValidBranchName', () => {
+  it('names the offending config key and value, so the message points at the line to fix', () => {
+    let message = '';
+    try {
+      (0, _syncConfig().assertValidBranchName)('--force', 'sync.branches["my-lane"]');
+    } catch (err) {
+      message = err.message;
+    }
+    (0, _chai().expect)(message).to.contain('sync.branches["my-lane"]');
+    (0, _chai().expect)(message).to.contain('--force');
+    (0, _chai().expect)(message).to.contain('workspace.jsonc');
+    (0, _chai().expect)(() => (0, _syncConfig().assertValidBranchName)('bit-sync/main', 'sync.mainSyncBranch')).to.not.throw();
+  });
+});
+describe('assertValidBranchPrefix', () => {
+  it('accepts an empty prefix (the default) and ordinary directory-ish prefixes', () => {
+    ['', 'lane/', 'bit-'].forEach(prefix => (0, _chai().expect)(() => (0, _syncConfig().assertValidBranchPrefix)(prefix, 'sync.branchPrefix'), prefix).to.not.throw());
+  });
+  it('rejects a prefix that could never start a valid name', () => {
+    // 'lane//' — an empty path component in the prefix must not be collapsed away by the check
+    ['-x', 'a b/', 'a..b/', 'lane//'].forEach(prefix => (0, _chai().expect)(() => (0, _syncConfig().assertValidBranchPrefix)(prefix, 'sync.branchPrefix'), prefix).to.throw('sync.branchPrefix'));
+  });
+});
+describe('resolveSyncConfig validates branch names up front', () => {
+  /** A bad name must fail at startup naming its config key, not mid-run with git's own ref error. */
+  const rejected = [['sync.mainSyncBranch', {
+    mainSyncBranch: '--force'
+  }],
+  // a fully-qualified ref where a bare branch name belongs
+  ['sync.mainSyncBranch', {
+    mainSyncBranch: 'refs/heads/bit-sync/main'
+  }], ['sync.branches["my-lane"]', {
+    branches: {
+      'my-lane': 'a..b'
+    }
+  }], ['sync.branchPrefix', {
+    branchPrefix: '-x'
+  }],
+  // a `refs/`-rooted prefix double-prefixes every derived branch, not just one configured name
+  ['sync.branchPrefix', {
+    branchPrefix: 'refs/heads/'
+  }]];
+  rejected.forEach(([key, raw]) => {
+    it(`rejects ${JSON.stringify(raw)} naming ${key}`, () => {
+      (0, _chai().expect)(() => (0, _syncConfig().resolveSyncConfig)(raw)).to.throw(key);
+    });
+  });
+  it('accepts the documented defaults unchanged', () => {
+    const cfg = (0, _syncConfig().resolveSyncConfig)();
+    (0, _chai().expect)(cfg.mainSyncBranch).to.equal('bit-sync/main');
+    (0, _chai().expect)(cfg.branchPrefix).to.equal('');
+  });
+});
+describe('laneNameToBranch validates the derived name', () => {
+  it('catches a prefix + lane name that only together form something git refuses', () => {
+    // `lane/` is a fine prefix on its own; appending a lane name ending the branch in "." is not.
+    const cfg = (0, _syncConfig().resolveSyncConfig)({
+      branchPrefix: 'lane/'
+    });
+    (0, _chai().expect)(() => (0, _syncConfig().laneNameToBranch)('x.', cfg)).to.throw('not a valid git branch name');
+    (0, _chai().expect)((0, _syncConfig().laneNameToBranch)('my-lane', cfg)).to.equal('lane/my-lane');
+  });
+  it('returns an override as configured (already validated by resolveSyncConfig)', () => {
+    (0, _chai().expect)((0, _syncConfig().laneNameToBranch)('my-lane', (0, _syncConfig().resolveSyncConfig)({
+      branches: {
+        'my-lane': 'custom/branch'
+      }
+    }))).to.equal('custom/branch');
+  });
+});
+describe('sync-config', () => {
+  it('applies defaults', () => {
+    (0, _chai().expect)((0, _syncConfig().resolveSyncConfig)(undefined)).to.deep.equal({
+      branchPrefix: '',
+      branches: {},
+      lanes: ['*'],
+      mainSyncBranch: 'bit-sync/main',
+      autoMergeMainSyncPr: false,
+      mainSync: 'pr',
+      // a silent policy pick rewrites someone's work, so silence is opt-in
+      onConflict: 'halt'
+    });
+  });
+  it('accepts every documented value of the union-typed options', () => {
+    ['pr', 'direct-push'].forEach(v => (0, _chai().expect)((0, _syncConfig().resolveSyncConfig)({
+      mainSync: v
+    }).mainSync).to.equal(v));
+    ['halt', 'git-wins', 'lane-wins'].forEach(v => (0, _chai().expect)((0, _syncConfig().resolveSyncConfig)({
+      onConflict: v
+    }).onConflict).to.equal(v));
+  });
+
+  // Config comes from workspace.jsonc, so the union types are not enforced at runtime: a typo must fail
+  // at startup naming the key, the value and the options, not fall through to whichever mode a
+  // comparison happens to miss.
+  const REJECTED = [[{
+    mainSync: 'direct'
+  }, /sync\.mainSync.*"direct".*"pr".*"direct-push"/], [{
+    onConflict: 'ours'
+  }, /sync\.onConflict.*"ours".*"halt".*"git-wins".*"lane-wins"/]];
+  REJECTED.forEach(([raw, expected]) => {
+    it(`refuses ${JSON.stringify(raw)}, naming the key, the value and the valid options`, () => {
+      (0, _chai().expect)(() => (0, _syncConfig().resolveSyncConfig)(raw)).to.throw(expected);
+    });
+  });
+  it('maps lane <-> branch: an explicit override outranks the prefix in both directions', () => {
+    const cfg = (0, _syncConfig().resolveSyncConfig)({
+      branchPrefix: 'lane/',
+      branches: {
+        'my-lane': 'custom'
+      }
+    });
+    (0, _chai().expect)((0, _syncConfig().laneNameToBranch)('my-lane', cfg)).to.equal('custom');
+    (0, _chai().expect)((0, _syncConfig().branchToLaneName)('custom', cfg)).to.equal('my-lane');
+    (0, _chai().expect)((0, _syncConfig().branchToLaneName)('lane/other', cfg)).to.equal('other');
+    (0, _chai().expect)((0, _syncConfig().branchToLaneName)('unrelated-branch', cfg)).to.equal(undefined);
+    // with no prefix and no override, a branch maps to the same-named lane
+    (0, _chai().expect)((0, _syncConfig().branchToLaneName)('some-lane', (0, _syncConfig().resolveSyncConfig)({}))).to.equal('some-lane');
+  });
+  describe('parseLaneTarget', () => {
+    // A lane name cannot contain '/', so the single '/' is always the scope/name boundary; a hosting
+    // scope needs no dot (self-hosted and test scopes are bare names).
+    const PARSED = [['my-lane', {
+      hostScope: DEFAULT_SCOPE,
+      name: 'my-lane'
+    }], ['other-org.other-scope/my-lane', {
+      hostScope: 'other-org.other-scope',
+      name: 'my-lane'
+    }], ['bare-scope/my-lane', {
+      hostScope: 'bare-scope',
+      name: 'my-lane'
+    }], ['  my-lane  ', {
+      hostScope: DEFAULT_SCOPE,
+      name: 'my-lane'
+    }]];
+    it('resolves a bare name against defaultScope and splits a scope-qualified id', () => {
+      PARSED.forEach(([input, expected]) => (0, _chai().expect)((0, _syncConfig().parseLaneTarget)(input, DEFAULT_SCOPE), input).to.deep.equal(expected));
+    });
+    it('refuses malformed targets rather than guessing at them', () => {
+      ['', '   ', '/', '/my-lane', 'scope/', 'a/b/c', 'scope//lane'].forEach(input => (0, _chai().expect)(() => (0, _syncConfig().parseLaneTarget)(input, DEFAULT_SCOPE), `input: "${input}"`).to.throw());
+    });
+  });
+  it('filters lanes by glob list', () => {
+    (0, _chai().expect)((0, _syncConfig().shouldSyncLane)('anything', (0, _syncConfig().resolveSyncConfig)({}))).to.equal(true);
+    const cfg = (0, _syncConfig().resolveSyncConfig)({
+      lanes: ['feature-*']
+    });
+    (0, _chai().expect)((0, _syncConfig().shouldSyncLane)('feature-x', cfg)).to.equal(true);
+    (0, _chai().expect)((0, _syncConfig().shouldSyncLane)('hotfix-y', cfg)).to.equal(false);
+    (0, _chai().expect)((0, _syncConfig().shouldSyncLane)('anything', (0, _syncConfig().resolveSyncConfig)({
+      lanes: []
+    }))).to.equal(false);
+  });
+});
+
+// Pins bit's own rule (create-lane.ts), which this module re-states rather than imports.
+describe('isValidLaneName', () => {
+  it('accepts what bit accepts: lowercase alphanumerics plus - _ $ !', () => {
+    ['my-lane', 'lane_1', 'a', 'x$y', 'w!', 'release-2'].forEach(name => (0, _chai().expect)((0, _syncConfig().isValidLaneName)(name), name).to.equal(true));
+  });
+  it('rejects uppercase, spaces, dots, the empty string, and the slash a branch name brings in', () => {
+    ['FEATURE', 'Feature', 'a b', 'a.b', '', 'a+b', 'café', 'feature/foo', 'a/b/c'].forEach(name => (0, _chai().expect)((0, _syncConfig().isValidLaneName)(name), JSON.stringify(name)).to.equal(false));
+  });
+  it("rejects a name past bit's length limit", () => {
+    (0, _chai().expect)((0, _syncConfig().isValidLaneName)('a'.repeat(800))).to.equal(true);
+    (0, _chai().expect)((0, _syncConfig().isValidLaneName)('a'.repeat(801))).to.equal(false);
+  });
+});
+
+/**
+ * `--all` maps every remote branch through here; anything it returns becomes a sync target whose branch
+ * name is then derived and validated. So the two directions must agree, or an ordinary developer branch
+ * halts the run instead of being skipped.
+ */
+describe('syncableLaneNameForBranch round-trips lane and branch validity', () => {
+  const cfg = (raw = {}) => (0, _syncConfig().resolveSyncConfig)(_objectSpread({
+    lanes: ['*']
+  }, raw));
+  it('maps an ordinary branch to its lane name', () => {
+    (0, _chai().expect)((0, _syncConfig().syncableLaneNameForBranch)('my-lane', cfg())).to.equal('my-lane');
+  });
+  it('skips a branch whose mapped lane name is valid as a LANE but not usable as a BRANCH', () => {
+    // the lane grammar permits `-`, so `-x` is a legal lane name — but git reads it as an option, and
+    // `laneNameToBranch` asserts on it. Enumeration must skip such a branch, not adopt it as a target.
+    (0, _chai().expect)((0, _syncConfig().isValidLaneName)('-x')).to.equal(true);
+    (0, _chai().expect)((0, _syncConfig().syncableLaneNameForBranch)('-x', cfg())).to.equal(undefined);
+    (0, _chai().expect)((0, _syncConfig().syncableLaneNameForBranch)('--force', cfg())).to.equal(undefined);
+  });
+  it('skips a branch whose name bit forbids as a lane', () => {
+    (0, _chai().expect)((0, _syncConfig().syncableLaneNameForBranch)('feature/foo', cfg())).to.equal(undefined);
+  });
+  it('honours a configured override, which resolveSyncConfig already validated', () => {
+    (0, _chai().expect)((0, _syncConfig().syncableLaneNameForBranch)('release/x', cfg({
+      branches: {
+        'lane-x': 'release/x'
+      }
+    }))).to.equal('lane-x');
+  });
+  it('applies the round trip through a configured prefix too', () => {
+    const prefixed = cfg({
+      branchPrefix: 'bit-sync/'
+    });
+    (0, _chai().expect)((0, _syncConfig().syncableLaneNameForBranch)('bit-sync/my-lane', prefixed)).to.equal('my-lane');
+    (0, _chai().expect)((0, _syncConfig().syncableLaneNameForBranch)('my-lane', prefixed)).to.equal(undefined);
+  });
+});
+
+//# sourceMappingURL=sync-config.spec.js.map

package/dist/sync/sync-config.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_chai","data","require","_syncConfig","ownKeys","e","r","t","Object","keys","getOwnPropertySymbols","o","filter","getOwnPropertyDescriptor","enumerable","push","apply","_objectSpread","arguments","length","forEach","_defineProperty","getOwnPropertyDescriptors","defineProperties","defineProperty","_toPropertyKey","value","configurable","writable","i","_toPrimitive","Symbol","toPrimitive","call","TypeError","String","Number","DEFAULT_SCOPE","VALID","INVALID","describe","it","name","expect","isValidGitBranchName","to","equal","JSON","stringify","validateBranchName","contain","message","assertValidBranchName","err","not","throw","prefix","assertValidBranchPrefix","rejected","mainSyncBranch","branches","branchPrefix","key","raw","resolveSyncConfig","cfg","laneNameToBranch","undefined","deep","lanes","autoMergeMainSyncPr","mainSync","onConflict","v","REJECTED","expected","branchToLaneName","PARSED","hostScope","input","parseLaneTarget","shouldSyncLane","isValidLaneName","repeat","syncableLaneNameForBranch","prefixed"],"sources":["sync-config.spec.ts"],"sourcesContent":["import { expect } from 'chai';\nimport type { CiSyncConfig, LaneTarget } from './sync-config';\nimport {\n  syncableLaneNameForBranch,\n  assertValidBranchName,\n  assertValidBranchPrefix,\n  isValidGitBranchName,\n  validateBranchName,\n  resolveSyncConfig,\n  laneNameToBranch,\n  branchToLaneName,\n  isValidLaneName,\n  parseLaneTarget,\n  shouldSyncLane,\n} from './sync-config';\n\nconst DEFAULT_SCOPE = 'acme.shop';\n\n/** `refs/` in the middle is git-legal and no refspec here doubles it, so only a LEADING one is refused. */\nconst VALID = [\n  'main',\n  'bit-sync/main',\n  'lane/my-lane',\n  'feature/ABC-123_thing',\n  'release-2.0',\n  'a',\n  'feature/refs/foo',\n  'my-refs/foo',\n  'lane/refs',\n  'refs',\n];\n\nconst INVALID = [\n  // an option-like leading dash — git would read it as a command-line option\n  '--force',\n  '-delete',\n  // characters and sequences git forbids in a ref, plus control characters\n  'a b',\n  'a\\tb',\n  'a..b',\n  'a~b',\n  'a^b',\n  'a:b',\n  'a?b',\n  'a*b',\n  'a[b',\n  'a\\\\b',\n  'a@{b',\n  '@',\n  'a\\u0001b',\n  'a\\u007fb',\n  // path-shape rules\n  '',\n  '/x',\n  'x/',\n  'a//b',\n  'a.',\n  'a.lock',\n  '.hidden',\n  'a/.hidden',\n  'a/b.lock',\n  // stricter than git on purpose: every push interpolates the value into `refs/heads/<b>`\n  'refs/heads/foo',\n  'refs/foo',\n  'refs/remotes/origin/foo',\n];\n\ndescribe('isValidGitBranchName', () => {\n  it('accepts the shapes real configs use', () => {\n    VALID.forEach((name) => expect(isValidGitBranchName(name), name).to.equal(true));\n  });\n\n  it('rejects every shape git would refuse, plus the two this module is stricter about', () => {\n    INVALID.forEach((name) => expect(isValidGitBranchName(name), JSON.stringify(name)).to.equal(false));\n  });\n\n  it('says what is wrong in the terms the user has to act on', () => {\n    expect(validateBranchName('-x')).to.contain('command-line option');\n    expect(validateBranchName('refs/heads/main')).to.contain('bare branch name');\n  });\n});\n\ndescribe('assertValidBranchName', () => {\n  it('names the offending config key and value, so the message points at the line to fix', () => {\n    let message = '';\n    try {\n      assertValidBranchName('--force', 'sync.branches[\"my-lane\"]');\n    } catch (err: any) {\n      message = err.message;\n    }\n    expect(message).to.contain('sync.branches[\"my-lane\"]');\n    expect(message).to.contain('--force');\n    expect(message).to.contain('workspace.jsonc');\n    expect(() => assertValidBranchName('bit-sync/main', 'sync.mainSyncBranch')).to.not.throw();\n  });\n});\n\ndescribe('assertValidBranchPrefix', () => {\n  it('accepts an empty prefix (the default) and ordinary directory-ish prefixes', () => {\n    ['', 'lane/', 'bit-'].forEach((prefix) =>\n      expect(() => assertValidBranchPrefix(prefix, 'sync.branchPrefix'), prefix).to.not.throw()\n    );\n  });\n\n  it('rejects a prefix that could never start a valid name', () => {\n    // 'lane//' — an empty path component in the prefix must not be collapsed away by the check\n    ['-x', 'a b/', 'a..b/', 'lane//'].forEach((prefix) =>\n      expect(() => assertValidBranchPrefix(prefix, 'sync.branchPrefix'), prefix).to.throw('sync.branchPrefix')\n    );\n  });\n});\n\ndescribe('resolveSyncConfig validates branch names up front', () => {\n  /** A bad name must fail at startup naming its config key, not mid-run with git's own ref error. */\n  const rejected: Array<[string, Parameters<typeof resolveSyncConfig>[0]]> = [\n    ['sync.mainSyncBranch', { mainSyncBranch: '--force' }],\n    // a fully-qualified ref where a bare branch name belongs\n    ['sync.mainSyncBranch', { mainSyncBranch: 'refs/heads/bit-sync/main' }],\n    ['sync.branches[\"my-lane\"]', { branches: { 'my-lane': 'a..b' } }],\n    ['sync.branchPrefix', { branchPrefix: '-x' }],\n    // a `refs/`-rooted prefix double-prefixes every derived branch, not just one configured name\n    ['sync.branchPrefix', { branchPrefix: 'refs/heads/' }],\n  ];\n\n  rejected.forEach(([key, raw]) => {\n    it(`rejects ${JSON.stringify(raw)} naming ${key}`, () => {\n      expect(() => resolveSyncConfig(raw)).to.throw(key);\n    });\n  });\n\n  it('accepts the documented defaults unchanged', () => {\n    const cfg = resolveSyncConfig();\n    expect(cfg.mainSyncBranch).to.equal('bit-sync/main');\n    expect(cfg.branchPrefix).to.equal('');\n  });\n});\n\ndescribe('laneNameToBranch validates the derived name', () => {\n  it('catches a prefix + lane name that only together form something git refuses', () => {\n    // `lane/` is a fine prefix on its own; appending a lane name ending the branch in \".\" is not.\n    const cfg = resolveSyncConfig({ branchPrefix: 'lane/' });\n    expect(() => laneNameToBranch('x.', cfg)).to.throw('not a valid git branch name');\n    expect(laneNameToBranch('my-lane', cfg)).to.equal('lane/my-lane');\n  });\n\n  it('returns an override as configured (already validated by resolveSyncConfig)', () => {\n    expect(laneNameToBranch('my-lane', resolveSyncConfig({ branches: { 'my-lane': 'custom/branch' } }))).to.equal(\n      'custom/branch'\n    );\n  });\n});\n\ndescribe('sync-config', () => {\n  it('applies defaults', () => {\n    expect(resolveSyncConfig(undefined)).to.deep.equal({\n      branchPrefix: '',\n      branches: {},\n      lanes: ['*'],\n      mainSyncBranch: 'bit-sync/main',\n      autoMergeMainSyncPr: false,\n      mainSync: 'pr',\n      // a silent policy pick rewrites someone's work, so silence is opt-in\n      onConflict: 'halt',\n    });\n  });\n\n  it('accepts every documented value of the union-typed options', () => {\n    (['pr', 'direct-push'] as const).forEach((v) => expect(resolveSyncConfig({ mainSync: v }).mainSync).to.equal(v));\n    (['halt', 'git-wins', 'lane-wins'] as const).forEach((v) =>\n      expect(resolveSyncConfig({ onConflict: v }).onConflict).to.equal(v)\n    );\n  });\n\n  // Config comes from workspace.jsonc, so the union types are not enforced at runtime: a typo must fail\n  // at startup naming the key, the value and the options, not fall through to whichever mode a\n  // comparison happens to miss.\n  const REJECTED: Array<[CiSyncConfig, RegExp]> = [\n    [{ mainSync: 'direct' as any }, /sync\\.mainSync.*\"direct\".*\"pr\".*\"direct-push\"/],\n    [{ onConflict: 'ours' as any }, /sync\\.onConflict.*\"ours\".*\"halt\".*\"git-wins\".*\"lane-wins\"/],\n  ];\n\n  REJECTED.forEach(([raw, expected]) => {\n    it(`refuses ${JSON.stringify(raw)}, naming the key, the value and the valid options`, () => {\n      expect(() => resolveSyncConfig(raw)).to.throw(expected);\n    });\n  });\n\n  it('maps lane <-> branch: an explicit override outranks the prefix in both directions', () => {\n    const cfg = resolveSyncConfig({ branchPrefix: 'lane/', branches: { 'my-lane': 'custom' } });\n    expect(laneNameToBranch('my-lane', cfg)).to.equal('custom');\n    expect(branchToLaneName('custom', cfg)).to.equal('my-lane');\n    expect(branchToLaneName('lane/other', cfg)).to.equal('other');\n    expect(branchToLaneName('unrelated-branch', cfg)).to.equal(undefined);\n    // with no prefix and no override, a branch maps to the same-named lane\n    expect(branchToLaneName('some-lane', resolveSyncConfig({}))).to.equal('some-lane');\n  });\n\n  describe('parseLaneTarget', () => {\n    // A lane name cannot contain '/', so the single '/' is always the scope/name boundary; a hosting\n    // scope needs no dot (self-hosted and test scopes are bare names).\n    const PARSED: Array<[string, LaneTarget]> = [\n      ['my-lane', { hostScope: DEFAULT_SCOPE, name: 'my-lane' }],\n      ['other-org.other-scope/my-lane', { hostScope: 'other-org.other-scope', name: 'my-lane' }],\n      ['bare-scope/my-lane', { hostScope: 'bare-scope', name: 'my-lane' }],\n      ['  my-lane  ', { hostScope: DEFAULT_SCOPE, name: 'my-lane' }],\n    ];\n\n    it('resolves a bare name against defaultScope and splits a scope-qualified id', () => {\n      PARSED.forEach(([input, expected]) =>\n        expect(parseLaneTarget(input, DEFAULT_SCOPE), input).to.deep.equal(expected)\n      );\n    });\n\n    it('refuses malformed targets rather than guessing at them', () => {\n      ['', '   ', '/', '/my-lane', 'scope/', 'a/b/c', 'scope//lane'].forEach((input) =>\n        expect(() => parseLaneTarget(input, DEFAULT_SCOPE), `input: \"${input}\"`).to.throw()\n      );\n    });\n  });\n\n  it('filters lanes by glob list', () => {\n    expect(shouldSyncLane('anything', resolveSyncConfig({}))).to.equal(true);\n    const cfg = resolveSyncConfig({ lanes: ['feature-*'] });\n    expect(shouldSyncLane('feature-x', cfg)).to.equal(true);\n    expect(shouldSyncLane('hotfix-y', cfg)).to.equal(false);\n    expect(shouldSyncLane('anything', resolveSyncConfig({ lanes: [] }))).to.equal(false);\n  });\n});\n\n// Pins bit's own rule (create-lane.ts), which this module re-states rather than imports.\ndescribe('isValidLaneName', () => {\n  it('accepts what bit accepts: lowercase alphanumerics plus - _ $ !', () => {\n    ['my-lane', 'lane_1', 'a', 'x$y', 'w!', 'release-2'].forEach((name) =>\n      expect(isValidLaneName(name), name).to.equal(true)\n    );\n  });\n\n  it('rejects uppercase, spaces, dots, the empty string, and the slash a branch name brings in', () => {\n    ['FEATURE', 'Feature', 'a b', 'a.b', '', 'a+b', 'café', 'feature/foo', 'a/b/c'].forEach((name) =>\n      expect(isValidLaneName(name), JSON.stringify(name)).to.equal(false)\n    );\n  });\n\n  it(\"rejects a name past bit's length limit\", () => {\n    expect(isValidLaneName('a'.repeat(800))).to.equal(true);\n    expect(isValidLaneName('a'.repeat(801))).to.equal(false);\n  });\n});\n\n/**\n * `--all` maps every remote branch through here; anything it returns becomes a sync target whose branch\n * name is then derived and validated. So the two directions must agree, or an ordinary developer branch\n * halts the run instead of being skipped.\n */\ndescribe('syncableLaneNameForBranch round-trips lane and branch validity', () => {\n  const cfg = (raw: CiSyncConfig = {}) => resolveSyncConfig({ lanes: ['*'], ...raw });\n\n  it('maps an ordinary branch to its lane name', () => {\n    expect(syncableLaneNameForBranch('my-lane', cfg())).to.equal('my-lane');\n  });\n\n  it('skips a branch whose mapped lane name is valid as a LANE but not usable as a BRANCH', () => {\n    // the lane grammar permits `-`, so `-x` is a legal lane name — but git reads it as an option, and\n    // `laneNameToBranch` asserts on it. Enumeration must skip such a branch, not adopt it as a target.\n    expect(isValidLaneName('-x')).to.equal(true);\n    expect(syncableLaneNameForBranch('-x', cfg())).to.equal(undefined);\n    expect(syncableLaneNameForBranch('--force', cfg())).to.equal(undefined);\n  });\n\n  it('skips a branch whose name bit forbids as a lane', () => {\n    expect(syncableLaneNameForBranch('feature/foo', cfg())).to.equal(undefined);\n  });\n\n  it('honours a configured override, which resolveSyncConfig already validated', () => {\n    expect(syncableLaneNameForBranch('release/x', cfg({ branches: { 'lane-x': 'release/x' } }))).to.equal('lane-x');\n  });\n\n  it('applies the round trip through a configured prefix too', () => {\n    const prefixed = cfg({ branchPrefix: 'bit-sync/' });\n    expect(syncableLaneNameForBranch('bit-sync/my-lane', prefixed)).to.equal('my-lane');\n    expect(syncableLaneNameForBranch('my-lane', prefixed)).to.equal(undefined);\n  });\n});\n"],"mappings":"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","ignoreList":[]}

package/dist/sync/sync-orchestrator.d.ts

@@ -0,0 +1,76 @@
+import type { Logger } from '@teambit/logger';
+import type { Workspace } from '@teambit/workspace';
+import type { LanesMain } from '@teambit/lanes';
+import type { CheckoutMain } from '@teambit/checkout';
+import type { CiMain, CiWorkspaceConfig } from '../ci.main.runtime';
+/**
+ * Refuse a `--dry-run` whose plan would be computed by force-checking-out branches over uncommitted
+ * work: the main-scope drift is a diff, so the tree IS written before the dry-run return. A dry run
+ * promises to write nothing, so it may not discard either — with a clean tree the write-then-restore
+ * loses nothing.
+ */
+export declare function assertCleanForDryRun(dirtyFiles: string[]): void;
+/** Everything the sync orchestration needs from `CiMain`, passed explicitly. */
+export type SyncOrchestratorDeps = {
+    ci: CiMain;
+    workspace: Workspace;
+    logger: Logger;
+    lanes: LanesMain;
+    checkout: CheckoutMain;
+    config: CiWorkspaceConfig;
+};
+/**
+ * Routing and aggregation for `bit ci sync`: decides which targets a run visits and how their
+ * summaries combine. What reconciling a target means lives in the two executors, both stateless and
+ * idempotent, so the trigger only ever decides when the reconciler runs.
+ */
+export declare class SyncOrchestrator {
+    private deps;
+    constructor(deps: SyncOrchestratorDeps);
+    /**
+     * `bit ci sync` — reconcile Bit lanes and the main scope with git branches and pull requests.
+     * Returns the per-target summary lines; throws the joined summary after the loop when any target
+     * halted or was refused, so CI exits non-zero while every other target was still attempted. A skip
+     * is neither — it reports itself and leaves the run green.
+     */
+    sync(opts?: {
+        lane?: string;
+        branch?: string;
+        all?: boolean;
+        main?: boolean;
+        dryRun?: boolean;
+        init?: boolean;
+    }): Promise<string>;
+    /**
+     * `bit ci sync --init` — one-command onboarding: scaffolds the two workflow files, adds the sync
+     * config block to workspace.jsonc if missing, and prints the manual-steps checklist. Safe to
+     * re-run: existing files are skipped, an existing config block is left alone; it never reconciles.
+     */
+    private syncInit;
+    /**
+     * Add `"sync": {}` under `"teambit.git/ci"` in workspace.jsonc if that key isn't there yet; returns
+     * whether it wrote. The comment-preserving `WorkspaceConfig` API merges into existing
+     * `teambit.git/ci` config rather than clobbering it.
+     */
+    private ensureSyncConfigBlock;
+    /**
+     * Why this lane name must not be handed to the lane executor, or undefined when it's syncable. The
+     * mapped branch is checked too — the lane path must never write the two branches the main-scope
+     * path owns.
+     */
+    private laneNotSyncableReason;
+    /**
+     * The lane names to reconcile on an `--all` run (sorted), plus one HALTED line per enumeration
+     * failure. The list is the union of the remote's lanes AND the lane-mapped branches on `origin` —
+     * a lane deleted on bit.cloud is gone from the first source, and only the branch side can make
+     * `close-pr` fire for it. An enumeration failure is reported rather than thrown, so the half that
+     * did enumerate is still reconciled while the run exits non-zero.
+     */
+    private listLanesToSync;
+    /**
+     * Join the per-target summary lines, and turn any halt into a non-zero exit — the executors never
+     * throw, so this is the single place "needs a human" becomes visible to CI. `BitError` rather than
+     * `Error`: bit reports a plain `Error` as an internal failure (stack trace, Sentry FATAL).
+     */
+    private summarizeSync;
+}