@argos-js/data 0.0.0-stage → 0.1.1

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 (131) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +799 -2
  3. package/dist/connection/index.d.ts +2 -0
  4. package/dist/connection/index.d.ts.map +1 -0
  5. package/dist/connection/index.js +18 -0
  6. package/dist/connection/index.js.map +1 -0
  7. package/dist/connection/manager.d.ts +93 -0
  8. package/dist/connection/manager.d.ts.map +1 -0
  9. package/dist/connection/manager.js +194 -0
  10. package/dist/connection/manager.js.map +1 -0
  11. package/dist/database.d.ts +29 -0
  12. package/dist/database.d.ts.map +1 -0
  13. package/dist/database.js +276 -0
  14. package/dist/database.js.map +1 -0
  15. package/dist/drivers/base-driver.d.ts +18 -0
  16. package/dist/drivers/base-driver.d.ts.map +1 -0
  17. package/dist/drivers/base-driver.js +211 -0
  18. package/dist/drivers/base-driver.js.map +1 -0
  19. package/dist/drivers/index.d.ts +11 -0
  20. package/dist/drivers/index.d.ts.map +1 -0
  21. package/dist/drivers/index.js +55 -0
  22. package/dist/drivers/index.js.map +1 -0
  23. package/dist/drivers/mavedb-edge.d.ts +8 -0
  24. package/dist/drivers/mavedb-edge.d.ts.map +1 -0
  25. package/dist/drivers/mavedb-edge.js +18 -0
  26. package/dist/drivers/mavedb-edge.js.map +1 -0
  27. package/dist/drivers/mongodb.d.ts +8 -0
  28. package/dist/drivers/mongodb.d.ts.map +1 -0
  29. package/dist/drivers/mongodb.js +18 -0
  30. package/dist/drivers/mongodb.js.map +1 -0
  31. package/dist/drivers/mssql.d.ts +8 -0
  32. package/dist/drivers/mssql.d.ts.map +1 -0
  33. package/dist/drivers/mssql.js +18 -0
  34. package/dist/drivers/mssql.js.map +1 -0
  35. package/dist/drivers/mysql.d.ts +8 -0
  36. package/dist/drivers/mysql.d.ts.map +1 -0
  37. package/dist/drivers/mysql.js +18 -0
  38. package/dist/drivers/mysql.js.map +1 -0
  39. package/dist/drivers/postgres.d.ts +8 -0
  40. package/dist/drivers/postgres.d.ts.map +1 -0
  41. package/dist/drivers/postgres.js +18 -0
  42. package/dist/drivers/postgres.js.map +1 -0
  43. package/dist/drivers/redis.d.ts +9 -0
  44. package/dist/drivers/redis.d.ts.map +1 -0
  45. package/dist/drivers/redis.js +50 -0
  46. package/dist/drivers/redis.js.map +1 -0
  47. package/dist/drivers/sqlite.d.ts +8 -0
  48. package/dist/drivers/sqlite.d.ts.map +1 -0
  49. package/dist/drivers/sqlite.js +18 -0
  50. package/dist/drivers/sqlite.js.map +1 -0
  51. package/dist/index.d.ts +14 -0
  52. package/dist/index.d.ts.map +1 -0
  53. package/dist/index.js +49 -0
  54. package/dist/index.js.map +1 -0
  55. package/dist/migrations/index.d.ts +7 -0
  56. package/dist/migrations/index.d.ts.map +1 -0
  57. package/dist/migrations/index.js +23 -0
  58. package/dist/migrations/index.js.map +1 -0
  59. package/dist/migrations/migrator.d.ts +79 -0
  60. package/dist/migrations/migrator.d.ts.map +1 -0
  61. package/dist/migrations/migrator.js +274 -0
  62. package/dist/migrations/migrator.js.map +1 -0
  63. package/dist/migrations/schema-builder.d.ts +318 -0
  64. package/dist/migrations/schema-builder.d.ts.map +1 -0
  65. package/dist/migrations/schema-builder.js +957 -0
  66. package/dist/migrations/schema-builder.js.map +1 -0
  67. package/dist/migrations/types.d.ts +58 -0
  68. package/dist/migrations/types.d.ts.map +1 -0
  69. package/dist/migrations/types.js +3 -0
  70. package/dist/migrations/types.js.map +1 -0
  71. package/dist/model.d.ts +107 -0
  72. package/dist/model.d.ts.map +1 -0
  73. package/dist/model.js +333 -0
  74. package/dist/model.js.map +1 -0
  75. package/dist/plugin.d.ts +38 -0
  76. package/dist/plugin.d.ts.map +1 -0
  77. package/dist/plugin.js +83 -0
  78. package/dist/plugin.js.map +1 -0
  79. package/dist/query-builder.d.ts +58 -0
  80. package/dist/query-builder.d.ts.map +1 -0
  81. package/dist/query-builder.js +534 -0
  82. package/dist/query-builder.js.map +1 -0
  83. package/dist/schema-adapter.d.ts +34 -0
  84. package/dist/schema-adapter.d.ts.map +1 -0
  85. package/dist/schema-adapter.js +511 -0
  86. package/dist/schema-adapter.js.map +1 -0
  87. package/dist/schema.d.ts +104 -0
  88. package/dist/schema.d.ts.map +1 -0
  89. package/dist/schema.js +190 -0
  90. package/dist/schema.js.map +1 -0
  91. package/dist/seeds/index.d.ts +3 -0
  92. package/dist/seeds/index.d.ts.map +1 -0
  93. package/dist/seeds/index.js +19 -0
  94. package/dist/seeds/index.js.map +1 -0
  95. package/dist/seeds/seeder.d.ts +27 -0
  96. package/dist/seeds/seeder.d.ts.map +1 -0
  97. package/dist/seeds/seeder.js +138 -0
  98. package/dist/seeds/seeder.js.map +1 -0
  99. package/dist/seeds/types.d.ts +60 -0
  100. package/dist/seeds/types.d.ts.map +1 -0
  101. package/dist/seeds/types.js +3 -0
  102. package/dist/seeds/types.js.map +1 -0
  103. package/dist/sync/dump.d.ts +80 -0
  104. package/dist/sync/dump.d.ts.map +1 -0
  105. package/dist/sync/dump.js +655 -0
  106. package/dist/sync/dump.js.map +1 -0
  107. package/dist/sync/index.d.ts +5 -0
  108. package/dist/sync/index.d.ts.map +1 -0
  109. package/dist/sync/index.js +21 -0
  110. package/dist/sync/index.js.map +1 -0
  111. package/dist/sync/introspector.d.ts +49 -0
  112. package/dist/sync/introspector.d.ts.map +1 -0
  113. package/dist/sync/introspector.js +750 -0
  114. package/dist/sync/introspector.js.map +1 -0
  115. package/dist/sync/synchronizer.d.ts +50 -0
  116. package/dist/sync/synchronizer.d.ts.map +1 -0
  117. package/dist/sync/synchronizer.js +506 -0
  118. package/dist/sync/synchronizer.js.map +1 -0
  119. package/dist/sync/types.d.ts +83 -0
  120. package/dist/sync/types.d.ts.map +1 -0
  121. package/dist/sync/types.js +3 -0
  122. package/dist/sync/types.js.map +1 -0
  123. package/dist/tenant/sequence.d.ts +36 -0
  124. package/dist/tenant/sequence.d.ts.map +1 -0
  125. package/dist/tenant/sequence.js +130 -0
  126. package/dist/tenant/sequence.js.map +1 -0
  127. package/dist/types.d.ts +81 -0
  128. package/dist/types.d.ts.map +1 -0
  129. package/dist/types.js +3 -0
  130. package/dist/types.js.map +1 -0
  131. package/package.json +38 -3
