@shipstatic/types 2.8.0 → 2.9.0-beta.2

package/dist/index.d.ts

@@ -13,25 +13,74 @@ export declare const DeploymentStatus: {
 };
 export type DeploymentStatusType = (typeof DeploymentStatus)[keyof typeof DeploymentStatus];
 /**
- * Which client made a deployment — the origin-tracking vocabulary.
- *
- * A closed set with many authors: the CLI, the SDK, the dashboard, both MCP
- * transports, the GitHub Action, the n8n node and the VS Code extension each
- * name themselves here. It lived in the API's config until 2026-08-06, where
- * being server-side made it unenforceable in the one direction that matters —
- * every client wrote a bare string, and a value outside the set was **silently
- * dropped** by the server, so a typo did not fail anywhere. It stopped
- * recording where deploys came from and said nothing.
+ * Where a deployment came from — the origin-tracking vocabulary.
+ *
+ * A closed set with many authors. It lived in the API's config until
+ * 2026-08-06, where being server-side made it unenforceable in the one
+ * direction that matters — every client wrote a bare string, and a value
+ * outside the set was **silently dropped** by the server, so a typo did not
+ * fail anywhere. It stopped recording where deploys came from and said nothing.
+ *
+ * **The origin law: origin is declared by whatever we control — our code where
+ * we ship code, our URL where we ship only a URL.** One rule decides every
+ * member here and every future one:
+ *
+ * - **Where the platform ships CODE, the code declares it.** `web`, `sdk`,
+ *   `cli`, `git`, `n8n` and `vsc` are surfaces this platform authors, so each
+ *   names itself in its own source and nothing external is needed to tell them
+ *   apart.
+ * - **Where the platform ships only a URL, the URL declares it.** A
+ *   marketplace listing runs somebody else's client against a bare endpoint —
+ *   every one of them the same server speaking the same protocol, and
+ *   indistinguishable in a request. The only thing such a listing's traffic
+ *   has in common is the URL its users were handed, so the hosted MCP serves
+ *   one DOOR per listing and the door's path IS the value: `gpt`, `cld`,
+ *   `crs`.
+ *
+ * **A member names the most specific surface the platform can honestly
+ * claim**, which is what makes the two FALLBACKS fallbacks rather than peers
+ * of the named surfaces. `mcp` is any MCP host that was never handed a door of
+ * its own; `api` is a call that reached the REST API naming nothing at all.
+ * Guessing past either would be inventing attribution rather than recording
+ * it, which is the one thing this vocabulary exists to prevent.
+ *
+ * Every member is three lowercase characters — the property that lets a
+ * channel door's path and its attribution be spelled the same. The suite pins
+ * both the width and the channel members by name.
  */
 export declare const DeploymentVia: {
+    /** The web dashboard. */
     readonly WEB: "web";
+    /** A program embedding the SDK directly. */
     readonly SDK: "sdk";
+    /** The `ship` CLI. */
     readonly CLI: "cli";
+    /** Any MCP host with no door of its own — the stdio server included. The family fallback. */
     readonly MCP: "mcp";
+    /** The GitHub Action. */
     readonly GIT: "git";
+    /** The n8n community node. */
     readonly N8N: "n8n";
+    /** Channel: the ChatGPT App listing → `mcp.<domain>/gpt`. */
     readonly GPT: "gpt";
+    /** The VS Code extension. */
     readonly VSC: "vsc";
+    /** Channel: the Claude connectors directory listing → `mcp.<domain>/cld`. */
+    readonly CLD: "cld";
+    /** Channel: the Cursor marketplace listing → `mcp.<domain>/crs`. */
+    readonly CRS: "crs";
+    /**
+     * A deploy that reached the REST API naming no origin at all — the
+     * platform-wide fallback, one altitude below `mcp`'s family fallback.
+     *
+     * **Declared ahead of its emitter, deliberately.** Nothing sends it yet and
+     * the server still records an unattributed deploy as `null`. Vocabulary must
+     * exist before a consumer can adopt it, and adding a member costs a full
+     * constellation convoy — so the word ships first and the API adopts it as a
+     * default whenever that decision is taken, with no convoy standing between
+     * the decision and the deploy.
+     */
+    readonly API: "api";
 };
 export type DeploymentViaType = (typeof DeploymentVia)[keyof typeof DeploymentVia];
 /**

package/dist/index.js

@@ -15,25 +15,74 @@ export const DeploymentStatus = {
     DELETING: 'deleting',
 };
 /**
- * Which client made a deployment — the origin-tracking vocabulary.
- *
- * A closed set with many authors: the CLI, the SDK, the dashboard, both MCP
- * transports, the GitHub Action, the n8n node and the VS Code extension each
- * name themselves here. It lived in the API's config until 2026-08-06, where
- * being server-side made it unenforceable in the one direction that matters —
- * every client wrote a bare string, and a value outside the set was **silently
- * dropped** by the server, so a typo did not fail anywhere. It stopped
- * recording where deploys came from and said nothing.
+ * Where a deployment came from — the origin-tracking vocabulary.
+ *
+ * A closed set with many authors. It lived in the API's config until
+ * 2026-08-06, where being server-side made it unenforceable in the one
+ * direction that matters — every client wrote a bare string, and a value
+ * outside the set was **silently dropped** by the server, so a typo did not
+ * fail anywhere. It stopped recording where deploys came from and said nothing.
+ *
+ * **The origin law: origin is declared by whatever we control — our code where
+ * we ship code, our URL where we ship only a URL.** One rule decides every
+ * member here and every future one:
+ *
+ * - **Where the platform ships CODE, the code declares it.** `web`, `sdk`,
+ *   `cli`, `git`, `n8n` and `vsc` are surfaces this platform authors, so each
+ *   names itself in its own source and nothing external is needed to tell them
+ *   apart.
+ * - **Where the platform ships only a URL, the URL declares it.** A
+ *   marketplace listing runs somebody else's client against a bare endpoint —
+ *   every one of them the same server speaking the same protocol, and
+ *   indistinguishable in a request. The only thing such a listing's traffic
+ *   has in common is the URL its users were handed, so the hosted MCP serves
+ *   one DOOR per listing and the door's path IS the value: `gpt`, `cld`,
+ *   `crs`.
+ *
+ * **A member names the most specific surface the platform can honestly
+ * claim**, which is what makes the two FALLBACKS fallbacks rather than peers
+ * of the named surfaces. `mcp` is any MCP host that was never handed a door of
+ * its own; `api` is a call that reached the REST API naming nothing at all.
+ * Guessing past either would be inventing attribution rather than recording
+ * it, which is the one thing this vocabulary exists to prevent.
+ *
+ * Every member is three lowercase characters — the property that lets a
+ * channel door's path and its attribution be spelled the same. The suite pins
+ * both the width and the channel members by name.
  */
 export const DeploymentVia = {
+    /** The web dashboard. */
     WEB: 'web',
+    /** A program embedding the SDK directly. */
     SDK: 'sdk',
+    /** The `ship` CLI. */
     CLI: 'cli',
+    /** Any MCP host with no door of its own — the stdio server included. The family fallback. */
     MCP: 'mcp',
+    /** The GitHub Action. */
     GIT: 'git',
+    /** The n8n community node. */
     N8N: 'n8n',
+    /** Channel: the ChatGPT App listing → `mcp.<domain>/gpt`. */
     GPT: 'gpt',
+    /** The VS Code extension. */
     VSC: 'vsc',
+    /** Channel: the Claude connectors directory listing → `mcp.<domain>/cld`. */
+    CLD: 'cld',
+    /** Channel: the Cursor marketplace listing → `mcp.<domain>/crs`. */
+    CRS: 'crs',
+    /**
+     * A deploy that reached the REST API naming no origin at all — the
+     * platform-wide fallback, one altitude below `mcp`'s family fallback.
+     *
+     * **Declared ahead of its emitter, deliberately.** Nothing sends it yet and
+     * the server still records an unattributed deploy as `null`. Vocabulary must
+     * exist before a consumer can adopt it, and adding a member costs a full
+     * constellation convoy — so the word ships first and the API adopts it as a
+     * default whenever that decision is taken, with no convoy standing between
+     * the decision and the deploy.
+     */
+    API: 'api',
 };
 // =============================================================================
 // DOMAIN TYPES

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shipstatic/types",
-  "version": "2.8.0",
+  "version": "2.9.0-beta.2",
   "description": "Shared types for ShipStatic platform",
   "type": "module",
   "main": "./dist/index.js",

