[Init] Initial commit - NetMesh terminal manager

domain/cloudProviderIds.ts

@@ -0,0 +1,59 @@
+/**
+ * Cloud provider identity helpers.
+ *
+ * Built-in providers keep their stable short IDs. Plugin sync Providers use
+ * namespaced contribution IDs (e.g. com.example.backup.sync). The manager
+ * boundary accepts both without coercing missing plugins away.
+ */
+
+export const BUILTIN_CLOUD_PROVIDERS = [
+  'github',
+  'google',
+  'onedrive',
+  'webdav',
+  's3',
+] as const;
+
+export type BuiltinCloudProvider = (typeof BUILTIN_CLOUD_PROVIDERS)[number];
+
+/** Built-in short IDs or namespaced plugin contribution IDs. */
+export type CloudProviderId = BuiltinCloudProvider | (string & {});
+
+const BUILTIN_SET = new Set<string>(BUILTIN_CLOUD_PROVIDERS);
+
+export function isBuiltinCloudProvider(provider: string): provider is BuiltinCloudProvider {
+  return BUILTIN_SET.has(provider);
+}
+
+/**
+ * True when the provider ID looks like a namespaced plugin contribution.
+ * Contribution IDs are reverse-DNS style and always contain a dot.
+ */
+export function isPluginCloudProviderId(provider: string): boolean {
+  if (isBuiltinCloudProvider(provider)) return false;
+  if (typeof provider !== 'string' || provider.length < 3 || provider.length > 256) return false;
+  if (provider.includes('\0') || provider.includes('/') || provider.includes('\\')) return false;
+  return provider.includes('.');
+}
+
+export function assertCloudProviderId(provider: string): CloudProviderId {
+  if (typeof provider !== 'string' || provider.length < 1 || provider.length > 256) {
+    throw new TypeError('Cloud provider ID is invalid');
+  }
+  if (provider.includes('\0')) {
+    throw new TypeError('Cloud provider ID is invalid');
+  }
+  return provider;
+}
+
+/** localStorage / encrypted local key for a provider connection record. */
+export function providerConnectionStorageKey(provider: CloudProviderId): string {
+  if (isBuiltinCloudProvider(provider)) {
+    return `netcatty_provider_${provider}_v1`;
+  }
+  // Plugin IDs may contain characters unsafe for ad-hoc key templates.
+  return `netcatty_provider_plugin_v1:${provider}`;
+}
+
+/** Registry of dynamic plugin provider IDs that have been connected on this device. */
+export const PLUGIN_CLOUD_PROVIDER_REGISTRY_KEY = 'netcatty_plugin_cloud_providers_v1';