@revstackhq/providers-registry 0.0.0-20260207005540

package/LICENSE

@@ -0,0 +1,38 @@
+BUSINESS SOURCE LICENSE 1.1
+
+The Licensor hereby grants you the right to copy, modify, create derivative works, redistribute, and make use of the Licensed Work for any purpose, except as limited by the Additional Use Grant below.
+
+Redistribution is allowed only if this License is included with the Licensed Work and any derivative works.
+
+ADDITIONAL USE GRANT:
+
+You may make use of the Licensed Work, provided that you do not use the Licensed Work to provide a "Managed Payment Orchestration Service".
+
+A "Managed Payment Orchestration Service" is defined as a commercial service, product, or offering where the Licensed Work is used to provide payment routing, checkout orchestration, or connection management to third parties as a service (SaaS, PaaS, or IaaS), whether for a fee or free of charge.
+
+For clarity:
+1. You MAY use the Licensed Work internally to process payments for your own business or merchandise.
+2. You MAY NOT use the Licensed Work to build a competitor service to Revstack that allows your customers to orchestrate their own payments.
+
+CHANGE DATE:
+
+January 1, 2031
+
+CHANGE LICENSE:
+
+Apache License, Version 2.0
+
+ERROR CORRECTIONS AND SECURITY UPDATES:
+
+The Licensor may, at its option, provide error corrections and security updates to the Licensed Work. If the Licensor provides such error corrections and security updates, they are considered part of the Licensed Work and are subject to this License.
+
+MANAGED SERVICE EXCEPTION:
+
+If you have a separate written agreement with the Licensor (e.g., an Enterprise License) that specifically grants you the right to provide a Managed Payment Orchestration Service, that agreement supersedes the limitations of the Additional Use Grant.
+
+*****************************************************************************
+
+LICENSOR:           Revstack Inc.
+LICENSED WORK:      The Revstack OS software and associated documentation.
+
+*****************************************************************************

package/dist/index.d.ts

@@ -0,0 +1,43 @@
+import { IProvider, ProviderManifest } from '@revstackhq/providers-core';
+
+/**
+ * Factory class responsible for instantiating Provider SDKs.
+ * It acts as the bridge between the Registry (loading mechanism) and the Core (execution).
+ */
+declare class ProviderFactory {
+    /**
+     * Instantiates a Provider SDK by its slug.
+     * * @param slug - The unique identifier of the provider (e.g., "stripe", "polar").
+     * @returns An instance of the provider class implementing the IProvider contract.
+     * @throws Error if the provider is not registered or fails to load.
+     */
+    static create(slug: string): Promise<IProvider>;
+}
+
+/**
+ * Defines the shape of the module exported by a Provider Package.
+ * Example: import * as stripeModule from '@revstack/provider-stripe';
+ */
+interface ProviderModule {
+    /**
+     * The main class exported by the provider.
+     * Must implement the IProvider interface and have a constructor.
+     */
+    DefaultProvider: new () => IProvider;
+    manifest: ProviderManifest;
+}
+/**
+ * A function that loads a provider module dynamically.
+ * Used for lazy loading via import().
+ */
+type ProviderLoader = () => Promise<ProviderModule>;
+
+declare function registerProvider(slug: string, loader: ProviderLoader): void;
+declare function getProviderLoader(slug: string): ProviderLoader | undefined;
+declare function listRegisteredProviders(): string[];
+declare function listAvailableProviders(): string[];
+declare function registerBuiltInProviders(): void;
+declare function getProviderManifest(slug: string): Promise<ProviderManifest | null>;
+declare function getCatalog(): Promise<ProviderManifest[]>;
+
+export { ProviderFactory, type ProviderLoader, type ProviderModule, getCatalog, getProviderLoader, getProviderManifest, listAvailableProviders, listRegisteredProviders, registerBuiltInProviders, registerProvider };

package/dist/index.js