package/src/index.ts

@@ -20,25 +20,74 @@ export const DeploymentStatus = {
 export type DeploymentStatusType = (typeof DeploymentStatus)[keyof typeof DeploymentStatus];
 
 /**
- * Which client made a deployment — the origin-tracking vocabulary.
- *
- * A closed set with many authors: the CLI, the SDK, the dashboard, both MCP
- * transports, the GitHub Action, the n8n node and the VS Code extension each
- * name themselves here. It lived in the API's config until 2026-08-06, where
- * being server-side made it unenforceable in the one direction that matters —
- * every client wrote a bare string, and a value outside the set was **silently
- * dropped** by the server, so a typo did not fail anywhere. It stopped
- * recording where deploys came from and said nothing.
+ * Where a deployment came from — the origin-tracking vocabulary.
+ *
+ * A closed set with many authors. It lived in the API's config until
+ * 2026-08-06, where being server-side made it unenforceable in the one
+ * direction that matters — every client wrote a bare string, and a value
+ * outside the set was **silently dropped** by the server, so a typo did not
+ * fail anywhere. It stopped recording where deploys came from and said nothing.
+ *
+ * **The origin law: origin is declared by whatever we control — our code where
+ * we ship code, our URL where we ship only a URL.** One rule decides every
+ * member here and every future one:
+ *
+ * - **Where the platform ships CODE, the code declares it.** `web`, `sdk`,
+ *   `cli`, `git`, `n8n` and `vsc` are surfaces this platform authors, so each
+ *   names itself in its own source and nothing external is needed to tell them
+ *   apart.
+ * - **Where the platform ships only a URL, the URL declares it.** A
+ *   marketplace listing runs somebody else's client against a bare endpoint —
+ *   every one of them the same server speaking the same protocol, and
+ *   indistinguishable in a request. The only thing such a listing's traffic
+ *   has in common is the URL its users were handed, so the hosted MCP serves
+ *   one DOOR per listing and the door's path IS the value: `gpt`, `cld`,
+ *   `crs`.
+ *
+ * **A member names the most specific surface the platform can honestly
+ * claim**, which is what makes the two FALLBACKS fallbacks rather than peers
+ * of the named surfaces. `mcp` is any MCP host that was never handed a door of
+ * its own; `api` is a call that reached the REST API naming nothing at all.
+ * Guessing past either would be inventing attribution rather than recording
+ * it, which is the one thing this vocabulary exists to prevent.
+ *
+ * Every member is three lowercase characters — the property that lets a
+ * channel door's path and its attribution be spelled the same. The suite pins
+ * both the width and the channel members by name.
  */
 export const DeploymentVia = {
+  /** The web dashboard. */
   WEB: 'web',
+  /** A program embedding the SDK directly. */
   SDK: 'sdk',
+  /** The `ship` CLI. */
   CLI: 'cli',
+  /** Any MCP host with no door of its own — the stdio server included. The family fallback. */
   MCP: 'mcp',
+  /** The GitHub Action. */
   GIT: 'git',
+  /** The n8n community node. */
   N8N: 'n8n',
+  /** Channel: the ChatGPT App listing → `mcp.<domain>/gpt`. */
   GPT: 'gpt',
+  /** The VS Code extension. */
   VSC: 'vsc',
+  /** Channel: the Claude connectors directory listing → `mcp.<domain>/cld`. */
+  CLD: 'cld',
+  /** Channel: the Cursor marketplace listing → `mcp.<domain>/crs`. */
+  CRS: 'crs',
+  /**
+   * A deploy that reached the REST API naming no origin at all — the
+   * platform-wide fallback, one altitude below `mcp`'s family fallback.
+   *
+   * **Declared ahead of its emitter, deliberately.** Nothing sends it yet and
+   * the server still records an unattributed deploy as `null`. Vocabulary must
+   * exist before a consumer can adopt it, and adding a member costs a full
+   * constellation convoy — so the word ships first and the API adopts it as a
+   * default whenever that decision is taken, with no convoy standing between
+   * the decision and the deploy.
+   */
+  API: 'api',
 } as const;
 
 export type DeploymentViaType = (typeof DeploymentVia)[keyof typeof DeploymentVia];