@cmpsbl/failsafe 3.0.0 → 3.4.0

package/README.md

@@ -1,6 +1,8 @@
 # @cmpsbl/failsafe
 
-CMPSBL® FAILSAFE — Disaster Recovery & Platform Migration Engine.
+> CMPSBL® FAILSAFE — Zero-dependency disaster recovery & platform migration engine.
+
+[![npm](https://img.shields.io/npm/v/@cmpsbl/failsafe)](https://www.npmjs.com/package/@cmpsbl/failsafe)
 
 ## Install
 
@@ -8,33 +10,25 @@ CMPSBL® FAILSAFE — Disaster Recovery & Platform Migration Engine.
 npm install @cmpsbl/failsafe
 ```
 
+**Zero dependencies.** Builds standalone.
+
+## Dependency Tier
+
+```
+Tier 1 (no deps — publish/install in any order)
+```
+
 ## Usage
 
 ```typescript
-import { createBackup, restore, migrate } from '@cmpsbl/failsafe';
+import { createBackup, restore } from '@cmpsbl/failsafe';
 
-// Backup
 const backup = await createBackup({
-  supabaseUrl: 'https://xxx.supabase.co',
+  supabaseUrl: 'https://your-project.supabase.co',
   supabaseKey: 'your-service-role-key',
 });
-
-// Restore
-const result = await restore({
-  targetUrl: 'https://yyy.supabase.co',
-  targetKey: 'target-service-role-key',
-  backupData: myBackupData,
-  cleanRestore: true,
-});
-
-// Full migration
-const migration = await migrate({
-  source: { supabaseUrl: '...', supabaseKey: '...' },
-  target: { targetUrl: '...', targetKey: '...' },
-  options: { cleanRestore: true, validateIntegrity: true },
-});
 ```
 
 ## License
 
-Apache-2.0 © Kenneth E Sweet Jr
+Apache-2.0 — © CMPSBL®

package/dist/index.d.ts

@@ -1,9 +1,36 @@
 /**
  * @cmpsbl/failsafe — Disaster Recovery & Platform Migration Engine
  * Zero-dependency backup, restore, and migration toolkit.
+ * Includes first-contact Memory Stream integration.
  *
  * © CMPSBL® — All rights reserved.
  */
+export interface MemoryChain {
+    id: string;
+    pattern: string;
+    adoption: string;
+    status: 'new' | 'captured' | 'applied' | 'exported';
+    discoveredAt: string;
+    domain: string;
+    confidence: number;
+}
+export interface CeremonyEvent {
+    phase: string;
+    message: string;
+    detail?: string;
+    progress?: number;
+}
+export interface FirstContactConfig {
+    package: string;
+    domain: string;
+    endpoint?: string;
+    apiKey?: string;
+    autoDiscover?: boolean;
+    onDiscovery?: (chain: MemoryChain) => void;
+    onBoot?: (message: string) => void;
+    onCeremony?: (event: CeremonyEvent) => void;
+    silent?: boolean;
+}
 export interface BackupConfig {
     /** Supabase project URL */
     supabaseUrl: string;
@@ -39,13 +66,9 @@ export interface RestoreStep {
     error?: string;
 }
 export interface RestoreConfig {
-    /** Target Supabase project URL */
     targetUrl: string;
-    /** Target Supabase service role key */
     targetKey: string;
-    /** Backup data to restore */
     backupData: Record<string, unknown[]>;
-    /** Whether to drop existing data before restore */
     cleanRestore?: boolean;
 }
 export interface RestoreResult {
@@ -73,3 +96,4 @@ export declare function migrate(config: MigrationConfig): Promise<{
     backup: BackupResult;
     restore: RestoreResult;
 }>;
+export declare function createFailsafeFirstContact(apiKey?: string): FirstContactConfig;

package/dist/index.js

@@ -2,6 +2,7 @@
 /**
  * @cmpsbl/failsafe — Disaster Recovery & Platform Migration Engine
  * Zero-dependency backup, restore, and migration toolkit.
+ * Includes first-contact Memory Stream integration.
  *
  * © CMPSBL® — All rights reserved.
  */
@@ -9,6 +10,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createBackup = createBackup;
 exports.restore = restore;
 exports.migrate = migrate;
+exports.createFailsafeFirstContact = createFailsafeFirstContact;
 // ═══════════════════════════════════════════════════════════════
 // §1 — Backup Engine
 // ═══════════════════════════════════════════════════════════════
@@ -19,7 +21,6 @@ async function createBackup(config) {
     let totalRows = 0;
     let totalSize = 0;
     try {
-        // Discover tables
         const tables = config.tables?.length
             ? config.tables
             : await discoverTables(config.supabaseUrl, config.supabaseKey);
@@ -28,12 +29,7 @@ async function createBackup(config) {
                 const data = await fetchTable(config.supabaseUrl, config.supabaseKey, table);
                 const json = JSON.stringify(data);
                 const checksum = simpleHash(json);
-                tableBackups.push({
-                    table,
-                    rowCount: data.length,
-                    sizeBytes: json.length,
-                    checksum,
-                });
+                tableBackups.push({ table, rowCount: data.length, sizeBytes: json.length, checksum });
                 totalRows += data.length;
                 totalSize += json.length;
             }
@@ -139,7 +135,6 @@ async function migrate(config) {
             restore: { success: false, steps: [], tablesRestored: 0, totalRows: 0, durationMs: 0 },
         };
     }
-    // Build backup data map (in real implementation, this comes from the actual backup data)
     const restoreResult = await restore({
         ...config.target,
         backupData: {},
@@ -157,7 +152,8 @@ async function discoverTables(url, key) {
     if (!res.ok)
         throw new Error(`Failed to discover tables: ${res.status}`);
     const data = await res.json();
-    return Object.keys(data?.definitions ?? {});
+    const defs = (data?.definitions ?? {});
+    return Object.keys(defs);
 }
 async function fetchTable(url, key, table) {
     const res = await fetch(`${url}/rest/v1/${table}?select=*`, {
@@ -197,3 +193,15 @@ function simpleHash(str) {
     }
     return Math.abs(hash).toString(16).padStart(8, '0');
 }
+// ═══════════════════════════════════════════════════════════════
+// First Contact — Failsafe Domain
+// ═══════════════════════════════════════════════════════════════
+function createFailsafeFirstContact(apiKey) {
+    return {
+        package: '@cmpsbl/failsafe',
+        domain: 'failsafe',
+        apiKey,
+        endpoint: 'https://bxodolqqczjuahwdrswy.supabase.co/functions/v1/substrate-api',
+        autoDiscover: true,
+    };
+}

package/package.json

@@ -1,33 +1,17 @@
 {
   "name": "@cmpsbl/failsafe",
-  "version": "3.0.0",
+  "version": "3.4.0",
   "description": "CMPSBL® FAILSAFE — Zero-dependency disaster recovery & platform migration engine",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
-  "files": [
-    "dist"
-  ],
+  "files": ["dist"],
   "scripts": {
     "build": "tsc",
     "prepublishOnly": "npm run build"
   },
-  "keywords": [
-    "cmpsbl",
-    "failsafe",
-    "disaster-recovery",
-    "migration",
-    "backup",
-    "restore"
-  ],
+  "keywords": ["cmpsbl", "failsafe", "disaster-recovery", "migration", "backup", "restore"],
   "author": "Kenneth E Sweet Jr <promptfluid@gmail.com>",
   "license": "Apache-2.0",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/cmpsbl/failsafe"
-  },
-  "homepage": "https://cmpsbl.com/engines/failsafe",
-  "devDependencies": {
-    "@types/lodash": "^4.17.24",
-    "@types/lodash-es": "^4.17.12"
-  }
+  "repository": { "type": "git", "url": "https://github.com/cmpsbl/failsafe" },
+  "homepage": "https://cmpsbl.com/engines/failsafe"
 }