@aranova/tracking-next 0.27.0 → 1.1.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 (73) hide show
  1. package/dist/blog-server.d.mts +2 -1
  2. package/dist/blog-server.d.ts +2 -1
  3. package/dist/blog-server.js +121 -98
  4. package/dist/blog-server.js.map +1 -1
  5. package/dist/blog-server.mjs +86 -63
  6. package/dist/blog-server.mjs.map +1 -1
  7. package/dist/blog.d.mts +651 -1755
  8. package/dist/blog.d.ts +651 -1755
  9. package/dist/blog.js +121 -98
  10. package/dist/blog.js.map +1 -1
  11. package/dist/blog.mjs +86 -63
  12. package/dist/blog.mjs.map +1 -1
  13. package/dist/calendar-server.d.mts +2 -2
  14. package/dist/calendar-server.d.ts +2 -2
  15. package/dist/calendar-server.js +0 -26
  16. package/dist/calendar-server.js.map +1 -1
  17. package/dist/calendar-server.mjs +0 -26
  18. package/dist/calendar-server.mjs.map +1 -1
  19. package/dist/calendar.d.mts +3 -3
  20. package/dist/calendar.d.ts +3 -3
  21. package/dist/calendar.js +227 -126
  22. package/dist/calendar.js.map +1 -1
  23. package/dist/calendar.mjs +216 -125
  24. package/dist/calendar.mjs.map +1 -1
  25. package/dist/client.d.mts +11 -4
  26. package/dist/client.d.ts +11 -4
  27. package/dist/client.js +611 -347
  28. package/dist/client.js.map +1 -1
  29. package/dist/client.mjs +611 -347
  30. package/dist/client.mjs.map +1 -1
  31. package/dist/index.d.mts +9 -8
  32. package/dist/index.d.ts +9 -8
  33. package/dist/index.js +550 -487
  34. package/dist/index.js.map +1 -1
  35. package/dist/index.mjs +539 -487
  36. package/dist/index.mjs.map +1 -1
  37. package/dist/ingest-typed-MBuMe9Pn.d.ts +883 -0
  38. package/dist/ingest-typed-UA13xTfI.d.mts +883 -0
  39. package/dist/middleware.js +0 -467
  40. package/dist/middleware.js.map +1 -1
  41. package/dist/middleware.mjs +0 -467
  42. package/dist/middleware.mjs.map +1 -1
  43. package/dist/{phone-utils-BVzSNBf1.d.mts → phone-utils-C0ds6cqZ.d.mts} +24 -78
  44. package/dist/{phone-utils-BVzSNBf1.d.ts → phone-utils-C0ds6cqZ.d.ts} +24 -78
  45. package/dist/phone.d.mts +2 -2
  46. package/dist/phone.d.ts +2 -2
  47. package/dist/phone.js +0 -464
  48. package/dist/phone.js.map +1 -1
  49. package/dist/phone.mjs +0 -464
  50. package/dist/phone.mjs.map +1 -1
  51. package/dist/{sales-IGC2tq4J.d.ts → sales-DQC815f3.d.ts} +90 -329
  52. package/dist/{sales-DQGzXSgL.d.mts → sales-w1reW_Y3.d.mts} +90 -329
  53. package/dist/sales.d.mts +3 -3
  54. package/dist/sales.d.ts +3 -3
  55. package/dist/sales.js +270 -127
  56. package/dist/sales.js.map +1 -1
  57. package/dist/sales.mjs +259 -127
  58. package/dist/sales.mjs.map +1 -1
  59. package/dist/server.d.mts +2 -2
  60. package/dist/server.d.ts +2 -2
  61. package/dist/server.js +0 -467
  62. package/dist/server.js.map +1 -1
  63. package/dist/server.mjs +0 -467
  64. package/dist/server.mjs.map +1 -1
  65. package/dist/{tracking-config-runtime-D7prdTE1.d.mts → tracking-config-runtime-C6H7ofmo.d.mts} +6 -0
  66. package/dist/{tracking-config-runtime-D7prdTE1.d.ts → tracking-config-runtime-C6H7ofmo.d.ts} +6 -0
  67. package/dist/transport-CDmGOiCq.d.ts +253 -0
  68. package/dist/transport-I_cMSFQ6.d.mts +253 -0
  69. package/package.json +2 -2
  70. package/dist/ingest-typed-BxLFlZ7N.d.mts +0 -1371
  71. package/dist/ingest-typed-ByQVRMvP.d.ts +0 -1371
  72. package/dist/transport-C-_rFSR4.d.ts +0 -721
  73. package/dist/transport-yUF5Wize.d.mts +0 -721
