hazo_env 0.1.1 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (43) hide show
  1. package/README.md +46 -4
  2. package/SETUP_CHECKLIST.md +47 -0
  3. package/config/hazo_env_masking.ini.sample +16 -16
  4. package/dist/cli.js +167 -6
  5. package/dist/index.d.ts +6 -0
  6. package/dist/index.d.ts.map +1 -1
  7. package/dist/index.js +8 -0
  8. package/dist/lib/index.d.ts +1 -1
  9. package/dist/lib/index.d.ts.map +1 -1
  10. package/dist/lib/index.js +2 -1
  11. package/dist/lib/secret_columns.d.ts +3 -0
  12. package/dist/lib/secret_columns.d.ts.map +1 -0
  13. package/dist/lib/secret_columns.js +14 -0
  14. package/dist/mask/registry.d.ts +8 -0
  15. package/dist/mask/registry.d.ts.map +1 -0
  16. package/dist/mask/registry.js +29 -0
  17. package/dist/mask/ruleset.d.ts +15 -0
  18. package/dist/mask/ruleset.d.ts.map +1 -0
  19. package/dist/mask/ruleset.js +77 -0
  20. package/dist/migrate/audit.d.ts +21 -0
  21. package/dist/migrate/audit.d.ts.map +1 -0
  22. package/dist/migrate/audit.js +36 -0
  23. package/dist/migrate/db.d.ts +13 -0
  24. package/dist/migrate/db.d.ts.map +1 -0
  25. package/dist/migrate/db.js +122 -0
  26. package/dist/migrate/files.d.ts +14 -0
  27. package/dist/migrate/files.d.ts.map +1 -0
  28. package/dist/migrate/files.js +72 -0
  29. package/dist/migrate/run.d.ts +3 -0
  30. package/dist/migrate/run.d.ts.map +1 -0
  31. package/dist/migrate/run.js +195 -0
  32. package/dist/migrate/snapshot.d.ts +8 -0
  33. package/dist/migrate/snapshot.d.ts.map +1 -0
  34. package/dist/migrate/snapshot.js +48 -0
  35. package/dist/migrate/transport.d.ts +3 -0
  36. package/dist/migrate/transport.d.ts.map +1 -0
  37. package/dist/migrate/transport.js +17 -0
  38. package/dist/migrate/verify.d.ts +8 -0
  39. package/dist/migrate/verify.d.ts.map +1 -0
  40. package/dist/migrate/verify.js +51 -0
  41. package/dist/types/index.d.ts +42 -27
  42. package/dist/types/index.d.ts.map +1 -1
  43. package/package.json +15 -3
@@ -40,39 +40,54 @@ export interface ResolveConnectOptions {
40
40
  env?: HazoEnv;
41
41
  allowOtherEnv?: boolean;
42
42
  }
43
- /** Describes a requested migration between two environments */
43
+ export type TransportMode = 'auto' | 'local' | 'ssh' | 'api';
44
+ export type ScrubMode = 'auto' | 'none';
45
+ export type HashMode = 'none' | 'sample' | 'full';
46
+ export interface MigrationProgress {
47
+ phase: 'validate' | 'snapshot' | 'plan' | 'schema-check' | 'db' | 'files' | 'verify' | 'finalize' | 'done';
48
+ message: string;
49
+ percent?: number;
50
+ }
44
51
  export interface MigrationRequest {
45
- fromEnv: HazoEnv;
46
- toEnv: HazoEnv;
47
- includeFiles?: boolean;
52
+ from: HazoEnv;
53
+ to: HazoEnv;
54
+ include?: {
55
+ db?: boolean;
56
+ files?: boolean;
57
+ };
58
+ transport?: TransportMode;
59
+ scrub?: ScrubMode;
60
+ tables?: '*' | string[];
48
61
  dryRun?: boolean;
62
+ allowProdTarget?: boolean;
63
+ confirmToken?: string;
64
+ onProgress?: (p: MigrationProgress) => void;
49
65
  }
50
- /** Result of a completed migration */
51
66
  export interface MigrationResult {
52
- success: boolean;
53
- rowsMigrated?: number;
54
- filesMigrated?: number;
67
+ ok: boolean;
68
+ snapshotId?: string;
69
+ db?: {
70
+ tables: number;
71
+ rows: number;
72
+ scrubbed: number;
73
+ };
74
+ files?: {
75
+ copied: number;
76
+ bytes: number;
77
+ placeholdered: number;
78
+ };
79
+ warnings: string[];
80
+ durationMs: number;
55
81
  error?: string;
56
82
  }
57
- /** Progress event emitted during a migration run */
58
- export interface MigrationProgress {
59
- phase: 'db' | 'files' | 'verify' | 'done';
60
- message: string;
61
- percent?: number;
62
- }
63
- /** Result of a post-migration file verification */
64
83
  export interface VerifyReport {
65
- passed: boolean;
66
- missingFiles: string[];
67
- extraFiles: string[];
68
- checksumErrors: string[];
69
- }
70
- /** A transform rule for scrubbing/masking sensitive fields */
71
- export interface ScrubTransform {
72
- table: string;
73
- column: string;
74
- /** Transform strategy: replace with fixed value, hash, or nullify */
75
- strategy: 'replace' | 'hash' | 'nullify';
76
- replacement?: string;
84
+ ok: boolean;
85
+ checked: number;
86
+ missing: string[];
87
+ sizeMismatch: string[];
88
+ hashMismatch: string[];
89
+ orphans: string[];
90
+ sentinelOk: boolean;
77
91
  }