@@ -0,0 +1,80 @@
1
+ import type { DatabaseClient } from '../database';
2
+ import { type SupportedDialect } from '../schema-adapter';
3
+ export interface DumpManifest {
4
+ version: string;
5
+ format: 'argos-canonical-dump';
6
+ createdAt: string;
7
+ sourceDialect: SupportedDialect;
8
+ totalRecords: number;
9
+ tableCount: number;
10
+ tables: Record<string, {
11
+ recordCount: number;
12
+ }>;
13
+ }
14
+ export interface DumpProgress {
15
+ tableName: string;
16
+ transferredRows: number;
17
+ totalRows: number;
18
+ phase: 'introspecting' | 'dumping' | 'completed';
19
+ }
20
+ export interface DumpOptions {
21
+ connection?: string | DatabaseClient | undefined;
22
+ outputPath?: string | undefined;
23
+ tables?: string[] | undefined;
24
+ batchSize?: number | undefined;
25
+ onProgress?: ((progress: DumpProgress) => void) | undefined;
26
+ }
27
+ export interface DumpResult {
28
+ outputPath: string;
29
+ tablesDumped: number;
30
+ totalRecords: number;
31
+ durationMs: number;
32
+ manifest: DumpManifest;
33
+ }
34
+ export interface RestoreProgress {
35
+ tableName: string;
36
+ transferredRows: number;
37
+ totalRows: number;
38
+ phase: 'preparing' | 'restoring' | 'completed';
39
+ }
40
+ export interface RestoreOptions {
41
+ connection?: string | DatabaseClient | undefined;
42
+ inputPath: string;
43
+ truncate?: boolean | undefined;
44
+ batchSize?: number | undefined;
45
+ onProgress?: ((progress: RestoreProgress) => void) | undefined;
46
+ }
47
+ export interface RestoreResult {
48
+ tablesRestored: number;
49
+ recordsRestored: number;
50
+ durationMs: number;
51
+ }
52
+ /**
53
+ * Agnostic Database Dumper.
54
+ * Introspects source database schema and exports a collation-safe canonical bundle (.argos)
55
+ * containing manifest.json, schema.json, and streaming chunked data/*.ndjson files.
56
+ */
57
+ export declare class DatabaseDumper {
58
+ dump(options?: DumpOptions): Promise<DumpResult>;
59
+ private resolveClient;
60
+ private sanitizeSchema;
61
+ private quoteIdentifier;
62
+ }
63
+ /**
64
+ * Agnostic Database Restorer.
65
+ * Reads canonical .argos dump package, adapts schema to active target dialect,
66
+ * disables foreign key constraints, streams .ndjson records with normalization,
67
+ * and recalibrates dialect auto-increment/sequences.
68
+ */
69
+ export declare class DatabaseRestorer {
70
+ restore(options: RestoreOptions): Promise<RestoreResult>;
71
+ private resolveClient;
72
+ private setConstraintsEnabled;
73
+ private truncateTable;
74
+ private createTableInTarget;
75
+ private normalizeRow;
76
+ private insertBatch;
77
+ private syncSequences;
78
+ private quoteIdentifier;
79
+ }
80
+ //# sourceMappingURL=dump.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"dump.d.ts","sourceRoot":"","sources":["../../src/sync/dump.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,OAAO,EAAoB,KAAK,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAS5E,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,sBAAsB,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,gBAAgB,CAAC;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjD;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,eAAe,GAAG,SAAS,GAAG,WAAW,CAAC;CAClD;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,CAAC,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAAC;IACjD,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,UAAU,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,YAAY,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CAC7D;AAED,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,YAAY,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,WAAW,GAAG,WAAW,GAAG,WAAW,CAAC;CAChD;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,CAAC,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAAC;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,UAAU,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,eAAe,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CAChE;AAED,MAAM,WAAW,aAAa;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,qBAAa,cAAc;IACZ,IAAI,CAAC,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,UAAU,CAAC;IAwJjE,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,cAAc;IA0BtB,OAAO,CAAC,eAAe;CASxB;AAED;;;;;GAKG;AACH,qBAAa,gBAAgB;IACd,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IA+IrE,OAAO,CAAC,aAAa;YAOP,qBAAqB;YAmCrB,aAAa;YAmBb,mBAAmB;IAmHjC,OAAO,CAAC,YAAY;YAqFN,WAAW;YAuCX,aAAa;IA4C3B,OAAO,CAAC,eAAe;CASxB"}