@@ -0,0 +1,104 @@
+// src/registry.ts
+var loaders = {};
+var builtInProviders = {
+  stripe: () => import("@revstackhq/provider-stripe")
+};
+function registerProvider(slug, loader) {
+  loaders[slug] = loader;
+}
+function getProviderLoader(slug) {
+  return loaders[slug];
+}
+function listRegisteredProviders() {
+  return Object.keys(loaders).sort();
+}
+function listAvailableProviders() {
+  return Object.keys(builtInProviders).sort();
+}
+function registerBuiltInProviders() {
+  for (const [slug, loader] of Object.entries(builtInProviders)) {
+    registerProvider(slug, loader);
+  }
+}
+async function getProviderManifest(slug) {
+  const loader = getProviderLoader(slug);
+  if (!loader) return null;
+  try {
+    const module = await loader();
+    if (module.manifest) {
+      return module.manifest;
+    }
+    const rawModule = module;
+    for (const key of Object.keys(rawModule)) {
+      const exportItem = rawModule[key];
+      if (exportItem && typeof exportItem === "function" && "manifest" in exportItem) {
+        console.log(`\u2705 Manifest found in static property ${key}`);
+        return exportItem.manifest;
+      }
+    }
+    if (rawModule.default && rawModule.default.manifest) {
+      return rawModule.default.manifest;
+    }
+    if (rawModule.default && typeof rawModule.default === "function" && "manifest" in rawModule.default) {
+      return rawModule.default.manifest;
+    }
+    console.warn(
+      `\u26A0\uFE0F Manifest not found for ${slug}. Available keys:`,
+      Object.keys(rawModule)
+    );
+    return null;
+  } catch (e) {
+    console.error(`\u274C Error loading manifest for provider: ${slug}`);
+    console.error(e);
+    return null;
+  }
+}
+async function getCatalog() {
+  const slugs = listRegisteredProviders();
+  const manifests = await Promise.all(
+    slugs.map((slug) => getProviderManifest(slug))
+  );
+  return manifests.filter((m) => !!m);
+}
+
+// src/factory.ts
+var ProviderFactory = class {
+  /**
+   * Instantiates a Provider SDK by its slug.
+   * * @param slug - The unique identifier of the provider (e.g., "stripe", "polar").
+   * @returns An instance of the provider class implementing the IProvider contract.
+   * @throws Error if the provider is not registered or fails to load.
+   */
+  static async create(slug) {
+    const loader = getProviderLoader(slug);
+    if (!loader) {
+      const knownProviders = listRegisteredProviders();
+      throw new Error(
+        `Provider '${slug}' is not registered in Revstack. Available providers: [${knownProviders.join(", ")}]`
+      );
+    }
+    try {
+      const module = await loader();
+      if (!module.DefaultProvider) {
+        throw new Error(
+          `The package for '${slug}' does not export a 'DefaultProvider' class.`
+        );
+      }
+      return new module.DefaultProvider();
+    } catch (error) {
+      throw new Error(
+        `Failed to initialize provider '${slug}'. Details: ${error.message || error}`
+      );
+    }
+  }
+};
+export {
+  ProviderFactory,
+  getCatalog,
+  getProviderLoader,
+  getProviderManifest,
+  listAvailableProviders,
+  listRegisteredProviders,
+  registerBuiltInProviders,
+  registerProvider
+};

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@revstackhq/providers-registry",
+  "version": "0.0.0-20260207005540",
+  "private": false,
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@revstackhq/providers-core": "0.2.0",
+    "@revstackhq/provider-stripe": "0.2.1"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.1",
+    "@types/node": "^20.11.30",
+    "eslint": "^9.39.1",
+    "eslint-config-prettier": "^10.1.1",
+    "eslint-plugin-turbo": "^2.7.1",
+    "tsup": "^8.1.0",
+    "typescript": "5.9.2",
+    "typescript-eslint": "^8.50.0",
+    "@revstackhq/eslint-config": "0.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts --clean --splitting",
+    "check-types": "tsc -p tsconfig.json --noEmit",
+    "lint": "eslint \"src/**/*.{ts,tsx}\""
+  }
+}