@shipfox/client-integrations 0.2.0 → 2.0.0

package/dist/routes/slack.js

@@ -0,0 +1,7 @@
+import { defineRoute } from '@shipfox/client-shell/runtime';
+import { SlackInstallPage } from '#pages/slack-install-page.js';
+export default defineRoute({
+    component: SlackInstallPage
+});
+
+//# sourceMappingURL=slack.js.map

package/dist/routes/slack.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/routes/slack.tsx"],"sourcesContent":["import {defineRoute} from '@shipfox/client-shell/runtime';\nimport {SlackInstallPage} from '#pages/slack-install-page.js';\nexport default defineRoute({component: SlackInstallPage});\n"],"names":["defineRoute","SlackInstallPage","component"],"mappings":"AAAA,SAAQA,WAAW,QAAO,gCAAgC;AAC1D,SAAQC,gBAAgB,QAAO,+BAA+B;AAC9D,eAAeD,YAAY;IAACE,WAAWD;AAAgB,GAAG"}

package/dist/slack-callback.d.ts

@@ -0,0 +1,17 @@
+import type { SlackCallbackQueryDto } from '@shipfox/api-integration-slack-dto';
+export declare const SLACK_INSTALL_WORKSPACE_KEY = "shipfox.slack-install.workspace-id";
+type WorkspaceStorage = Pick<Storage, 'getItem' | 'setItem' | 'removeItem'>;
+export declare function saveSlackInstallWorkspace(storage: WorkspaceStorage, workspaceId: string): void;
+export declare function readSlackInstallWorkspace(storage: WorkspaceStorage): string | undefined;
+export declare function clearSlackInstallWorkspace(storage: WorkspaceStorage): void;
+export declare function parseSlackCallbackQuery(search: Record<string, unknown>): SlackCallbackQueryDto | undefined;
+export declare function serializeSlackCallbackQuery(query: SlackCallbackQueryDto): string;
+export type SlackCallbackFailure = {
+    title: string;
+    message: string;
+    startOver: boolean;
+    signIn: boolean;
+};
+export declare function classifySlackCallbackError(error: unknown): SlackCallbackFailure;
+export {};
+//# sourceMappingURL=slack-callback.d.ts.map

package/dist/slack-callback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack-callback.d.ts","sourceRoot":"","sources":["../src/slack-callback.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,qBAAqB,EAAC,MAAM,oCAAoC,CAAC;AAG9E,eAAO,MAAM,2BAA2B,uCAAuC,CAAC;AAChF,KAAK,gBAAgB,GAAG,IAAI,CAAC,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,YAAY,CAAC,CAAC;AAE5E,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAM9F;AACD,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,GAAG,SAAS,CAMvF;AACD,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAM1E;AAED,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,qBAAqB,GAAG,SAAS,CASnC;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,qBAAqB,GAAG,MAAM,CAShF;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AACF,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,oBAAoB,CA4E/E"}

package/dist/slack-callback.js

