deepline 0.1.102 → 0.1.104

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.
package/dist/index.d.mts CHANGED
@@ -978,7 +978,7 @@ interface ClearPlayHistoryResult {
978
978
  * Response from starting a play run.
979
979
  *
980
980
  * Internal/advanced payload returned by low-level play submission primitives.
981
- * Most callers should prefer `deepline play run`, {@link DeeplineClient.runPlay},
981
+ * Most callers should prefer `deepline plays run`, {@link DeeplineClient.runPlay},
982
982
  * or {@link PlayJob.get}.
983
983
  *
984
984
  * @example
@@ -1042,7 +1042,7 @@ interface PlayCheckToolGetterHint {
1042
1042
  * Request body for starting a play run via {@link DeeplineClient.startPlayRun}.
1043
1043
  *
1044
1044
  * Internal/advanced request shape for low-level submission primitives.
1045
- * Most callers should prefer `deepline play run`, {@link DeeplineClient.runPlay},
1045
+ * Most callers should prefer `deepline plays run`, {@link DeeplineClient.runPlay},
1046
1046
  * or {@link Deepline.connect}.
1047
1047
  *
1048
1048
  * Either `name` (for live plays) or `artifactStorageKey` (for packaged ad hoc runs) is required.
@@ -1505,7 +1505,7 @@ declare class DeeplineClient {
1505
1505
  * or {@link runPlay}.
1506
1506
  *
1507
1507
  * Supported invocation surfaces intentionally share this same run contract:
1508
- * `deepline play run`, repo scripts such as `bun run deepline -- play run`,
1508
+ * `deepline plays run`, repo scripts such as `bun run deepline -- plays run`,
1509
1509
  * SDK context calls like `Deepline.connect().play(name).run()`, and direct
1510
1510
  * `POST /api/v2/plays/run` calls all return a workflow/run id. The completed
1511
1511
  * output is always retrievable from `getPlayStatus(runId).result` (or from
@@ -1625,7 +1625,7 @@ declare class DeeplineClient {
1625
1625
  *
1626
1626
  * Unlike {@link registerPlayArtifact}, this does not store the artifact,
1627
1627
  * publish a revision, or start a run. It is the authoritative cloud validation
1628
- * path used by `deepline play check`.
1628
+ * path used by `deepline plays check`.
1629
1629
  */
1630
1630
  checkPlayArtifact(input: {
1631
1631
  name?: string;
@@ -1750,7 +1750,7 @@ declare class DeeplineClient {
1750
1750
  * Get the current status of a play execution.
1751
1751
  *
1752
1752
  * Internal/advanced primitive. Public callers should usually prefer
1753
- * {@link runPlay}, {@link PlayJob.get}, or `deepline play run --watch`.
1753
+ * {@link runPlay}, {@link PlayJob.get}, or `deepline plays run --watch`.
1754
1754
  *
1755
1755
  * @param workflowId - Play-run id from {@link startPlayRun}
1756
1756
  * @returns Current status with progress logs and partial results
@@ -3261,7 +3261,7 @@ interface DeeplinePlayRuntimeContext {
3261
3261
  * Provides methods to check status, stream logs, wait for completion,
3262
3262
  * or cancel the execution.
3263
3263
  *
3264
- * This handle is the SDK-context equivalent of `deepline play run --watch` and
3264
+ * This handle is the SDK-context equivalent of `deepline plays run --watch` and
3265
3265
  * `POST /api/v2/plays/run`: every surface returns a run id first, then exposes
3266
3266
  * the completed user output through `PlayJob.get()` or the status endpoint's
3267
3267
  * `result` field. Runtime logs are available from `status().progress.logs` and
package/dist/index.d.ts CHANGED
@@ -978,7 +978,7 @@ interface ClearPlayHistoryResult {
978
978
  * Response from starting a play run.
979
979
  *
980
980
  * Internal/advanced payload returned by low-level play submission primitives.
981
- * Most callers should prefer `deepline play run`, {@link DeeplineClient.runPlay},
981
+ * Most callers should prefer `deepline plays run`, {@link DeeplineClient.runPlay},
982
982
  * or {@link PlayJob.get}.
983
983
  *
984
984
  * @example
@@ -1042,7 +1042,7 @@ interface PlayCheckToolGetterHint {
1042
1042
  * Request body for starting a play run via {@link DeeplineClient.startPlayRun}.
1043
1043
  *
1044
1044
  * Internal/advanced request shape for low-level submission primitives.
1045
- * Most callers should prefer `deepline play run`, {@link DeeplineClient.runPlay},
1045
+ * Most callers should prefer `deepline plays run`, {@link DeeplineClient.runPlay},
1046
1046
  * or {@link Deepline.connect}.
1047
1047
  *
1048
1048
  * Either `name` (for live plays) or `artifactStorageKey` (for packaged ad hoc runs) is required.
@@ -1505,7 +1505,7 @@ declare class DeeplineClient {
1505
1505
  * or {@link runPlay}.
1506
1506
  *
1507
1507
  * Supported invocation surfaces intentionally share this same run contract:
1508
- * `deepline play run`, repo scripts such as `bun run deepline -- play run`,
1508
+ * `deepline plays run`, repo scripts such as `bun run deepline -- plays run`,
1509
1509
  * SDK context calls like `Deepline.connect().play(name).run()`, and direct
1510
1510
  * `POST /api/v2/plays/run` calls all return a workflow/run id. The completed
1511
1511
  * output is always retrievable from `getPlayStatus(runId).result` (or from
@@ -1625,7 +1625,7 @@ declare class DeeplineClient {
1625
1625
  *
1626
1626
  * Unlike {@link registerPlayArtifact}, this does not store the artifact,
1627
1627
  * publish a revision, or start a run. It is the authoritative cloud validation
1628
- * path used by `deepline play check`.
1628
+ * path used by `deepline plays check`.
1629
1629
  */
1630
1630
  checkPlayArtifact(input: {
1631
1631
  name?: string;
@@ -1750,7 +1750,7 @@ declare class DeeplineClient {
1750
1750
  * Get the current status of a play execution.
1751
1751
  *
1752
1752
  * Internal/advanced primitive. Public callers should usually prefer
1753
- * {@link runPlay}, {@link PlayJob.get}, or `deepline play run --watch`.
1753
+ * {@link runPlay}, {@link PlayJob.get}, or `deepline plays run --watch`.
1754
1754
  *
1755
1755
  * @param workflowId - Play-run id from {@link startPlayRun}
1756
1756
  * @returns Current status with progress logs and partial results
@@ -3261,7 +3261,7 @@ interface DeeplinePlayRuntimeContext {
3261
3261
  * Provides methods to check status, stream logs, wait for completion,
3262
3262
  * or cancel the execution.
3263
3263
  *
3264
- * This handle is the SDK-context equivalent of `deepline play run --watch` and
3264
+ * This handle is the SDK-context equivalent of `deepline plays run --watch` and
3265
3265
  * `POST /api/v2/plays/run`: every surface returns a run id first, then exposes
3266
3266
  * the completed user output through `PlayJob.get()` or the status endpoint's
3267
3267
  * `result` field. Runtime logs are available from `status().progress.logs` and
package/dist/index.js CHANGED
@@ -265,10 +265,12 @@ var SDK_RELEASE = {
265
265
  // failed runs, persisted/succeeded/failed row counts, strict local CSV
266
266
  // preflight (existence, data rows, quotes, duplicate headers), HTML error
267
267
  // scrubbing, and word-boundary watch truncation.
268
- version: "0.1.102",
268
+ // 0.1.103 ships the refined SDK CLI command surface.
269
+ // 0.1.104 ships postgres_fast suspension/billing parity and runtime worker hardening.
270
+ version: "0.1.104",
269
271
  apiContract: "2026-06-dataset-column-cell-stale-hard-cutover",
270
272
  supportPolicy: {
271
- latest: "0.1.102",
273
+ latest: "0.1.104",
272
274
  minimumSupported: "0.1.53",
273
275
  deprecatedBelow: "0.1.53"
274
276
  }
@@ -1934,7 +1936,7 @@ var DeeplineClient = class {
1934
1936
  * or {@link runPlay}.
1935
1937
  *
1936
1938
  * Supported invocation surfaces intentionally share this same run contract:
1937
- * `deepline play run`, repo scripts such as `bun run deepline -- play run`,
1939
+ * `deepline plays run`, repo scripts such as `bun run deepline -- plays run`,
1938
1940
  * SDK context calls like `Deepline.connect().play(name).run()`, and direct
1939
1941
  * `POST /api/v2/plays/run` calls all return a workflow/run id. The completed
1940
1942
  * output is always retrievable from `getPlayStatus(runId).result` (or from
@@ -2103,7 +2105,7 @@ var DeeplineClient = class {
2103
2105
  *
2104
2106
  * Unlike {@link registerPlayArtifact}, this does not store the artifact,
2105
2107
  * publish a revision, or start a run. It is the authoritative cloud validation
2106
- * path used by `deepline play check`.
2108
+ * path used by `deepline plays check`.
2107
2109
  */
2108
2110
  async checkPlayArtifact(input) {
2109
2111
  return this.http.post("/api/v2/plays/check", input);
@@ -2296,7 +2298,7 @@ var DeeplineClient = class {
2296
2298
  * Get the current status of a play execution.
2297
2299
  *
2298
2300
  * Internal/advanced primitive. Public callers should usually prefer
2299
- * {@link runPlay}, {@link PlayJob.get}, or `deepline play run --watch`.
2301
+ * {@link runPlay}, {@link PlayJob.get}, or `deepline plays run --watch`.
2300
2302
  *
2301
2303
  * @param workflowId - Play-run id from {@link startPlayRun}
2302
2304
  * @returns Current status with progress logs and partial results
package/dist/index.mjs CHANGED
@@ -187,10 +187,12 @@ var SDK_RELEASE = {
187
187
  // failed runs, persisted/succeeded/failed row counts, strict local CSV
188
188
  // preflight (existence, data rows, quotes, duplicate headers), HTML error
189
189
  // scrubbing, and word-boundary watch truncation.
190
- version: "0.1.102",
190
+ // 0.1.103 ships the refined SDK CLI command surface.
191
+ // 0.1.104 ships postgres_fast suspension/billing parity and runtime worker hardening.
192
+ version: "0.1.104",
191
193
  apiContract: "2026-06-dataset-column-cell-stale-hard-cutover",
192
194
  supportPolicy: {
193
- latest: "0.1.102",
195
+ latest: "0.1.104",
194
196
  minimumSupported: "0.1.53",
195
197
  deprecatedBelow: "0.1.53"
196
198
  }
@@ -1856,7 +1858,7 @@ var DeeplineClient = class {
1856
1858
  * or {@link runPlay}.
1857
1859
  *
1858
1860
  * Supported invocation surfaces intentionally share this same run contract:
1859
- * `deepline play run`, repo scripts such as `bun run deepline -- play run`,
1861
+ * `deepline plays run`, repo scripts such as `bun run deepline -- plays run`,
1860
1862
  * SDK context calls like `Deepline.connect().play(name).run()`, and direct
1861
1863
  * `POST /api/v2/plays/run` calls all return a workflow/run id. The completed
1862
1864
  * output is always retrievable from `getPlayStatus(runId).result` (or from
@@ -2025,7 +2027,7 @@ var DeeplineClient = class {
2025
2027
  *
2026
2028
  * Unlike {@link registerPlayArtifact}, this does not store the artifact,
2027
2029
  * publish a revision, or start a run. It is the authoritative cloud validation
2028
- * path used by `deepline play check`.
2030
+ * path used by `deepline plays check`.
2029
2031
  */
2030
2032
  async checkPlayArtifact(input) {
2031
2033
  return this.http.post("/api/v2/plays/check", input);
@@ -2218,7 +2220,7 @@ var DeeplineClient = class {
2218
2220
  * Get the current status of a play execution.
2219
2221
  *
2220
2222
  * Internal/advanced primitive. Public callers should usually prefer
2221
- * {@link runPlay}, {@link PlayJob.get}, or `deepline play run --watch`.
2223
+ * {@link runPlay}, {@link PlayJob.get}, or `deepline plays run --watch`.
2222
2224
  *
2223
2225
  * @param workflowId - Play-run id from {@link startPlayRun}
2224
2226
  * @returns Current status with progress logs and partial results
@@ -951,7 +951,7 @@ export class DeeplineClient {
951
951
  * or {@link runPlay}.
952
952
  *
953
953
  * Supported invocation surfaces intentionally share this same run contract:
954
- * `deepline play run`, repo scripts such as `bun run deepline -- play run`,
954
+ * `deepline plays run`, repo scripts such as `bun run deepline -- plays run`,
955
955
  * SDK context calls like `Deepline.connect().play(name).run()`, and direct
956
956
  * `POST /api/v2/plays/run` calls all return a workflow/run id. The completed
957
957
  * output is always retrievable from `getPlayStatus(runId).result` (or from
@@ -1221,7 +1221,7 @@ export class DeeplineClient {
1221
1221
  *
1222
1222
  * Unlike {@link registerPlayArtifact}, this does not store the artifact,
1223
1223
  * publish a revision, or start a run. It is the authoritative cloud validation
1224
- * path used by `deepline play check`.
1224
+ * path used by `deepline plays check`.
1225
1225
  */
1226
1226
  async checkPlayArtifact(input: {
1227
1227
  name?: string;
@@ -1494,7 +1494,7 @@ export class DeeplineClient {
1494
1494
  * Get the current status of a play execution.
1495
1495
  *
1496
1496
  * Internal/advanced primitive. Public callers should usually prefer
1497
- * {@link runPlay}, {@link PlayJob.get}, or `deepline play run --watch`.
1497
+ * {@link runPlay}, {@link PlayJob.get}, or `deepline plays run --watch`.
1498
1498
  *
1499
1499
  * @param workflowId - Play-run id from {@link startPlayRun}
1500
1500
  * @returns Current status with progress logs and partial results
@@ -35,7 +35,7 @@
35
35
  * });
36
36
  * ```
37
37
  *
38
- * Then run: `deepline play run --file my-play.play.ts --watch`
38
+ * Then run: `deepline plays run --file my-play.play.ts --watch`
39
39
  *
40
40
  * ## Architecture
41
41
  *
@@ -38,7 +38,7 @@
38
38
  * });
39
39
  * ```
40
40
  *
41
- * Then run via CLI: `deepline play run --file my-play.play.ts --watch`
41
+ * Then run via CLI: `deepline plays run --file my-play.play.ts --watch`
42
42
  *
43
43
  * ### Programmatic usage
44
44
  *
@@ -807,7 +807,7 @@ export interface DeeplinePlayRuntimeContext {
807
807
  * Provides methods to check status, stream logs, wait for completion,
808
808
  * or cancel the execution.
809
809
  *
810
- * This handle is the SDK-context equivalent of `deepline play run --watch` and
810
+ * This handle is the SDK-context equivalent of `deepline plays run --watch` and
811
811
  * `POST /api/v2/plays/run`: every surface returns a run id first, then exposes
812
812
  * the completed user output through `PlayJob.get()` or the status endpoint's
813
813
  * `result` field. Runtime logs are available from `status().progress.logs` and
@@ -58,10 +58,12 @@ export const SDK_RELEASE = {
58
58
  // failed runs, persisted/succeeded/failed row counts, strict local CSV
59
59
  // preflight (existence, data rows, quotes, duplicate headers), HTML error
60
60
  // scrubbing, and word-boundary watch truncation.
61
- version: '0.1.102',
61
+ // 0.1.103 ships the refined SDK CLI command surface.
62
+ // 0.1.104 ships postgres_fast suspension/billing parity and runtime worker hardening.
63
+ version: '0.1.104',
62
64
  apiContract: '2026-06-dataset-column-cell-stale-hard-cutover',
63
65
  supportPolicy: {
64
- latest: '0.1.102',
66
+ latest: '0.1.104',
65
67
  minimumSupported: '0.1.53',
66
68
  deprecatedBelow: '0.1.53',
67
69
  },
@@ -813,7 +813,7 @@ export interface ClearPlayHistoryResult {
813
813
  * Response from starting a play run.
814
814
  *
815
815
  * Internal/advanced payload returned by low-level play submission primitives.
816
- * Most callers should prefer `deepline play run`, {@link DeeplineClient.runPlay},
816
+ * Most callers should prefer `deepline plays run`, {@link DeeplineClient.runPlay},
817
817
  * or {@link PlayJob.get}.
818
818
  *
819
819
  * @example
@@ -880,7 +880,7 @@ export interface PlayCheckToolGetterHint {
880
880
  * Request body for starting a play run via {@link DeeplineClient.startPlayRun}.
881
881
  *
882
882
  * Internal/advanced request shape for low-level submission primitives.
883
- * Most callers should prefer `deepline play run`, {@link DeeplineClient.runPlay},
883
+ * Most callers should prefer `deepline plays run`, {@link DeeplineClient.runPlay},
884
884
  * or {@link Deepline.connect}.
885
885
  *
886
886
  * Either `name` (for live plays) or `artifactStorageKey` (for packaged ad hoc runs) is required.
@@ -176,6 +176,32 @@ export function cloneCsvAliasedRow<T extends Record<string, unknown>>(
176
176
  return cloned;
177
177
  }
178
178
 
179
+ /**
180
+ * Plain enumerable clone for durable serialization (sheet writes, JSON
181
+ * payloads). Projected alias fields are normally non-enumerable so they stay
182
+ * out of spreads and Object.keys — but a JSON round-trip would silently drop
183
+ * them. This materializes every projected alias as a visible field and drops
184
+ * the internal `__deepline*` metadata keys.
185
+ */
186
+ export function toSerializableCsvAliasedRow(
187
+ row: Record<string, unknown>,
188
+ ): Record<string, unknown> {
189
+ const out: Record<string, unknown> = {};
190
+ for (const [field, value] of Object.entries(row)) {
191
+ if (field.startsWith('__deepline')) continue;
192
+ out[field] = value;
193
+ }
194
+ const projectedFields = getCsvProjectedFields(row);
195
+ if (projectedFields) {
196
+ const serializedValues = getCsvProjectedValues(row);
197
+ for (const field of projectedFields) {
198
+ if (Object.prototype.hasOwnProperty.call(out, field)) continue;
199
+ out[field] = row[field] ?? serializedValues?.[field];
200
+ }
201
+ }
202
+ return out;
203
+ }
204
+
179
205
  export function stripCsvProjectedFields<T extends Record<string, unknown>>(
180
206
  row: T,
181
207
  ): T {
@@ -48,7 +48,7 @@ export const PLAY_RUNTIME_PROVIDERS: Record<
48
48
  runner: PLAY_RUNTIME_BACKENDS.daytona,
49
49
  dedup: PLAY_DEDUP_BACKENDS.durableObject,
50
50
  artifactKind: PLAY_ARTIFACT_KINDS.cjsNode20,
51
- label: 'Experimental Postgres Scheduler + warm sandbox runner + DO dedup',
51
+ label: 'BETA: Postgres Scheduler + warm sandbox runner + DO dedup',
52
52
  },
53
53
  postgres_fast_sandbox: {
54
54
  id: PLAY_RUNTIME_PROVIDER_IDS.postgresFastSandbox,
@@ -56,7 +56,7 @@ export const PLAY_RUNTIME_PROVIDERS: Record<
56
56
  runner: PLAY_RUNTIME_BACKENDS.daytona,
57
57
  dedup: PLAY_DEDUP_BACKENDS.durableObject,
58
58
  artifactKind: PLAY_ARTIFACT_KINDS.cjsNode20,
59
- label: 'Experimental Postgres Scheduler + warm sandbox runner + DO dedup',
59
+ label: 'BETA: Postgres Scheduler + warm sandbox runner + DO dedup',
60
60
  },
61
61
  postgres_fast_workers: {
62
62
  id: PLAY_RUNTIME_PROVIDER_IDS.postgresFastWorkers,
@@ -133,6 +133,8 @@ export type PlaySchedulerSubmitInput = {
133
133
  coordinatorUrl?: string | null;
134
134
  /** Request-scoped coordinator auth token for non-production preview/dev runs. */
135
135
  coordinatorInternalToken?: string | null;
136
+ /** Request-scoped Vercel Deployment Protection bypass for preview runtime callbacks. */
137
+ vercelProtectionBypassToken?: string | null;
136
138
  };
137
139
 
138
140
  export type PlaySchedulerProgressEvent =
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "deepline",
3
- "version": "0.1.102",
3
+ "version": "0.1.104",
4
4
  "description": "Deepline SDK + CLI — B2B data enrichment powered by durable cloud execution",
5
5
  "license": "MIT",
6
6
  "repository": {