92
+ export type MaskTransform = (value: unknown, key: string, maskKey: string) => unknown;
78
93
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAEA,sDAAsD;AACtD,MAAM,MAAM,OAAO,GAAG,KAAK,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;AAEnE,mCAAmC;AACnC,MAAM,MAAM,WAAW,GAAG,aAAa,GAAG,MAAM,GAAG,SAAS,GAAG,YAAY,CAAC;AAE5E,iFAAiF;AACjF,MAAM,MAAM,UAAU,GAAG,MAAM,EAAE,CAAC;AAElC,2CAA2C;AAC3C,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEtD,yEAAyE;AACzE,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,GAAG,WAAW,CAAC;IAC7B,MAAM,CAAC,EAAE;QAAE,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;IACnC,SAAS,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CACnD;AAED,yDAAyD;AACzD,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE;QACL,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;KAC9B,CAAC;CACH;AAED,8BAA8B;AAC9B,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,OAAO,CAAC;IACb,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,UAAU,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED,uCAAuC;AACvC,MAAM,WAAW,qBAAqB;IACpC,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAID,+DAA+D;AAC/D,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,sCAAsC;AACtC,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,oDAAoD;AACpD,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,IAAI,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,mDAAmD;AACnD,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAID,8DAA8D;AAC9D,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,QAAQ,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,CAAC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAEA,sDAAsD;AACtD,MAAM,MAAM,OAAO,GAAG,KAAK,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;AAEnE,mCAAmC;AACnC,MAAM,MAAM,WAAW,GAAG,aAAa,GAAG,MAAM,GAAG,SAAS,GAAG,YAAY,CAAC;AAE5E,iFAAiF;AACjF,MAAM,MAAM,UAAU,GAAG,MAAM,EAAE,CAAC;AAElC,2CAA2C;AAC3C,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEtD,yEAAyE;AACzE,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,GAAG,WAAW,CAAC;IAC7B,MAAM,CAAC,EAAE;QAAE,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;IACnC,SAAS,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CACnD;AAED,yDAAyD;AACzD,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE;QACL,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;KAC9B,CAAC;CACH;AAED,8BAA8B;AAC9B,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,OAAO,CAAC;IACb,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,UAAU,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED,uCAAuC;AACvC,MAAM,WAAW,qBAAqB;IACpC,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAID,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,KAAK,CAAC;AAC7D,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;AACxC,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;AAElD,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,UAAU,GAAG,UAAU,GAAG,MAAM,GAAG,cAAc,GAAG,IAAI,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC;IAC3G,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,OAAO,CAAC;IACd,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC5C,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,MAAM,CAAC,EAAE,GAAG,GAAG,MAAM,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,CAAC,CAAC,EAAE,iBAAiB,KAAK,IAAI,CAAC;CAC7C;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,OAAO,CAAC;IACZ,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,EAAE,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IACxD,KAAK,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;IACjE,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;CACrB;AAGD,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "hazo_env",
3
- "version": "0.1.1",
3
+ "version": "0.2.0",
4
4
  "description": "Canonical environment resolver — typed env names, per-env DB/file/secret config, doctor and CLI for hazo apps",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",
@@ -40,8 +40,11 @@
40
40
  "peerDependencies": {
41
41
  "hazo_core": "^1.1.0",
42
42
  "hazo_config": "^2.1.10",
43
- "hazo_connect": "^3.4.0",
43
+ "hazo_connect": "^3.4.1",
44
44
  "hazo_files": "^3.0.0",
45
+ "hazo_secure": "^1.2.0",
46
+ "hazo_audit": "^2.1.0",
47
+ "hazo_pdf": "^2.0.0",
45
48
  "react": "^18.0.0 || ^19.0.0",
46
49
  "react-dom": "^18.0.0 || ^19.0.0",
47
50
  "next": "^14.0.0 || ^16.0.0"
@@ -53,6 +56,15 @@
53
56
  "hazo_files": {
54
57
  "optional": true
55
58
  },
59
+ "hazo_secure": {
60
+ "optional": true
61
+ },
62
+ "hazo_audit": {
63
+ "optional": true
64
+ },
65
+ "hazo_pdf": {
66
+ "optional": true
67
+ },
56
68
  "react": {
57
69
  "optional": true
58
70
  },
@@ -74,7 +86,7 @@
74
86
  "@types/react-dom": "^19.0.0",
75
87
  "hazo_core": "^1.1.0",
76
88
  "hazo_config": "^2.1.10",
77
- "hazo_connect": "^3.4.0",
89
+ "hazo_connect": "^3.4.1",
78
90
  "hazo_files": "^3.0.0",
79
91
  "next": "^16.0.10",
80
92
  "react": "^19.0.0",