@@ -0,0 +1,99 @@
+import { ApiError } from '@shipfox/client-api';
+export const SLACK_INSTALL_WORKSPACE_KEY = 'shipfox.slack-install.workspace-id';
+export function saveSlackInstallWorkspace(storage, workspaceId) {
+    try {
+        storage.setItem(SLACK_INSTALL_WORKSPACE_KEY, workspaceId);
+    } catch  {
+    // Storage only supports recovery navigation.
+    }
+}
+export function readSlackInstallWorkspace(storage) {
+    try {
+        return storage.getItem(SLACK_INSTALL_WORKSPACE_KEY) ?? undefined;
+    } catch  {
+        return undefined;
+    }
+}
+export function clearSlackInstallWorkspace(storage) {
+    try {
+        storage.removeItem(SLACK_INSTALL_WORKSPACE_KEY);
+    } catch  {
+    // A stale recovery hint cannot affect the API callback.
+    }
+}
+export function parseSlackCallbackQuery(search) {
+    const state = stringParam(search.state);
+    if (!state) return undefined;
+    const code = stringParam(search.code);
+    if (code) return {
+        code,
+        state
+    };
+    const error = stringParam(search.error);
+    if (!error) return undefined;
+    const errorDescription = stringParam(search.error_description);
+    return errorDescription ? {
+        error,
+        error_description: errorDescription,
+        state
+    } : {
+        error,
+        state
+    };
+}
+export function serializeSlackCallbackQuery(query) {
+    const params = new URLSearchParams();
+    if ('code' in query) params.set('code', query.code);
+    else {
+        params.set('error', query.error);
+        if (query.error_description) params.set('error_description', query.error_description);
+    }
+    params.set('state', query.state);
+    return params.toString();
+}
+export function classifySlackCallbackError(error) {
+    if (error instanceof ApiError) {
+        if (error.code === 'invalid-slack-install-state') return failure('Slack install link expired', 'Slack install link expired. Start again from workspace settings.', true);
+        if (error.code === 'slack-install-state-actor-mismatch' || error.code === 'unauthorized') return {
+            ...failure('Different Shipfox account', 'Different Shipfox account. Sign in with the account that started this install.', true),
+            signIn: true
+        };
+        if ([
+            'not-found',
+            'forbidden',
+            'workspace-inactive'
+        ].includes(error.code)) return failure('Workspace access changed', 'You no longer have access to this workspace. Return to Shipfox to continue.', false);
+        if ([
+            'slack-installation-already-linked',
+            'slack-connection-already-linked',
+            'slug-conflict'
+        ].includes(error.code)) return failure('Slack already linked', 'This Slack workspace is already linked and cannot be installed again here.', false);
+        if ([
+            'slack-authorization-scope-mismatch',
+            'slack-oauth-callback-error',
+            'access-denied'
+        ].includes(error.code)) return failure('Slack permissions needed', 'Slack did not authorize the permissions Shipfox needs. Review the consent and start again.', true);
+        if (error.code === 'slack-enterprise-install-unsupported' || error.code === 'slack-token-rotation-unsupported') return failure('Slack install unsupported', 'This Slack installation is not supported. Return to Shipfox to continue.', false);
+        if (error.status === 0 || error.code === 'network-error') return failure('Could not reach Shipfox', 'Check your connection and start again.', true);
+        if (error.status >= 500 || error.status === 429 || [
+            'rate-limited',
+            'timeout',
+            'provider-unavailable',
+            'malformed-provider-response'
+        ].includes(error.code)) return failure('Slack is temporarily unavailable', 'Start a new install when Slack is available.', true);
+    }
+    return failure('Slack install could not be completed', 'Could not complete the Slack install. Start again from workspace settings.', true);
+}
+function failure(title, message, startOver) {
+    return {
+        title,
+        message,
+        startOver,
+        signIn: false
+    };
+}
+function stringParam(value) {
+    return typeof value === 'string' && value.length > 0 ? value : undefined;
+}
+
+//# sourceMappingURL=slack-callback.js.map