package/dist/server.mjs CHANGED
@@ -2,9 +2,6 @@
2
2
  import "server-only";
3
3
  import { cookies } from "next/headers";
4
4
 
5
- // ../tracking-core/src/phone.ts
6
- import { AsYouType, parsePhoneNumberFromString } from "libphonenumber-js";
7
-
8
5
  // ../tracking-core/src/tracking.ts
9
6
  var TRACKING_PARAM_KEYS = [
10
7
  "gclid",
@@ -46,470 +43,6 @@ function getTrackingParamsFromCookieReader(readCookie) {
46
43
  }, createEmptyTrackingParams());
47
44
  }
48
45
 
49
- // ../tracking-core/src/resources/tracking-config-runtime.ts
50
- var RETRY_MAX_MS = 5 * 6e4;
51
-
52
- // ../tracking-core/src/session.ts
53
- var SESSION_IDLE_MS = 30 * 60 * 1e3;
54
-
55
- // ../tracking-core/src/events/page-view.ts
56
- import { z } from "zod";
57
- var pageViewMetadataSchema = z.object({
58
- page: z.object({
59
- title: z.string().nullable(),
60
- path: z.string(),
61
- search: z.string(),
62
- hash: z.string()
63
- }).strict(),
64
- referrer: z.string().nullable(),
65
- // `.nullable().optional()` — absent (undefined) OR explicit null OR a
66
- // real viewport object. Mirrors Pydantic's `_Viewport | None = None`
67
- // on the backend side so the drift test stays clean.
68
- viewport: z.object({
69
- w: z.number(),
70
- h: z.number()
71
- }).strict().nullable().optional()
72
- }).strict();
73
- var pageViewConfigSchema = z.object({}).strict();
74
-
75
- // ../tracking-core/src/events/cta-click.ts
76
- import { z as z2 } from "zod";
77
- var ctaClickMetadataSchema = z2.object({
78
- cta_name: z2.string(),
79
- page: z2.object({
80
- path: z2.string()
81
- }).strict(),
82
- section: z2.string().nullable().optional(),
83
- destination_url: z2.string().nullable().optional(),
84
- // Set by auto-capture (and available to manual callers): the link target
85
- // and a short element descriptor (tag#id) for tying clicks to specific UI.
86
- href: z2.string().nullable().optional(),
87
- element: z2.string().nullable().optional()
88
- }).strict();
89
- var ctaClickConfigSchema = z2.object({
90
- autoCapture: z2.object({
91
- selector: z2.string().optional()
92
- }).strict().optional()
93
- }).strict();
94
-
95
- // ../tracking-core/src/events/sdk-heartbeat.ts
96
- import { z as z3 } from "zod";
97
- var sdkHeartbeatTriggersSchema = z3.object({
98
- automatic: z3.array(z3.string()),
99
- manual: z3.array(z3.string())
100
- }).strict();
101
- var sdkHeartbeatMetadataSchema = z3.object({
102
- sdk_version: z3.string(),
103
- package_name: z3.string().nullable(),
104
- surface: z3.enum(["next", "react", "script"]),
105
- triggers: sdkHeartbeatTriggersSchema,
106
- trigger_config: z3.record(z3.string(), z3.record(z3.string(), z3.unknown())).nullable().optional(),
107
- configured_gtag_ids: z3.record(z3.string(), z3.string()).nullable().optional(),
108
- // Site whose config object the SDK resolves; null on a legacy business ref.
109
- config_site_id: z3.string().uuid().nullable().optional()
110
- }).strict();
111
- var sdkHeartbeatConfigSchema = z3.object({}).strict();
112
-
113
- // ../tracking-core/src/events/form-start.ts
114
- import { z as z4 } from "zod";
115
- var formStartMetadataSchema = z4.object({
116
- form: z4.object({
117
- id: z4.string(),
118
- action: z4.string().nullable()
119
- }).strict(),
120
- page: z4.object({
121
- path: z4.string()
122
- }).strict()
123
- }).strict();
124
- var formStartConfigSchema = z4.object({
125
- selector: z4.string().optional()
126
- }).strict();
127
-
128
- // ../tracking-core/src/events/form-submit.ts
129
- import { z as z5 } from "zod";
130
- var jsonValueSchema = z5.lazy(
131
- () => z5.union([
132
- z5.string(),
133
- z5.number().finite(),
134
- z5.boolean(),
135
- z5.null(),
136
- z5.array(jsonValueSchema),
137
- z5.record(jsonValueSchema)
138
- ])
139
- );
140
- var formSubmitMetadataSchema = z5.object({
141
- form: z5.object({
142
- id: z5.string(),
143
- action: z5.string().nullable(),
144
- fields: z5.array(
145
- z5.object({
146
- name: z5.string(),
147
- type: z5.string(),
148
- label: z5.string().nullable(),
149
- value: jsonValueSchema
150
- }).strict()
151
- ).optional()
152
- }).strict(),
153
- page: z5.object({
154
- path: z5.string()
155
- }).strict()
156
- }).strict();
157
- var formSubmitConfigSchema = z5.object({}).strict();
158
-
159
- // ../tracking-core/src/events/multi-page-session.ts
160
- import { z as z6 } from "zod";
161
- var multiPageSessionMetadataSchema = z6.object({
162
- page_count: z6.number().int().min(2),
163
- page: z6.object({
164
- path: z6.string()
165
- }).strict()
166
- }).strict();
167
- var multiPageSessionConfigSchema = z6.object({
168
- pageThreshold: z6.number().int().min(2)
169
- }).strict();
170
-
171
- // ../tracking-core/src/events/page-exit.ts
172
- import { z as z7 } from "zod";
173
- var pageExitMetadataSchema = z7.object({
174
- dwell_ms: z7.number().int().min(0),
175
- // null = left without any scroll signal; floor is 0 so a valid 0% is never
176
- // rejected (a single bad field 422s the whole keepalive beacon batch).
177
- max_scroll_percent: z7.number().int().min(0).max(100).nullable(),
178
- // The gating baseline: the fraction of the page visible at load with
179
- // zero scrolling — or, for pages that grew after the post-paint snapshot
180
- // (skeleton/streaming renders), the first-scroll position that
181
- // established it. null = page had no scrollable range, or the segment
182
- // ended before the snapshot. `.optional()` is load-bearing: SDK builds
183
- // predating this field keep POSTing page_exit without the key —
184
- // requiring it would 422 whole keepalive beacon batches.
185
- scroll_baseline_percent: z7.number().int().min(0).max(100).nullable().optional(),
186
- page: z7.object({
187
- path: z7.string()
188
- }).strict()
189
- }).strict();
190
- var pageExitConfigSchema = z7.object({}).strict();
191
-
192
- // ../tracking-core/src/events/phone-click.ts
193
- import { z as z8 } from "zod";
194
- var phoneClickMetadataSchema = z8.object({
195
- phone_number: z8.string(),
196
- page: z8.object({
197
- path: z8.string()
198
- }).strict(),
199
- section: z8.string().nullable().optional()
200
- }).strict();
201
- var phoneClickConfigSchema = z8.object({
202
- autoCapture: z8.object({
203
- selector: z8.string().optional()
204
- }).strict().optional()
205
- }).strict();
206
-
207
- // ../tracking-core/src/events/scroll-depth.ts
208
- import { z as z9 } from "zod";
209
- var scrollDepthMetadataSchema = z9.object({
210
- depth_percent: z9.number().int().min(1).max(100),
211
- page: z9.object({
212
- path: z9.string()
213
- }).strict()
214
- }).strict();
215
- var scrollDepthConfigSchema = z9.object({
216
- thresholds: z9.array(z9.number().int().min(1).max(100)).min(1)
217
- }).strict();
218
-
219
- // ../tracking-core/src/events/specific-page-visit.ts
220
- import { z as z10 } from "zod";
221
- var PAGE_IDENTITY_MAX_LENGTH = 64;
222
- var PAGE_IDENTITY_PATTERN = /^[a-z][a-z0-9]*(?:_[a-z0-9]+)*$/;
223
- var pageIdentitySchema = z10.string().max(PAGE_IDENTITY_MAX_LENGTH).regex(PAGE_IDENTITY_PATTERN, {
224
- message: "page identity must be lowercase snake_case, start with a letter, and contain at most 64 characters"
225
- });
226
- var specificPageNameSchema = pageIdentitySchema;
227
- var specificPageVisitMetadataSchema = z10.object({
228
- page_name: specificPageNameSchema,
229
- page: z10.object({
230
- path: z10.string()
231
- }).strict()
232
- }).strict();
233
- var specificPageVisitConfigSchema = z10.object({
234
- pages: z10.array(
235
- z10.object({
236
- name: specificPageNameSchema,
237
- pathPattern: z10.custom((value) => value instanceof RegExp, {
238
- message: "pathPattern must be a RegExp"
239
- })
240
- }).strict()
241
- ).min(1)
242
- }).strict();
243
-
244
- // ../tracking-core/src/events/time-on-site.ts
245
- import { z as z11 } from "zod";
246
- var timeOnSiteMetadataSchema = z11.object({
247
- duration_ms: z11.number().int().nonnegative(),
248
- page: z11.object({
249
- path: z11.string()
250
- }).strict()
251
- }).strict();
252
- var timeOnSiteConfigSchema = z11.object({
253
- thresholdSeconds: z11.number().int().positive()
254
- }).strict();
255
-
256
- // ../tracking-core/src/events/semantics.ts
257
- var EVENT_SEMANTICS = {
258
- page_view: {
259
- label: "Page view",
260
- category: "page",
261
- outcomeRole: "navigation",
262
- clientVisibility: "simple"
263
- },
264
- time_on_site: {
265
- label: "Time on site",
266
- category: "engagement",
267
- outcomeRole: "engagement",
268
- clientVisibility: "detailed"
269
- },
270
- specific_page_visit: {
271
- label: "Key page visit",
272
- category: "engagement",
273
- outcomeRole: "engagement",
274
- clientVisibility: "detailed"
275
- },
276
- scroll_depth: {
277
- label: "Scroll depth",
278
- category: "engagement",
279
- outcomeRole: "engagement",
280
- clientVisibility: "detailed"
281
- },
282
- multi_page_session: {
283
- label: "Multi-page session",
284
- category: "engagement",
285
- outcomeRole: "engagement",
286
- clientVisibility: "detailed"
287
- },
288
- form_start: {
289
- label: "Form started",
290
- category: "engagement",
291
- outcomeRole: "engagement",
292
- clientVisibility: "simple"
293
- },
294
- sdk_heartbeat: {
295
- label: "SDK heartbeat",
296
- category: "system",
297
- outcomeRole: "diagnostic",
298
- clientVisibility: "hidden"
299
- },
300
- page_exit: {
301
- label: "Page exit",
302
- category: "engagement",
303
- outcomeRole: "diagnostic",
304
- clientVisibility: "detailed"
305
- },
306
- form_submit: {
307
- label: "Form submitted",
308
- category: "lead",
309
- outcomeRole: "lead",
310
- clientVisibility: "simple"
311
- },
312
- phone_click: {
313
- label: "Phone click",
314
- category: "lead",
315
- outcomeRole: "lead",
316
- clientVisibility: "simple"
317
- },
318
- cta_click: {
319
- label: "CTA click",
320
- category: "engagement",
321
- outcomeRole: "engagement",
322
- clientVisibility: "simple"
323
- }
324
- };
325
-
326
- // ../tracking-core/src/events/registry.ts
327
- var EVENT_REGISTRY = {
328
- // --- automatic triggers ---
329
- page_view: {
330
- kind: "automatic",
331
- semantics: EVENT_SEMANTICS.page_view,
332
- metadataSchema: pageViewMetadataSchema,
333
- configSchema: pageViewConfigSchema
334
- },
335
- time_on_site: {
336
- kind: "automatic",
337
- semantics: EVENT_SEMANTICS.time_on_site,
338
- metadataSchema: timeOnSiteMetadataSchema,
339
- configSchema: timeOnSiteConfigSchema
340
- },
341
- specific_page_visit: {
342
- kind: "automatic",
343
- semantics: EVENT_SEMANTICS.specific_page_visit,
344
- metadataSchema: specificPageVisitMetadataSchema,
345
- configSchema: specificPageVisitConfigSchema
346
- },
347
- scroll_depth: {
348
- kind: "automatic",
349
- semantics: EVENT_SEMANTICS.scroll_depth,
350
- metadataSchema: scrollDepthMetadataSchema,
351
- configSchema: scrollDepthConfigSchema
352
- },
353
- multi_page_session: {
354
- kind: "automatic",
355
- semantics: EVENT_SEMANTICS.multi_page_session,
356
- metadataSchema: multiPageSessionMetadataSchema,
357
- configSchema: multiPageSessionConfigSchema
358
- },
359
- form_start: {
360
- kind: "automatic",
361
- semantics: EVENT_SEMANTICS.form_start,
362
- metadataSchema: formStartMetadataSchema,
363
- configSchema: formStartConfigSchema
364
- },
365
- // --- SDK-internal automatic (not consumer-configurable) ---
366
- sdk_heartbeat: {
367
- kind: "automatic",
368
- semantics: EVENT_SEMANTICS.sdk_heartbeat,
369
- metadataSchema: sdkHeartbeatMetadataSchema,
370
- configSchema: sdkHeartbeatConfigSchema
371
- },
372
- page_exit: {
373
- kind: "automatic",
374
- semantics: EVENT_SEMANTICS.page_exit,
375
- metadataSchema: pageExitMetadataSchema,
376
- configSchema: pageExitConfigSchema
377
- },
378
- // --- manual triggers ---
379
- form_submit: {
380
- kind: "manual",
381
- semantics: EVENT_SEMANTICS.form_submit,
382
- metadataSchema: formSubmitMetadataSchema,
383
- configSchema: formSubmitConfigSchema
384
- },
385
- phone_click: {
386
- kind: "manual",
387
- semantics: EVENT_SEMANTICS.phone_click,
388
- metadataSchema: phoneClickMetadataSchema,
389
- configSchema: phoneClickConfigSchema
390
- },
391
- cta_click: {
392
- kind: "manual",
393
- semantics: EVENT_SEMANTICS.cta_click,
394
- metadataSchema: ctaClickMetadataSchema,
395
- configSchema: ctaClickConfigSchema
396
- }
397
- };
398
- var ALL_AUTOMATIC_EVENT_NAMES = Object.entries(EVENT_REGISTRY).filter(([, def]) => def.kind === "automatic").map(([name]) => name);
399
- var ALL_MANUAL_EVENT_NAMES = Object.entries(EVENT_REGISTRY).filter(([, def]) => def.kind === "manual").map(([name]) => name);
400
- var ALL_LEAD_EVENT_NAMES = Object.entries(EVENT_REGISTRY).filter(([, def]) => def.semantics.outcomeRole === "lead").map(([name]) => name);
401
-
402
- // ../tracking-core/src/resources/sales/schema.ts
403
- import { z as z12 } from "zod";
404
- var SUPPORTED_CURRENCIES = ["USD", "CAD"];
405
- var TRACKING_ENVIRONMENTS = ["production", "development"];
406
- var currencySchema = z12.enum(SUPPORTED_CURRENCIES);
407
- var centsSchema = z12.number().int().nonnegative();
408
- var quantitySchema = z12.string().regex(/^\d+(\.\d{1,3})?$/);
409
- var metadataSchema = z12.record(z12.unknown());
410
- var saleItemSchema = z12.object({
411
- external_item_id: z12.string().nullable().optional(),
412
- name: z12.string().nullable().optional(),
413
- category: z12.string().nullable().optional(),
414
- quantity: quantitySchema,
415
- unit_price_cents: centsSchema,
416
- // Non-negativity validated on the wire — same contract as the other cents
417
- // fields — and backstopped by the DB CHECK.
418
- unit_cost_cents: centsSchema.nullable().optional()
419
- }).strict();
420
- var saleServiceSchema = z12.object({
421
- service: z12.string(),
422
- amount_cents: centsSchema
423
- }).strict();
424
- var customerNameSchema = z12.string().max(200);
425
- var customerPhoneSchema = z12.string().max(64);
426
- var customerEmailSchema = z12.string().max(320).email();
427
- function refineServiceXor(val, ctx, { requireAmount }) {
428
- if (val.services != null) {
429
- if (val.service != null) {
430
- ctx.addIssue({
431
- code: z12.ZodIssueCode.custom,
432
- message: "pass either `service` or `services`, not both",
433
- path: ["services"]
434
- });
435
- }
436
- if (val.services.length === 0) {
437
- ctx.addIssue({
438
- code: z12.ZodIssueCode.custom,
439
- message: "`services` must not be empty",
440
- path: ["services"]
441
- });
442
- }
443
- const keys = val.services.map((s) => s.service);
444
- if (new Set(keys).size !== keys.length) {
445
- ctx.addIssue({
446
- code: z12.ZodIssueCode.custom,
447
- message: "`services` must not list the same service more than once",
448
- path: ["services"]
449
- });
450
- }
451
- if (val.amount_total_cents != null) {
452
- const sum = val.services.reduce((acc, s) => acc + s.amount_cents, 0);
453
- if (val.amount_total_cents !== sum) {
454
- ctx.addIssue({
455
- code: z12.ZodIssueCode.custom,
456
- message: "amount_total_cents must equal the sum of the services amounts (omit it to derive it automatically)",
457
- path: ["amount_total_cents"]
458
- });
459
- }
460
- }
461
- } else if (requireAmount && val.amount_total_cents == null) {
462
- ctx.addIssue({
463
- code: z12.ZodIssueCode.custom,
464
- message: "amount_total_cents is required unless `services` is provided",
465
- path: ["amount_total_cents"]
466
- });
467
- }
468
- }
469
- var saleCreateSchema = z12.object({
470
- external_id: z12.string().nullable().optional(),
471
- description: z12.string().nullable().optional(),
472
- service: z12.string().nullable().optional(),
473
- services: z12.array(saleServiceSchema).nullable().optional(),
474
- currency: currencySchema,
475
- // Optional only because the plural `services` form derives it from the sum
476
- // (see refineServiceXor); the singular/serviceless path still requires it.
477
- amount_total_cents: centsSchema.nullable().optional(),
478
- occurred_at: z12.string().datetime(),
479
- environment: z12.enum(TRACKING_ENVIRONMENTS).default("production"),
480
- items: z12.array(saleItemSchema).default([]),
481
- metadata: metadataSchema.nullable().optional(),
482
- customer_name: customerNameSchema.nullable().optional(),
483
- customer_phone: customerPhoneSchema.nullable().optional(),
484
- customer_email: customerEmailSchema.nullable().optional(),
485
- // CASL consent attestation: the customer agreed to receive SMS. Recorded
486
- // with a timestamp server-side; every SMS send path gates on it.
487
- //
488
- // Tri-state: omit it (or send null) to let the server apply the business's
489
- // configured default-opt-in policy, honouring a returning customer's
490
- // remembered preference. Send an explicit boolean to assert consent state
491
- // yourself — `false` records a deliberate opt-out.
492
- sms_consent: z12.boolean().nullable().optional()
493
- }).strict().superRefine((val, ctx) => refineServiceXor(val, ctx, { requireAmount: true }));
494
- var saleUpdateSchema = z12.object({
495
- description: z12.string().nullable().optional(),
496
- service: z12.string().nullable().optional(),
497
- services: z12.array(saleServiceSchema).nullable().optional(),
498
- currency: currencySchema.optional(),
499
- amount_total_cents: centsSchema.optional(),
500
- occurred_at: z12.string().datetime().optional(),
501
- items: z12.array(saleItemSchema).optional(),
502
- metadata: metadataSchema.nullable().optional(),
503
- customer_name: customerNameSchema.nullable().optional(),
504
- // Re-attest when changing a filler-looking name; the server clears the
505
- // prior attestation whenever `customer_name` changes.
506
- customer_name_placeholder_confirmed: z12.boolean().optional(),
507
- customer_phone: customerPhoneSchema.nullable().optional(),
508
- customer_email: customerEmailSchema.nullable().optional(),
509
- // NOT NULL server-side: omit to leave unchanged (explicit null is rejected).
510
- sms_consent: z12.boolean().optional()
511
- }).strict().superRefine((val, ctx) => refineServiceXor(val, ctx, { requireAmount: false }));
512
-
513
46
  // src/server.ts
514
47
  function getCookieStore() {
515
48
  return cookies();