package/dist/slack-callback.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/slack-callback.ts"],"sourcesContent":["import type {SlackCallbackQueryDto} from '@shipfox/api-integration-slack-dto';\nimport {ApiError} from '@shipfox/client-api';\n\nexport const SLACK_INSTALL_WORKSPACE_KEY = 'shipfox.slack-install.workspace-id';\ntype WorkspaceStorage = Pick<Storage, 'getItem' | 'setItem' | 'removeItem'>;\n\nexport function saveSlackInstallWorkspace(storage: WorkspaceStorage, workspaceId: string): void {\n  try {\n    storage.setItem(SLACK_INSTALL_WORKSPACE_KEY, workspaceId);\n  } catch {\n    // Storage only supports recovery navigation.\n  }\n}\nexport function readSlackInstallWorkspace(storage: WorkspaceStorage): string | undefined {\n  try {\n    return storage.getItem(SLACK_INSTALL_WORKSPACE_KEY) ?? undefined;\n  } catch {\n    return undefined;\n  }\n}\nexport function clearSlackInstallWorkspace(storage: WorkspaceStorage): void {\n  try {\n    storage.removeItem(SLACK_INSTALL_WORKSPACE_KEY);\n  } catch {\n    // A stale recovery hint cannot affect the API callback.\n  }\n}\n\nexport function parseSlackCallbackQuery(\n  search: Record<string, unknown>,\n): SlackCallbackQueryDto | undefined {\n  const state = stringParam(search.state);\n  if (!state) return undefined;\n  const code = stringParam(search.code);\n  if (code) return {code, state};\n  const error = stringParam(search.error);\n  if (!error) return undefined;\n  const errorDescription = stringParam(search.error_description);\n  return errorDescription ? {error, error_description: errorDescription, state} : {error, state};\n}\n\nexport function serializeSlackCallbackQuery(query: SlackCallbackQueryDto): string {\n  const params = new URLSearchParams();\n  if ('code' in query) params.set('code', query.code);\n  else {\n    params.set('error', query.error);\n    if (query.error_description) params.set('error_description', query.error_description);\n  }\n  params.set('state', query.state);\n  return params.toString();\n}\n\nexport type SlackCallbackFailure = {\n  title: string;\n  message: string;\n  startOver: boolean;\n  signIn: boolean;\n};\nexport function classifySlackCallbackError(error: unknown): SlackCallbackFailure {\n  if (error instanceof ApiError) {\n    if (error.code === 'invalid-slack-install-state')\n      return failure(\n        'Slack install link expired',\n        'Slack install link expired. Start again from workspace settings.',\n        true,\n      );\n    if (error.code === 'slack-install-state-actor-mismatch' || error.code === 'unauthorized')\n      return {\n        ...failure(\n          'Different Shipfox account',\n          'Different Shipfox account. Sign in with the account that started this install.',\n          true,\n        ),\n        signIn: true,\n      };\n    if (['not-found', 'forbidden', 'workspace-inactive'].includes(error.code))\n      return failure(\n        'Workspace access changed',\n        'You no longer have access to this workspace. Return to Shipfox to continue.',\n        false,\n      );\n    if (\n      [\n        'slack-installation-already-linked',\n        'slack-connection-already-linked',\n        'slug-conflict',\n      ].includes(error.code)\n    )\n      return failure(\n        'Slack already linked',\n        'This Slack workspace is already linked and cannot be installed again here.',\n        false,\n      );\n    if (\n      [\n        'slack-authorization-scope-mismatch',\n        'slack-oauth-callback-error',\n        'access-denied',\n      ].includes(error.code)\n    )\n      return failure(\n        'Slack permissions needed',\n        'Slack did not authorize the permissions Shipfox needs. Review the consent and start again.',\n        true,\n      );\n    if (\n      error.code === 'slack-enterprise-install-unsupported' ||\n      error.code === 'slack-token-rotation-unsupported'\n    )\n      return failure(\n        'Slack install unsupported',\n        'This Slack installation is not supported. Return to Shipfox to continue.',\n        false,\n      );\n    if (error.status === 0 || error.code === 'network-error')\n      return failure('Could not reach Shipfox', 'Check your connection and start again.', true);\n    if (\n      error.status >= 500 ||\n      error.status === 429 ||\n      ['rate-limited', 'timeout', 'provider-unavailable', 'malformed-provider-response'].includes(\n        error.code,\n      )\n    )\n      return failure(\n        'Slack is temporarily unavailable',\n        'Start a new install when Slack is available.',\n        true,\n      );\n  }\n  return failure(\n    'Slack install could not be completed',\n    'Could not complete the Slack install. Start again from workspace settings.',\n    true,\n  );\n}\nfunction failure(title: string, message: string, startOver: boolean): SlackCallbackFailure {\n  return {title, message, startOver, signIn: false};\n}\nfunction stringParam(value: unknown): string | undefined {\n  return typeof value === 'string' && value.length > 0 ? value : undefined;\n}\n"],"names":["ApiError","SLACK_INSTALL_WORKSPACE_KEY","saveSlackInstallWorkspace","storage","workspaceId","setItem","readSlackInstallWorkspace","getItem","undefined","clearSlackInstallWorkspace","removeItem","parseSlackCallbackQuery","search","state","stringParam","code","error","errorDescription","error_description","serializeSlackCallbackQuery","query","params","URLSearchParams","set","toString","classifySlackCallbackError","failure","signIn","includes","status","title","message","startOver","value","length"],"mappings":"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"}